deployable-awscdk-app-ts 0.0.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.
package/API.md ADDED
@@ -0,0 +1,2059 @@
1
+ # API Reference <a name="API Reference"></a>
2
+
3
+
4
+ ## Structs <a name="Structs"></a>
5
+
6
+ ### AWSCredentialsBase <a name="deployable-awscdk-app-ts.AWSCredentialsBase"></a>
7
+
8
+ #### Initializer <a name="[object Object].Initializer"></a>
9
+
10
+ ```typescript
11
+ import { AWSCredentialsBase } from 'deployable-awscdk-app-ts'
12
+
13
+ const aWSCredentialsBase: AWSCredentialsBase = { ... }
14
+ ```
15
+
16
+ ##### `region`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsBase.property.region"></a>
17
+
18
+ ```typescript
19
+ public readonly region: string;
20
+ ```
21
+
22
+ - *Type:* `string`
23
+
24
+ Default AWS region for the account.
25
+
26
+ ---
27
+
28
+ ##### `assumeRoleDurationSeconds`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsBase.property.assumeRoleDurationSeconds"></a>
29
+
30
+ ```typescript
31
+ public readonly assumeRoleDurationSeconds: number;
32
+ ```
33
+
34
+ - *Type:* `number`
35
+ - *Default:* 300
36
+
37
+ Duration of assume role session.
38
+
39
+ ---
40
+
41
+ ##### `roleToAssume`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsBase.property.roleToAssume"></a>
42
+
43
+ ```typescript
44
+ public readonly roleToAssume: string;
45
+ ```
46
+
47
+ - *Type:* `string`
48
+
49
+ ARN of AWS role to be assumed.
50
+
51
+ ---
52
+
53
+ ### AWSCredentialsGitHubSecrets <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets"></a>
54
+
55
+ #### Initializer <a name="[object Object].Initializer"></a>
56
+
57
+ ```typescript
58
+ import { AWSCredentialsGitHubSecrets } from 'deployable-awscdk-app-ts'
59
+
60
+ const aWSCredentialsGitHubSecrets: AWSCredentialsGitHubSecrets = { ... }
61
+ ```
62
+
63
+ ##### `region`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets.property.region"></a>
64
+
65
+ ```typescript
66
+ public readonly region: string;
67
+ ```
68
+
69
+ - *Type:* `string`
70
+
71
+ Default AWS region for the account.
72
+
73
+ ---
74
+
75
+ ##### `assumeRoleDurationSeconds`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets.property.assumeRoleDurationSeconds"></a>
76
+
77
+ ```typescript
78
+ public readonly assumeRoleDurationSeconds: number;
79
+ ```
80
+
81
+ - *Type:* `number`
82
+ - *Default:* 300
83
+
84
+ Duration of assume role session.
85
+
86
+ ---
87
+
88
+ ##### `roleToAssume`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets.property.roleToAssume"></a>
89
+
90
+ ```typescript
91
+ public readonly roleToAssume: string;
92
+ ```
93
+
94
+ - *Type:* `string`
95
+
96
+ ARN of AWS role to be assumed.
97
+
98
+ ---
99
+
100
+ ##### `accessKeyIdSecretName`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets.property.accessKeyIdSecretName"></a>
101
+
102
+ ```typescript
103
+ public readonly accessKeyIdSecretName: string;
104
+ ```
105
+
106
+ - *Type:* `string`
107
+
108
+ GitHub Secret name for AWS Access Key Id.
109
+
110
+ ---
111
+
112
+ ##### `secretAccessKeySecretName`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets.property.secretAccessKeySecretName"></a>
113
+
114
+ ```typescript
115
+ public readonly secretAccessKeySecretName: string;
116
+ ```
117
+
118
+ - *Type:* `string`
119
+
120
+ GitHub Secret name for AWS Secret Access Key.
121
+
122
+ ---
123
+
124
+ ### AWSCredentialsValues <a name="deployable-awscdk-app-ts.AWSCredentialsValues"></a>
125
+
126
+ #### Initializer <a name="[object Object].Initializer"></a>
127
+
128
+ ```typescript
129
+ import { AWSCredentialsValues } from 'deployable-awscdk-app-ts'
130
+
131
+ const aWSCredentialsValues: AWSCredentialsValues = { ... }
132
+ ```
133
+
134
+ ##### `region`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsValues.property.region"></a>
135
+
136
+ ```typescript
137
+ public readonly region: string;
138
+ ```
139
+
140
+ - *Type:* `string`
141
+
142
+ Default AWS region for the account.
143
+
144
+ ---
145
+
146
+ ##### `assumeRoleDurationSeconds`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsValues.property.assumeRoleDurationSeconds"></a>
147
+
148
+ ```typescript
149
+ public readonly assumeRoleDurationSeconds: number;
150
+ ```
151
+
152
+ - *Type:* `number`
153
+ - *Default:* 300
154
+
155
+ Duration of assume role session.
156
+
157
+ ---
158
+
159
+ ##### `roleToAssume`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsValues.property.roleToAssume"></a>
160
+
161
+ ```typescript
162
+ public readonly roleToAssume: string;
163
+ ```
164
+
165
+ - *Type:* `string`
166
+
167
+ ARN of AWS role to be assumed.
168
+
169
+ ---
170
+
171
+ ##### `accessKeyId`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsValues.property.accessKeyId"></a>
172
+
173
+ ```typescript
174
+ public readonly accessKeyId: string;
175
+ ```
176
+
177
+ - *Type:* `string`
178
+
179
+ AWS Access Key Id.
180
+
181
+ ---
182
+
183
+ ##### `secretAccessKey`<sup>Required</sup> <a name="deployable-awscdk-app-ts.AWSCredentialsValues.property.secretAccessKey"></a>
184
+
185
+ ```typescript
186
+ public readonly secretAccessKey: string;
187
+ ```
188
+
189
+ - *Type:* `string`
190
+
191
+ AWS Secret Access Key.
192
+
193
+ ---
194
+
195
+ ### DeployableAwsCdkTypeScriptAppOptions <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions"></a>
196
+
197
+ #### Initializer <a name="[object Object].Initializer"></a>
198
+
199
+ ```typescript
200
+ import { DeployableAwsCdkTypeScriptAppOptions } from 'deployable-awscdk-app-ts'
201
+
202
+ const deployableAwsCdkTypeScriptAppOptions: DeployableAwsCdkTypeScriptAppOptions = { ... }
203
+ ```
204
+
205
+ ##### `name`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.name"></a>
206
+
207
+ ```typescript
208
+ public readonly name: string;
209
+ ```
210
+
211
+ - *Type:* `string`
212
+ - *Default:* $BASEDIR
213
+
214
+ This is the name of your project.
215
+
216
+ ---
217
+
218
+ ##### `logging`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.logging"></a>
219
+
220
+ ```typescript
221
+ public readonly logging: LoggerOptions;
222
+ ```
223
+
224
+ - *Type:* [`projen.LoggerOptions`](#projen.LoggerOptions)
225
+ - *Default:* {}
226
+
227
+ Configure logging options such as verbosity.
228
+
229
+ ---
230
+
231
+ ##### `outdir`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.outdir"></a>
232
+
233
+ ```typescript
234
+ public readonly outdir: string;
235
+ ```
236
+
237
+ - *Type:* `string`
238
+ - *Default:* "."
239
+
240
+ The root directory of the project.
241
+
242
+ Relative to this directory, all files are synthesized. If this project has a parent, this directory is relative to the parent directory and it cannot be the same as the parent or any of it's other sub-projects.
243
+
244
+ ---
245
+
246
+ ##### `parent`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.parent"></a>
247
+
248
+ ```typescript
249
+ public readonly parent: Project;
250
+ ```
251
+
252
+ - *Type:* [`projen.Project`](#projen.Project)
253
+
254
+ The parent project, if this project is part of a bigger project.
255
+
256
+ ---
257
+
258
+ ##### `projenCommand`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenCommand"></a>
259
+
260
+ ```typescript
261
+ public readonly projenCommand: string;
262
+ ```
263
+
264
+ - *Type:* `string`
265
+ - *Default:* "npx projen"
266
+
267
+ The shell command to use in order to run the projen CLI.
268
+
269
+ Can be used to customize in special environments.
270
+
271
+ ---
272
+
273
+ ##### `projenrcJson`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcJson"></a>
274
+
275
+ ```typescript
276
+ public readonly projenrcJson: boolean;
277
+ ```
278
+
279
+ - *Type:* `boolean`
280
+ - *Default:* false
281
+
282
+ Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation.
283
+
284
+ ---
285
+
286
+ ##### `projenrcJsonOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcJsonOptions"></a>
287
+
288
+ ```typescript
289
+ public readonly projenrcJsonOptions: ProjenrcOptions;
290
+ ```
291
+
292
+ - *Type:* [`projen.json.ProjenrcOptions`](#projen.json.ProjenrcOptions)
293
+ - *Default:* default options
294
+
295
+ Options for .projenrc.json.
296
+
297
+ ---
298
+
299
+ ##### `autoApproveOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.autoApproveOptions"></a>
300
+
301
+ ```typescript
302
+ public readonly autoApproveOptions: AutoApproveOptions;
303
+ ```
304
+
305
+ - *Type:* [`projen.github.AutoApproveOptions`](#projen.github.AutoApproveOptions)
306
+ - *Default:* auto approve is disabled
307
+
308
+ Enable and configure the 'auto approve' workflow.
309
+
310
+ ---
311
+
312
+ ##### `autoMergeOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.autoMergeOptions"></a>
313
+
314
+ ```typescript
315
+ public readonly autoMergeOptions: AutoMergeOptions;
316
+ ```
317
+
318
+ - *Type:* [`projen.github.AutoMergeOptions`](#projen.github.AutoMergeOptions)
319
+ - *Default:* see defaults in `AutoMergeOptions`
320
+
321
+ Configure options for automatic merging on GitHub.
322
+
323
+ Has no effect if `github.mergify` is set to false.
324
+
325
+ ---
326
+
327
+ ##### `clobber`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.clobber"></a>
328
+
329
+ ```typescript
330
+ public readonly clobber: boolean;
331
+ ```
332
+
333
+ - *Type:* `boolean`
334
+ - *Default:* true
335
+
336
+ Add a `clobber` task which resets the repo to origin.
337
+
338
+ ---
339
+
340
+ ##### `devContainer`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.devContainer"></a>
341
+
342
+ ```typescript
343
+ public readonly devContainer: boolean;
344
+ ```
345
+
346
+ - *Type:* `boolean`
347
+ - *Default:* false
348
+
349
+ Add a VSCode development environment (used for GitHub Codespaces).
350
+
351
+ ---
352
+
353
+ ##### `github`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.github"></a>
354
+
355
+ ```typescript
356
+ public readonly github: boolean;
357
+ ```
358
+
359
+ - *Type:* `boolean`
360
+ - *Default:* true
361
+
362
+ Enable GitHub integration.
363
+
364
+ Enabled by default for root projects. Disabled for non-root projects.
365
+
366
+ ---
367
+
368
+ ##### `githubOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.githubOptions"></a>
369
+
370
+ ```typescript
371
+ public readonly githubOptions: GitHubOptions;
372
+ ```
373
+
374
+ - *Type:* [`projen.github.GitHubOptions`](#projen.github.GitHubOptions)
375
+ - *Default:* see GitHubOptions
376
+
377
+ Options for GitHub integration.
378
+
379
+ ---
380
+
381
+ ##### `gitpod`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.gitpod"></a>
382
+
383
+ ```typescript
384
+ public readonly gitpod: boolean;
385
+ ```
386
+
387
+ - *Type:* `boolean`
388
+ - *Default:* false
389
+
390
+ Add a Gitpod development environment.
391
+
392
+ ---
393
+
394
+ ##### ~~`mergify`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.mergify"></a>
395
+
396
+ - *Deprecated:* use `githubOptions.mergify` instead
397
+
398
+ ```typescript
399
+ public readonly mergify: boolean;
400
+ ```
401
+
402
+ - *Type:* `boolean`
403
+ - *Default:* true
404
+
405
+ Whether mergify should be enabled on this repository or not.
406
+
407
+ ---
408
+
409
+ ##### ~~`mergifyOptions`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.mergifyOptions"></a>
410
+
411
+ - *Deprecated:* use `githubOptions.mergifyOptions` instead
412
+
413
+ ```typescript
414
+ public readonly mergifyOptions: MergifyOptions;
415
+ ```
416
+
417
+ - *Type:* [`projen.github.MergifyOptions`](#projen.github.MergifyOptions)
418
+ - *Default:* default options
419
+
420
+ Options for mergify.
421
+
422
+ ---
423
+
424
+ ##### ~~`projectType`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projectType"></a>
425
+
426
+ - *Deprecated:* no longer supported at the base project level
427
+
428
+ ```typescript
429
+ public readonly projectType: ProjectType;
430
+ ```
431
+
432
+ - *Type:* [`projen.ProjectType`](#projen.ProjectType)
433
+ - *Default:* ProjectType.UNKNOWN
434
+
435
+ Which type of project this is (library/app).
436
+
437
+ ---
438
+
439
+ ##### `readme`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.readme"></a>
440
+
441
+ ```typescript
442
+ public readonly readme: SampleReadmeProps;
443
+ ```
444
+
445
+ - *Type:* [`projen.SampleReadmeProps`](#projen.SampleReadmeProps)
446
+ - *Default:* { filename: 'README.md', contents: '# replace this' }
447
+
448
+ The README setup.
449
+
450
+ ---
451
+
452
+ ##### `stale`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.stale"></a>
453
+
454
+ ```typescript
455
+ public readonly stale: boolean;
456
+ ```
457
+
458
+ - *Type:* `boolean`
459
+ - *Default:* true
460
+
461
+ Auto-close of stale issues and pull request.
462
+
463
+ See `staleOptions` for options.
464
+
465
+ ---
466
+
467
+ ##### `staleOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.staleOptions"></a>
468
+
469
+ ```typescript
470
+ public readonly staleOptions: StaleOptions;
471
+ ```
472
+
473
+ - *Type:* [`projen.github.StaleOptions`](#projen.github.StaleOptions)
474
+ - *Default:* see defaults in `StaleOptions`
475
+
476
+ Auto-close stale issues and pull requests.
477
+
478
+ To disable set `stale` to `false`.
479
+
480
+ ---
481
+
482
+ ##### `vscode`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.vscode"></a>
483
+
484
+ ```typescript
485
+ public readonly vscode: boolean;
486
+ ```
487
+
488
+ - *Type:* `boolean`
489
+ - *Default:* true
490
+
491
+ Enable VSCode integration.
492
+
493
+ Enabled by default for root projects. Disabled for non-root projects.
494
+
495
+ ---
496
+
497
+ ##### `allowLibraryDependencies`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.allowLibraryDependencies"></a>
498
+
499
+ ```typescript
500
+ public readonly allowLibraryDependencies: boolean;
501
+ ```
502
+
503
+ - *Type:* `boolean`
504
+ - *Default:* true
505
+
506
+ Allow the project to include `peerDependencies` and `bundledDependencies`.
507
+
508
+ This is normally only allowed for libraries. For apps, there's no meaning for specifying these.
509
+
510
+ ---
511
+
512
+ ##### `authorEmail`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.authorEmail"></a>
513
+
514
+ ```typescript
515
+ public readonly authorEmail: string;
516
+ ```
517
+
518
+ - *Type:* `string`
519
+
520
+ Author's e-mail.
521
+
522
+ ---
523
+
524
+ ##### `authorName`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.authorName"></a>
525
+
526
+ ```typescript
527
+ public readonly authorName: string;
528
+ ```
529
+
530
+ - *Type:* `string`
531
+
532
+ Author's name.
533
+
534
+ ---
535
+
536
+ ##### `authorOrganization`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.authorOrganization"></a>
537
+
538
+ ```typescript
539
+ public readonly authorOrganization: boolean;
540
+ ```
541
+
542
+ - *Type:* `boolean`
543
+
544
+ Author's Organization.
545
+
546
+ ---
547
+
548
+ ##### `authorUrl`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.authorUrl"></a>
549
+
550
+ ```typescript
551
+ public readonly authorUrl: string;
552
+ ```
553
+
554
+ - *Type:* `string`
555
+
556
+ Author's URL / Website.
557
+
558
+ ---
559
+
560
+ ##### `autoDetectBin`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.autoDetectBin"></a>
561
+
562
+ ```typescript
563
+ public readonly autoDetectBin: boolean;
564
+ ```
565
+
566
+ - *Type:* `boolean`
567
+ - *Default:* true
568
+
569
+ Automatically add all executables under the `bin` directory to your `package.json` file under the `bin` section.
570
+
571
+ ---
572
+
573
+ ##### `bin`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.bin"></a>
574
+
575
+ ```typescript
576
+ public readonly bin: {[ key: string ]: string};
577
+ ```
578
+
579
+ - *Type:* {[ key: string ]: `string`}
580
+
581
+ Binary programs vended with your module.
582
+
583
+ You can use this option to add/customize how binaries are represented in your `package.json`, but unless `autoDetectBin` is `false`, every executable file under `bin` will automatically be added to this section.
584
+
585
+ ---
586
+
587
+ ##### `bundledDeps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.bundledDeps"></a>
588
+
589
+ ```typescript
590
+ public readonly bundledDeps: string[];
591
+ ```
592
+
593
+ - *Type:* `string`[]
594
+
595
+ List of dependencies to bundle into this module.
596
+
597
+ These modules will be added both to the `dependencies` section and `peerDependencies` section of your `package.json`. The recommendation is to only specify the module name here (e.g. `express`). This will behave similar to `yarn add` or `npm install` in the sense that it will add the module as a dependency to your `package.json` file with the latest version (`^`). You can specify semver requirements in the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and this will be what you `package.json` will eventually include.
598
+
599
+ ---
600
+
601
+ ##### `codeArtifactOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.codeArtifactOptions"></a>
602
+
603
+ ```typescript
604
+ public readonly codeArtifactOptions: CodeArtifactOptions;
605
+ ```
606
+
607
+ - *Type:* [`projen.CodeArtifactOptions`](#projen.CodeArtifactOptions)
608
+ - *Default:* undefined
609
+
610
+ Options for publishing npm package to AWS CodeArtifact.
611
+
612
+ ---
613
+
614
+ ##### `deps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.deps"></a>
615
+
616
+ ```typescript
617
+ public readonly deps: string[];
618
+ ```
619
+
620
+ - *Type:* `string`[]
621
+ - *Default:* []
622
+
623
+ Runtime dependencies of this module.
624
+
625
+ The recommendation is to only specify the module name here (e.g. `express`). This will behave similar to `yarn add` or `npm install` in the sense that it will add the module as a dependency to your `package.json` file with the latest version (`^`). You can specify semver requirements in the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and this will be what you `package.json` will eventually include.
626
+
627
+ ---
628
+
629
+ ##### `description`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.description"></a>
630
+
631
+ ```typescript
632
+ public readonly description: string;
633
+ ```
634
+
635
+ - *Type:* `string`
636
+
637
+ The description is just a string that helps people understand the purpose of the package.
638
+
639
+ It can be used when searching for packages in a package manager as well. See https://classic.yarnpkg.com/en/docs/package-json/#toc-description
640
+
641
+ ---
642
+
643
+ ##### `devDeps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.devDeps"></a>
644
+
645
+ ```typescript
646
+ public readonly devDeps: string[];
647
+ ```
648
+
649
+ - *Type:* `string`[]
650
+ - *Default:* []
651
+
652
+ Build dependencies for this module.
653
+
654
+ These dependencies will only be available in your build environment but will not be fetched when this module is consumed. The recommendation is to only specify the module name here (e.g. `express`). This will behave similar to `yarn add` or `npm install` in the sense that it will add the module as a dependency to your `package.json` file with the latest version (`^`). You can specify semver requirements in the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and this will be what you `package.json` will eventually include.
655
+
656
+ ---
657
+
658
+ ##### `entrypoint`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.entrypoint"></a>
659
+
660
+ ```typescript
661
+ public readonly entrypoint: string;
662
+ ```
663
+
664
+ - *Type:* `string`
665
+ - *Default:* "lib/index.js"
666
+
667
+ Module entrypoint (`main` in `package.json`).
668
+
669
+ Set to an empty string to not include `main` in your package.json
670
+
671
+ ---
672
+
673
+ ##### `homepage`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.homepage"></a>
674
+
675
+ ```typescript
676
+ public readonly homepage: string;
677
+ ```
678
+
679
+ - *Type:* `string`
680
+
681
+ Package's Homepage / Website.
682
+
683
+ ---
684
+
685
+ ##### `keywords`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.keywords"></a>
686
+
687
+ ```typescript
688
+ public readonly keywords: string[];
689
+ ```
690
+
691
+ - *Type:* `string`[]
692
+
693
+ Keywords to include in `package.json`.
694
+
695
+ ---
696
+
697
+ ##### `license`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.license"></a>
698
+
699
+ ```typescript
700
+ public readonly license: string;
701
+ ```
702
+
703
+ - *Type:* `string`
704
+ - *Default:* "Apache-2.0"
705
+
706
+ License's SPDX identifier.
707
+
708
+ See https://github.com/projen/projen/tree/main/license-text for a list of supported licenses. Use the `licensed` option if you want to no license to be specified.
709
+
710
+ ---
711
+
712
+ ##### `licensed`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.licensed"></a>
713
+
714
+ ```typescript
715
+ public readonly licensed: boolean;
716
+ ```
717
+
718
+ - *Type:* `boolean`
719
+ - *Default:* true
720
+
721
+ Indicates if a license should be added.
722
+
723
+ ---
724
+
725
+ ##### `maxNodeVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.maxNodeVersion"></a>
726
+
727
+ ```typescript
728
+ public readonly maxNodeVersion: string;
729
+ ```
730
+
731
+ - *Type:* `string`
732
+ - *Default:* no max
733
+
734
+ Minimum node.js version to require via `engines` (inclusive).
735
+
736
+ ---
737
+
738
+ ##### `minNodeVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.minNodeVersion"></a>
739
+
740
+ ```typescript
741
+ public readonly minNodeVersion: string;
742
+ ```
743
+
744
+ - *Type:* `string`
745
+ - *Default:* no "engines" specified
746
+
747
+ Minimum Node.js version to require via package.json `engines` (inclusive).
748
+
749
+ ---
750
+
751
+ ##### `npmAccess`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmAccess"></a>
752
+
753
+ ```typescript
754
+ public readonly npmAccess: NpmAccess;
755
+ ```
756
+
757
+ - *Type:* [`projen.NpmAccess`](#projen.NpmAccess)
758
+ - *Default:* for scoped packages (e.g. `foo@bar`), the default is `NpmAccess.RESTRICTED`, for non-scoped packages, the default is `NpmAccess.PUBLIC`.
759
+
760
+ Access level of the npm package.
761
+
762
+ ---
763
+
764
+ ##### `npmDistTag`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmDistTag"></a>
765
+
766
+ ```typescript
767
+ public readonly npmDistTag: string;
768
+ ```
769
+
770
+ - *Type:* `string`
771
+ - *Default:* "latest"
772
+
773
+ Tags can be used to provide an alias instead of version numbers.
774
+
775
+ For example, a project might choose to have multiple streams of development and use a different tag for each stream, e.g., stable, beta, dev, canary. By default, the `latest` tag is used by npm to identify the current version of a package, and `npm install <pkg>` (without any `@<version>` or `@<tag>` specifier) installs the latest tag. Typically, projects only use the `latest` tag for stable release versions, and use other tags for unstable versions such as prereleases. The `next` tag is used by some projects to identify the upcoming version.
776
+
777
+ ---
778
+
779
+ ##### ~~`npmRegistry`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmRegistry"></a>
780
+
781
+ - *Deprecated:* use `npmRegistryUrl` instead
782
+
783
+ ```typescript
784
+ public readonly npmRegistry: string;
785
+ ```
786
+
787
+ - *Type:* `string`
788
+
789
+ The host name of the npm registry to publish to.
790
+
791
+ Cannot be set together with `npmRegistryUrl`.
792
+
793
+ ---
794
+
795
+ ##### `npmRegistryUrl`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmRegistryUrl"></a>
796
+
797
+ ```typescript
798
+ public readonly npmRegistryUrl: string;
799
+ ```
800
+
801
+ - *Type:* `string`
802
+ - *Default:* "https://registry.npmjs.org"
803
+
804
+ The base URL of the npm package registry.
805
+
806
+ Must be a URL (e.g. start with "https://" or "http://")
807
+
808
+ ---
809
+
810
+ ##### `npmTokenSecret`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmTokenSecret"></a>
811
+
812
+ ```typescript
813
+ public readonly npmTokenSecret: string;
814
+ ```
815
+
816
+ - *Type:* `string`
817
+ - *Default:* "NPM_TOKEN"
818
+
819
+ GitHub secret which contains the NPM token to use when publishing packages.
820
+
821
+ ---
822
+
823
+ ##### `packageManager`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.packageManager"></a>
824
+
825
+ ```typescript
826
+ public readonly packageManager: NodePackageManager;
827
+ ```
828
+
829
+ - *Type:* [`projen.NodePackageManager`](#projen.NodePackageManager)
830
+ - *Default:* NodePackageManager.YARN
831
+
832
+ The Node Package Manager used to execute scripts.
833
+
834
+ ---
835
+
836
+ ##### `packageName`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.packageName"></a>
837
+
838
+ ```typescript
839
+ public readonly packageName: string;
840
+ ```
841
+
842
+ - *Type:* `string`
843
+ - *Default:* defaults to project name
844
+
845
+ The "name" in package.json.
846
+
847
+ ---
848
+
849
+ ##### `peerDependencyOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.peerDependencyOptions"></a>
850
+
851
+ ```typescript
852
+ public readonly peerDependencyOptions: PeerDependencyOptions;
853
+ ```
854
+
855
+ - *Type:* [`projen.PeerDependencyOptions`](#projen.PeerDependencyOptions)
856
+
857
+ Options for `peerDeps`.
858
+
859
+ ---
860
+
861
+ ##### `peerDeps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.peerDeps"></a>
862
+
863
+ ```typescript
864
+ public readonly peerDeps: string[];
865
+ ```
866
+
867
+ - *Type:* `string`[]
868
+ - *Default:* []
869
+
870
+ Peer dependencies for this module.
871
+
872
+ Dependencies listed here are required to be installed (and satisfied) by the _consumer_ of this library. Using peer dependencies allows you to ensure that only a single module of a certain library exists in the `node_modules` tree of your consumers. Note that prior to npm@7, peer dependencies are _not_ automatically installed, which means that adding peer dependencies to a library will be a breaking change for your customers. Unless `peerDependencyOptions.pinnedDevDependency` is disabled (it is enabled by default), projen will automatically add a dev dependency with a pinned version for each peer dependency. This will ensure that you build & test your module against the lowest peer version required.
873
+
874
+ ---
875
+
876
+ ##### `repository`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.repository"></a>
877
+
878
+ ```typescript
879
+ public readonly repository: string;
880
+ ```
881
+
882
+ - *Type:* `string`
883
+
884
+ The repository is the location where the actual code for your package lives.
885
+
886
+ See https://classic.yarnpkg.com/en/docs/package-json/#toc-repository
887
+
888
+ ---
889
+
890
+ ##### `repositoryDirectory`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.repositoryDirectory"></a>
891
+
892
+ ```typescript
893
+ public readonly repositoryDirectory: string;
894
+ ```
895
+
896
+ - *Type:* `string`
897
+
898
+ If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives.
899
+
900
+ ---
901
+
902
+ ##### `scripts`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.scripts"></a>
903
+
904
+ ```typescript
905
+ public readonly scripts: {[ key: string ]: string};
906
+ ```
907
+
908
+ - *Type:* {[ key: string ]: `string`}
909
+ - *Default:* {}
910
+
911
+ npm scripts to include.
912
+
913
+ If a script has the same name as a standard script, the standard script will be overwritten.
914
+
915
+ ---
916
+
917
+ ##### `stability`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.stability"></a>
918
+
919
+ ```typescript
920
+ public readonly stability: string;
921
+ ```
922
+
923
+ - *Type:* `string`
924
+
925
+ Package's Stability.
926
+
927
+ ---
928
+
929
+ ##### `antitamper`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.antitamper"></a>
930
+
931
+ ```typescript
932
+ public readonly antitamper: boolean;
933
+ ```
934
+
935
+ - *Type:* `boolean`
936
+ - *Default:* true
937
+
938
+ Checks that after build there are no modified files on git.
939
+
940
+ ---
941
+
942
+ ##### `artifactsDirectory`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.artifactsDirectory"></a>
943
+
944
+ ```typescript
945
+ public readonly artifactsDirectory: string;
946
+ ```
947
+
948
+ - *Type:* `string`
949
+ - *Default:* "dist"
950
+
951
+ A directory which will contain artifacts to be published to npm.
952
+
953
+ ---
954
+
955
+ ##### `jsiiReleaseVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.jsiiReleaseVersion"></a>
956
+
957
+ ```typescript
958
+ public readonly jsiiReleaseVersion: string;
959
+ ```
960
+
961
+ - *Type:* `string`
962
+ - *Default:* "latest"
963
+
964
+ Version requirement of `jsii-release` which is used to publish modules to npm.
965
+
966
+ ---
967
+
968
+ ##### `majorVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.majorVersion"></a>
969
+
970
+ ```typescript
971
+ public readonly majorVersion: number;
972
+ ```
973
+
974
+ - *Type:* `number`
975
+ - *Default:* Major version is not enforced.
976
+
977
+ Major version to release from the default branch.
978
+
979
+ If this is specified, we bump the latest version of this major version line. If not specified, we bump the global latest version.
980
+
981
+ ---
982
+
983
+ ##### `postBuildSteps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.postBuildSteps"></a>
984
+
985
+ ```typescript
986
+ public readonly postBuildSteps: JobStep[];
987
+ ```
988
+
989
+ - *Type:* [`projen.github.workflows.JobStep`](#projen.github.workflows.JobStep)[]
990
+ - *Default:* []
991
+
992
+ Steps to execute after build as part of the release workflow.
993
+
994
+ ---
995
+
996
+ ##### `prerelease`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.prerelease"></a>
997
+
998
+ ```typescript
999
+ public readonly prerelease: string;
1000
+ ```
1001
+
1002
+ - *Type:* `string`
1003
+ - *Default:* normal semantic versions
1004
+
1005
+ Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").
1006
+
1007
+ ---
1008
+
1009
+ ##### `releaseBranches`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseBranches"></a>
1010
+
1011
+ ```typescript
1012
+ public readonly releaseBranches: {[ key: string ]: BranchOptions};
1013
+ ```
1014
+
1015
+ - *Type:* {[ key: string ]: [`projen.release.BranchOptions`](#projen.release.BranchOptions)}
1016
+ - *Default:* no additional branches are used for release. you can use `addBranch()` to add additional branches.
1017
+
1018
+ Defines additional release branches.
1019
+
1020
+ A workflow will be created for each release branch which will publish releases from commits in this branch. Each release branch _must_ be assigned a major version number which is used to enforce that versions published from that branch always use that major version. If multiple branches are used, the `majorVersion` field must also be provided for the default branch.
1021
+
1022
+ ---
1023
+
1024
+ ##### ~~`releaseEveryCommit`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseEveryCommit"></a>
1025
+
1026
+ - *Deprecated:* Use `releaseTrigger: ReleaseTrigger.continuous()` instead
1027
+
1028
+ ```typescript
1029
+ public readonly releaseEveryCommit: boolean;
1030
+ ```
1031
+
1032
+ - *Type:* `boolean`
1033
+ - *Default:* true
1034
+
1035
+ Automatically release new versions every commit to one of branches in `releaseBranches`.
1036
+
1037
+ ---
1038
+
1039
+ ##### `releaseFailureIssue`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseFailureIssue"></a>
1040
+
1041
+ ```typescript
1042
+ public readonly releaseFailureIssue: boolean;
1043
+ ```
1044
+
1045
+ - *Type:* `boolean`
1046
+ - *Default:* false
1047
+
1048
+ Create a github issue on every failed publishing task.
1049
+
1050
+ ---
1051
+
1052
+ ##### `releaseFailureIssueLabel`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseFailureIssueLabel"></a>
1053
+
1054
+ ```typescript
1055
+ public readonly releaseFailureIssueLabel: string;
1056
+ ```
1057
+
1058
+ - *Type:* `string`
1059
+ - *Default:* "failed-release"
1060
+
1061
+ The label to apply to issues indicating publish failures.
1062
+
1063
+ Only applies if `releaseFailureIssue` is true.
1064
+
1065
+ ---
1066
+
1067
+ ##### ~~`releaseSchedule`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseSchedule"></a>
1068
+
1069
+ - *Deprecated:* Use `releaseTrigger: ReleaseTrigger.scheduled()` instead
1070
+
1071
+ ```typescript
1072
+ public readonly releaseSchedule: string;
1073
+ ```
1074
+
1075
+ - *Type:* `string`
1076
+ - *Default:* no scheduled releases
1077
+
1078
+ CRON schedule to trigger new releases.
1079
+
1080
+ ---
1081
+
1082
+ ##### `releaseTagPrefix`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseTagPrefix"></a>
1083
+
1084
+ ```typescript
1085
+ public readonly releaseTagPrefix: string;
1086
+ ```
1087
+
1088
+ - *Type:* `string`
1089
+ - *Default:* no prefix
1090
+
1091
+ Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers.
1092
+
1093
+ Note: this prefix is used to detect the latest tagged version when bumping, so if you change this on a project with an existing version history, you may need to manually tag your latest release with the new prefix.
1094
+
1095
+ ---
1096
+
1097
+ ##### `releaseTrigger`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseTrigger"></a>
1098
+
1099
+ ```typescript
1100
+ public readonly releaseTrigger: ReleaseTrigger;
1101
+ ```
1102
+
1103
+ - *Type:* [`projen.release.ReleaseTrigger`](#projen.release.ReleaseTrigger)
1104
+ - *Default:* Continuous releases (`ReleaseTrigger.continuous()`)
1105
+
1106
+ The release trigger to use.
1107
+
1108
+ ---
1109
+
1110
+ ##### `releaseWorkflowName`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseWorkflowName"></a>
1111
+
1112
+ ```typescript
1113
+ public readonly releaseWorkflowName: string;
1114
+ ```
1115
+
1116
+ - *Type:* `string`
1117
+ - *Default:* "Release"
1118
+
1119
+ The name of the default release workflow.
1120
+
1121
+ ---
1122
+
1123
+ ##### `releaseWorkflowSetupSteps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseWorkflowSetupSteps"></a>
1124
+
1125
+ ```typescript
1126
+ public readonly releaseWorkflowSetupSteps: JobStep[];
1127
+ ```
1128
+
1129
+ - *Type:* [`projen.github.workflows.JobStep`](#projen.github.workflows.JobStep)[]
1130
+
1131
+ A set of workflow steps to execute in order to setup the workflow container.
1132
+
1133
+ ---
1134
+
1135
+ ##### `versionrcOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.versionrcOptions"></a>
1136
+
1137
+ ```typescript
1138
+ public readonly versionrcOptions: {[ key: string ]: any};
1139
+ ```
1140
+
1141
+ - *Type:* {[ key: string ]: `any`}
1142
+ - *Default:* standard configuration applicable for GitHub repositories
1143
+
1144
+ Custom configuration used when creating changelog with standard-version package.
1145
+
1146
+ Given values either append to default configuration or overwrite values in it.
1147
+
1148
+ ---
1149
+
1150
+ ##### `workflowContainerImage`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.workflowContainerImage"></a>
1151
+
1152
+ ```typescript
1153
+ public readonly workflowContainerImage: string;
1154
+ ```
1155
+
1156
+ - *Type:* `string`
1157
+ - *Default:* default image
1158
+
1159
+ Container image to use for GitHub workflows.
1160
+
1161
+ ---
1162
+
1163
+ ##### `defaultReleaseBranch`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.defaultReleaseBranch"></a>
1164
+
1165
+ ```typescript
1166
+ public readonly defaultReleaseBranch: string;
1167
+ ```
1168
+
1169
+ - *Type:* `string`
1170
+ - *Default:* "main"
1171
+
1172
+ The name of the main release branch.
1173
+
1174
+ ---
1175
+
1176
+ ##### `autoApproveProjenUpgrades`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.autoApproveProjenUpgrades"></a>
1177
+
1178
+ ```typescript
1179
+ public readonly autoApproveProjenUpgrades: boolean;
1180
+ ```
1181
+
1182
+ - *Type:* `boolean`
1183
+ - *Default:* false
1184
+
1185
+ Automatically approve projen upgrade PRs, allowing them to be merged by mergify (if configued).
1186
+
1187
+ Throw if set to true but `autoApproveOptions` are not defined.
1188
+
1189
+ ---
1190
+
1191
+ ##### `autoApproveUpgrades`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.autoApproveUpgrades"></a>
1192
+
1193
+ ```typescript
1194
+ public readonly autoApproveUpgrades: boolean;
1195
+ ```
1196
+
1197
+ - *Type:* `boolean`
1198
+ - *Default:* true
1199
+
1200
+ Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued).
1201
+
1202
+ Throw if set to true but `autoApproveOptions` are not defined.
1203
+
1204
+ ---
1205
+
1206
+ ##### `buildWorkflow`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.buildWorkflow"></a>
1207
+
1208
+ ```typescript
1209
+ public readonly buildWorkflow: boolean;
1210
+ ```
1211
+
1212
+ - *Type:* `boolean`
1213
+ - *Default:* true if not a subproject
1214
+
1215
+ Define a GitHub workflow for building PRs.
1216
+
1217
+ ---
1218
+
1219
+ ##### `bundlerOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.bundlerOptions"></a>
1220
+
1221
+ ```typescript
1222
+ public readonly bundlerOptions: BundlerOptions;
1223
+ ```
1224
+
1225
+ - *Type:* [`projen.javascript.BundlerOptions`](#projen.javascript.BundlerOptions)
1226
+
1227
+ Options for `Bundler`.
1228
+
1229
+ ---
1230
+
1231
+ ##### `codeCov`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.codeCov"></a>
1232
+
1233
+ ```typescript
1234
+ public readonly codeCov: boolean;
1235
+ ```
1236
+
1237
+ - *Type:* `boolean`
1238
+ - *Default:* false
1239
+
1240
+ Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v1 A secret is required for private repos. Configured with @codeCovTokenSecret.
1241
+
1242
+ ---
1243
+
1244
+ ##### `codeCovTokenSecret`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.codeCovTokenSecret"></a>
1245
+
1246
+ ```typescript
1247
+ public readonly codeCovTokenSecret: string;
1248
+ ```
1249
+
1250
+ - *Type:* `string`
1251
+ - *Default:* if this option is not specified, only public repositories are supported
1252
+
1253
+ Define the secret name for a specified https://codecov.io/ token A secret is required to send coverage for private repositories.
1254
+
1255
+ ---
1256
+
1257
+ ##### `copyrightOwner`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.copyrightOwner"></a>
1258
+
1259
+ ```typescript
1260
+ public readonly copyrightOwner: string;
1261
+ ```
1262
+
1263
+ - *Type:* `string`
1264
+ - *Default:* defaults to the value of authorName or "" if `authorName` is undefined.
1265
+
1266
+ License copyright owner.
1267
+
1268
+ ---
1269
+
1270
+ ##### `copyrightPeriod`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.copyrightPeriod"></a>
1271
+
1272
+ ```typescript
1273
+ public readonly copyrightPeriod: string;
1274
+ ```
1275
+
1276
+ - *Type:* `string`
1277
+ - *Default:* current year
1278
+
1279
+ The copyright years to put in the LICENSE file.
1280
+
1281
+ ---
1282
+
1283
+ ##### `dependabot`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.dependabot"></a>
1284
+
1285
+ ```typescript
1286
+ public readonly dependabot: boolean;
1287
+ ```
1288
+
1289
+ - *Type:* `boolean`
1290
+ - *Default:* false
1291
+
1292
+ Use dependabot to handle dependency upgrades.
1293
+
1294
+ Cannot be used in conjunction with `depsUpgrade`.
1295
+
1296
+ ---
1297
+
1298
+ ##### `dependabotOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.dependabotOptions"></a>
1299
+
1300
+ ```typescript
1301
+ public readonly dependabotOptions: DependabotOptions;
1302
+ ```
1303
+
1304
+ - *Type:* [`projen.github.DependabotOptions`](#projen.github.DependabotOptions)
1305
+ - *Default:* default options
1306
+
1307
+ Options for dependabot.
1308
+
1309
+ ---
1310
+
1311
+ ##### `depsUpgrade`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.depsUpgrade"></a>
1312
+
1313
+ ```typescript
1314
+ public readonly depsUpgrade: boolean;
1315
+ ```
1316
+
1317
+ - *Type:* `boolean`
1318
+ - *Default:* true
1319
+
1320
+ Use github workflows to handle dependency upgrades.
1321
+
1322
+ Cannot be used in conjunction with `dependabot`.
1323
+
1324
+ ---
1325
+
1326
+ ##### `depsUpgradeOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.depsUpgradeOptions"></a>
1327
+
1328
+ ```typescript
1329
+ public readonly depsUpgradeOptions: UpgradeDependenciesOptions;
1330
+ ```
1331
+
1332
+ - *Type:* [`projen.UpgradeDependenciesOptions`](#projen.UpgradeDependenciesOptions)
1333
+ - *Default:* default options
1334
+
1335
+ Options for depsUpgrade.
1336
+
1337
+ ---
1338
+
1339
+ ##### `gitignore`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.gitignore"></a>
1340
+
1341
+ ```typescript
1342
+ public readonly gitignore: string[];
1343
+ ```
1344
+
1345
+ - *Type:* `string`[]
1346
+
1347
+ Additional entries to .gitignore.
1348
+
1349
+ ---
1350
+
1351
+ ##### `jest`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.jest"></a>
1352
+
1353
+ ```typescript
1354
+ public readonly jest: boolean;
1355
+ ```
1356
+
1357
+ - *Type:* `boolean`
1358
+ - *Default:* true
1359
+
1360
+ Setup jest unit tests.
1361
+
1362
+ ---
1363
+
1364
+ ##### `jestOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.jestOptions"></a>
1365
+
1366
+ ```typescript
1367
+ public readonly jestOptions: JestOptions;
1368
+ ```
1369
+
1370
+ - *Type:* [`projen.JestOptions`](#projen.JestOptions)
1371
+ - *Default:* default options
1372
+
1373
+ Jest options.
1374
+
1375
+ ---
1376
+
1377
+ ##### `mutableBuild`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.mutableBuild"></a>
1378
+
1379
+ ```typescript
1380
+ public readonly mutableBuild: boolean;
1381
+ ```
1382
+
1383
+ - *Type:* `boolean`
1384
+ - *Default:* true
1385
+
1386
+ Automatically update files modified during builds to pull-request branches.
1387
+
1388
+ This means that any files synthesized by projen or e.g. test snapshots will always be up-to-date before a PR is merged. Implies that PR builds do not have anti-tamper checks.
1389
+
1390
+ ---
1391
+
1392
+ ##### ~~`npmignore`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmignore"></a>
1393
+
1394
+ - *Deprecated:* - use `project.addPackageIgnore`
1395
+
1396
+ ```typescript
1397
+ public readonly npmignore: string[];
1398
+ ```
1399
+
1400
+ - *Type:* `string`[]
1401
+
1402
+ Additional entries to .npmignore.
1403
+
1404
+ ---
1405
+
1406
+ ##### `npmignoreEnabled`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.npmignoreEnabled"></a>
1407
+
1408
+ ```typescript
1409
+ public readonly npmignoreEnabled: boolean;
1410
+ ```
1411
+
1412
+ - *Type:* `boolean`
1413
+ - *Default:* true
1414
+
1415
+ Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs.
1416
+
1417
+ ---
1418
+
1419
+ ##### `projenDevDependency`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenDevDependency"></a>
1420
+
1421
+ ```typescript
1422
+ public readonly projenDevDependency: boolean;
1423
+ ```
1424
+
1425
+ - *Type:* `boolean`
1426
+ - *Default:* true
1427
+
1428
+ Indicates of "projen" should be installed as a devDependency.
1429
+
1430
+ ---
1431
+
1432
+ ##### `projenrcJs`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcJs"></a>
1433
+
1434
+ ```typescript
1435
+ public readonly projenrcJs: boolean;
1436
+ ```
1437
+
1438
+ - *Type:* `boolean`
1439
+ - *Default:* true if projenrcJson is false
1440
+
1441
+ Generate (once) .projenrc.js (in JavaScript). Set to `false` in order to disable .projenrc.js generation.
1442
+
1443
+ ---
1444
+
1445
+ ##### `projenrcJsOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcJsOptions"></a>
1446
+
1447
+ ```typescript
1448
+ public readonly projenrcJsOptions: ProjenrcOptions;
1449
+ ```
1450
+
1451
+ - *Type:* [`projen.javascript.ProjenrcOptions`](#projen.javascript.ProjenrcOptions)
1452
+ - *Default:* default options
1453
+
1454
+ Options for .projenrc.js.
1455
+
1456
+ ---
1457
+
1458
+ ##### ~~`projenUpgradeAutoMerge`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenUpgradeAutoMerge"></a>
1459
+
1460
+ - *Deprecated:* use `autoApproveProjenUpgrades`.
1461
+
1462
+ ```typescript
1463
+ public readonly projenUpgradeAutoMerge: boolean;
1464
+ ```
1465
+
1466
+ - *Type:* `boolean`
1467
+ - *Default:* false
1468
+
1469
+ Automatically approve projen upgrade PRs, allowing them to be merged by mergify (if configued).
1470
+
1471
+ Throw if set to true but `autoApproveOptions` are not defined.
1472
+
1473
+ ---
1474
+
1475
+ ##### `projenUpgradeSchedule`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenUpgradeSchedule"></a>
1476
+
1477
+ ```typescript
1478
+ public readonly projenUpgradeSchedule: string[];
1479
+ ```
1480
+
1481
+ - *Type:* `string`[]
1482
+ - *Default:* [ "0 6 * * *" ]
1483
+
1484
+ Customize the projenUpgrade schedule in cron expression.
1485
+
1486
+ ---
1487
+
1488
+ ##### `projenUpgradeSecret`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenUpgradeSecret"></a>
1489
+
1490
+ ```typescript
1491
+ public readonly projenUpgradeSecret: string;
1492
+ ```
1493
+
1494
+ - *Type:* `string`
1495
+ - *Default:* no automatic projen upgrade pull requests
1496
+
1497
+ Periodically submits a pull request for projen upgrades (executes `yarn projen:upgrade`).
1498
+
1499
+ This setting is a GitHub secret name which contains a GitHub Access Token with `repo` and `workflow` permissions. This token is used to submit the upgrade pull request, which will likely include workflow updates. To create a personal access token see https://github.com/settings/tokens
1500
+
1501
+ ---
1502
+
1503
+ ##### `projenVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenVersion"></a>
1504
+
1505
+ ```typescript
1506
+ public readonly projenVersion: string;
1507
+ ```
1508
+
1509
+ - *Type:* `string`
1510
+ - *Default:* Defaults to the latest version.
1511
+
1512
+ Version of projen to install.
1513
+
1514
+ ---
1515
+
1516
+ ##### `pullRequestTemplate`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.pullRequestTemplate"></a>
1517
+
1518
+ ```typescript
1519
+ public readonly pullRequestTemplate: boolean;
1520
+ ```
1521
+
1522
+ - *Type:* `boolean`
1523
+ - *Default:* true
1524
+
1525
+ Include a GitHub pull request template.
1526
+
1527
+ ---
1528
+
1529
+ ##### `pullRequestTemplateContents`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.pullRequestTemplateContents"></a>
1530
+
1531
+ ```typescript
1532
+ public readonly pullRequestTemplateContents: string[];
1533
+ ```
1534
+
1535
+ - *Type:* `string`[]
1536
+ - *Default:* default content
1537
+
1538
+ The contents of the pull request template.
1539
+
1540
+ ---
1541
+
1542
+ ##### `release`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.release"></a>
1543
+
1544
+ ```typescript
1545
+ public readonly release: boolean;
1546
+ ```
1547
+
1548
+ - *Type:* `boolean`
1549
+ - *Default:* true (false for subprojects)
1550
+
1551
+ Add release management to this project.
1552
+
1553
+ ---
1554
+
1555
+ ##### `releaseToNpm`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseToNpm"></a>
1556
+
1557
+ ```typescript
1558
+ public readonly releaseToNpm: boolean;
1559
+ ```
1560
+
1561
+ - *Type:* `boolean`
1562
+ - *Default:* false
1563
+
1564
+ Automatically release to npm when new versions are introduced.
1565
+
1566
+ ---
1567
+
1568
+ ##### ~~`releaseWorkflow`~~<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.releaseWorkflow"></a>
1569
+
1570
+ - *Deprecated:* see `release`.
1571
+
1572
+ ```typescript
1573
+ public readonly releaseWorkflow: boolean;
1574
+ ```
1575
+
1576
+ - *Type:* `boolean`
1577
+ - *Default:* true if not a subproject
1578
+
1579
+ DEPRECATED: renamed to `release`.
1580
+
1581
+ ---
1582
+
1583
+ ##### `workflowBootstrapSteps`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.workflowBootstrapSteps"></a>
1584
+
1585
+ ```typescript
1586
+ public readonly workflowBootstrapSteps: any[];
1587
+ ```
1588
+
1589
+ - *Type:* `any`[]
1590
+ - *Default:* "yarn install --frozen-lockfile && yarn projen"
1591
+
1592
+ Workflow steps to use in order to bootstrap this repo.
1593
+
1594
+ ---
1595
+
1596
+ ##### `workflowGitIdentity`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.workflowGitIdentity"></a>
1597
+
1598
+ ```typescript
1599
+ public readonly workflowGitIdentity: GitIdentity;
1600
+ ```
1601
+
1602
+ - *Type:* [`projen.github.GitIdentity`](#projen.github.GitIdentity)
1603
+ - *Default:* GitHub Actions
1604
+
1605
+ The git identity to use in workflows.
1606
+
1607
+ ---
1608
+
1609
+ ##### `workflowNodeVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.workflowNodeVersion"></a>
1610
+
1611
+ ```typescript
1612
+ public readonly workflowNodeVersion: string;
1613
+ ```
1614
+
1615
+ - *Type:* `string`
1616
+ - *Default:* same as `minNodeVersion`
1617
+
1618
+ The node version to use in GitHub workflows.
1619
+
1620
+ ---
1621
+
1622
+ ##### `disableTsconfig`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.disableTsconfig"></a>
1623
+
1624
+ ```typescript
1625
+ public readonly disableTsconfig: boolean;
1626
+ ```
1627
+
1628
+ - *Type:* `boolean`
1629
+ - *Default:* false
1630
+
1631
+ Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler).
1632
+
1633
+ ---
1634
+
1635
+ ##### `docgen`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.docgen"></a>
1636
+
1637
+ ```typescript
1638
+ public readonly docgen: boolean;
1639
+ ```
1640
+
1641
+ - *Type:* `boolean`
1642
+ - *Default:* false
1643
+
1644
+ Docgen by Typedoc.
1645
+
1646
+ ---
1647
+
1648
+ ##### `docsDirectory`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.docsDirectory"></a>
1649
+
1650
+ ```typescript
1651
+ public readonly docsDirectory: string;
1652
+ ```
1653
+
1654
+ - *Type:* `string`
1655
+ - *Default:* "docs"
1656
+
1657
+ Docs directory.
1658
+
1659
+ ---
1660
+
1661
+ ##### `entrypointTypes`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.entrypointTypes"></a>
1662
+
1663
+ ```typescript
1664
+ public readonly entrypointTypes: string;
1665
+ ```
1666
+
1667
+ - *Type:* `string`
1668
+ - *Default:* .d.ts file derived from the project's entrypoint (usually lib/index.d.ts)
1669
+
1670
+ The .d.ts file that includes the type declarations for this module.
1671
+
1672
+ ---
1673
+
1674
+ ##### `eslint`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.eslint"></a>
1675
+
1676
+ ```typescript
1677
+ public readonly eslint: boolean;
1678
+ ```
1679
+
1680
+ - *Type:* `boolean`
1681
+ - *Default:* true
1682
+
1683
+ Setup eslint.
1684
+
1685
+ ---
1686
+
1687
+ ##### `eslintOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.eslintOptions"></a>
1688
+
1689
+ ```typescript
1690
+ public readonly eslintOptions: EslintOptions;
1691
+ ```
1692
+
1693
+ - *Type:* [`projen.EslintOptions`](#projen.EslintOptions)
1694
+ - *Default:* opinionated default options
1695
+
1696
+ Eslint options.
1697
+
1698
+ ---
1699
+
1700
+ ##### `libdir`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.libdir"></a>
1701
+
1702
+ ```typescript
1703
+ public readonly libdir: string;
1704
+ ```
1705
+
1706
+ - *Type:* `string`
1707
+ - *Default:* "lib"
1708
+
1709
+ Typescript artifacts output directory.
1710
+
1711
+ ---
1712
+
1713
+ ##### `package`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.package"></a>
1714
+
1715
+ ```typescript
1716
+ public readonly package: boolean;
1717
+ ```
1718
+
1719
+ - *Type:* `boolean`
1720
+ - *Default:* true
1721
+
1722
+ Defines a `yarn package` command that will produce a tarball and place it under `dist/js`.
1723
+
1724
+ ---
1725
+
1726
+ ##### `projenrcTs`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcTs"></a>
1727
+
1728
+ ```typescript
1729
+ public readonly projenrcTs: boolean;
1730
+ ```
1731
+
1732
+ - *Type:* `boolean`
1733
+ - *Default:* false
1734
+
1735
+ Use TypeScript for your projenrc file (`.projenrc.ts`).
1736
+
1737
+ ---
1738
+
1739
+ ##### `projenrcTsOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.projenrcTsOptions"></a>
1740
+
1741
+ ```typescript
1742
+ public readonly projenrcTsOptions: ProjenrcOptions;
1743
+ ```
1744
+
1745
+ - *Type:* [`projen.typescript.ProjenrcOptions`](#projen.typescript.ProjenrcOptions)
1746
+
1747
+ Options for .projenrc.ts.
1748
+
1749
+ ---
1750
+
1751
+ ##### `sampleCode`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.sampleCode"></a>
1752
+
1753
+ ```typescript
1754
+ public readonly sampleCode: boolean;
1755
+ ```
1756
+
1757
+ - *Type:* `boolean`
1758
+ - *Default:* true
1759
+
1760
+ Generate one-time sample in `src/` and `test/` if there are no files there.
1761
+
1762
+ ---
1763
+
1764
+ ##### `srcdir`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.srcdir"></a>
1765
+
1766
+ ```typescript
1767
+ public readonly srcdir: string;
1768
+ ```
1769
+
1770
+ - *Type:* `string`
1771
+ - *Default:* "src"
1772
+
1773
+ Typescript sources directory.
1774
+
1775
+ ---
1776
+
1777
+ ##### `testdir`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.testdir"></a>
1778
+
1779
+ ```typescript
1780
+ public readonly testdir: string;
1781
+ ```
1782
+
1783
+ - *Type:* `string`
1784
+ - *Default:* "test"
1785
+
1786
+ Jest tests directory. Tests files should be named `xxx.test.ts`.
1787
+
1788
+ If this directory is under `srcdir` (e.g. `src/test`, `src/__tests__`), then tests are going to be compiled into `lib/` and executed as javascript. If the test directory is outside of `src`, then we configure jest to compile the code in-memory.
1789
+
1790
+ ---
1791
+
1792
+ ##### `tsconfig`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.tsconfig"></a>
1793
+
1794
+ ```typescript
1795
+ public readonly tsconfig: TypescriptConfigOptions;
1796
+ ```
1797
+
1798
+ - *Type:* [`projen.TypescriptConfigOptions`](#projen.TypescriptConfigOptions)
1799
+ - *Default:* default options
1800
+
1801
+ Custom TSConfig.
1802
+
1803
+ ---
1804
+
1805
+ ##### `tsconfigDev`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.tsconfigDev"></a>
1806
+
1807
+ ```typescript
1808
+ public readonly tsconfigDev: TypescriptConfigOptions;
1809
+ ```
1810
+
1811
+ - *Type:* [`projen.TypescriptConfigOptions`](#projen.TypescriptConfigOptions)
1812
+ - *Default:* use the production tsconfig options
1813
+
1814
+ Custom tsconfig options for the development tsconfig.json file (used for testing).
1815
+
1816
+ ---
1817
+
1818
+ ##### `tsconfigDevFile`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.tsconfigDevFile"></a>
1819
+
1820
+ ```typescript
1821
+ public readonly tsconfigDevFile: string;
1822
+ ```
1823
+
1824
+ - *Type:* `string`
1825
+ - *Default:* "tsconfig.dev.json"
1826
+
1827
+ The name of the development tsconfig.json file.
1828
+
1829
+ ---
1830
+
1831
+ ##### `typescriptVersion`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.typescriptVersion"></a>
1832
+
1833
+ ```typescript
1834
+ public readonly typescriptVersion: string;
1835
+ ```
1836
+
1837
+ - *Type:* `string`
1838
+ - *Default:* "latest"
1839
+
1840
+ TypeScript version to use.
1841
+
1842
+ NOTE: Typescript is not semantically versioned and should remain on the same minor, so we recommend using a `~` dependency (e.g. `~1.2.3`).
1843
+
1844
+ ---
1845
+
1846
+ ##### `cdkout`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.cdkout"></a>
1847
+
1848
+ ```typescript
1849
+ public readonly cdkout: string;
1850
+ ```
1851
+
1852
+ - *Type:* `string`
1853
+ - *Default:* "cdk.out"
1854
+
1855
+ cdk.out directory.
1856
+
1857
+ ---
1858
+
1859
+ ##### `context`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.context"></a>
1860
+
1861
+ ```typescript
1862
+ public readonly context: {[ key: string ]: string};
1863
+ ```
1864
+
1865
+ - *Type:* {[ key: string ]: `string`}
1866
+ - *Default:* no additional context
1867
+
1868
+ Additional context to include in `cdk.json`.
1869
+
1870
+ ---
1871
+
1872
+ ##### `featureFlags`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.featureFlags"></a>
1873
+
1874
+ ```typescript
1875
+ public readonly featureFlags: boolean;
1876
+ ```
1877
+
1878
+ - *Type:* `boolean`
1879
+ - *Default:* true
1880
+
1881
+ Include all feature flags in cdk.json.
1882
+
1883
+ ---
1884
+
1885
+ ##### `requireApproval`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.requireApproval"></a>
1886
+
1887
+ ```typescript
1888
+ public readonly requireApproval: ApprovalLevel;
1889
+ ```
1890
+
1891
+ - *Type:* [`projen.awscdk.ApprovalLevel`](#projen.awscdk.ApprovalLevel)
1892
+ - *Default:* ApprovalLevel.BROADENING
1893
+
1894
+ To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
1895
+
1896
+ ---
1897
+
1898
+ ##### `cdkVersion`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.cdkVersion"></a>
1899
+
1900
+ ```typescript
1901
+ public readonly cdkVersion: string;
1902
+ ```
1903
+
1904
+ - *Type:* `string`
1905
+ - *Default:* "1.129.0"
1906
+
1907
+ AWS CDK version to use.
1908
+
1909
+ ---
1910
+
1911
+ ##### `appEntrypoint`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.appEntrypoint"></a>
1912
+
1913
+ ```typescript
1914
+ public readonly appEntrypoint: string;
1915
+ ```
1916
+
1917
+ - *Type:* `string`
1918
+ - *Default:* "main.ts"
1919
+
1920
+ The CDK app's entrypoint (relative to the source directory, which is "src" by default).
1921
+
1922
+ ---
1923
+
1924
+ ##### `cdkDependencies`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.cdkDependencies"></a>
1925
+
1926
+ ```typescript
1927
+ public readonly cdkDependencies: string[];
1928
+ ```
1929
+
1930
+ - *Type:* `string`[]
1931
+
1932
+ Which AWS CDK modules (those that start with "@aws-cdk/") this app uses.
1933
+
1934
+ ---
1935
+
1936
+ ##### `cdkVersionPinning`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.cdkVersionPinning"></a>
1937
+
1938
+ ```typescript
1939
+ public readonly cdkVersionPinning: boolean;
1940
+ ```
1941
+
1942
+ - *Type:* `boolean`
1943
+ - *Default:* false
1944
+
1945
+ Use pinned version instead of caret version for CDK.
1946
+
1947
+ You can use this to prevent yarn to mix versions for your CDK dependencies and to prevent auto-updates. If you use experimental features this will let you define the moment you include breaking changes.
1948
+
1949
+ ---
1950
+
1951
+ ##### `lambdaAutoDiscover`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.lambdaAutoDiscover"></a>
1952
+
1953
+ ```typescript
1954
+ public readonly lambdaAutoDiscover: boolean;
1955
+ ```
1956
+
1957
+ - *Type:* `boolean`
1958
+ - *Default:* true
1959
+
1960
+ Automatically adds an `awscdk.LambdaFunction` for each `.lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
1961
+
1962
+ ---
1963
+
1964
+ ##### `lambdaOptions`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.lambdaOptions"></a>
1965
+
1966
+ ```typescript
1967
+ public readonly lambdaOptions: LambdaFunctionCommonOptions;
1968
+ ```
1969
+
1970
+ - *Type:* [`projen.awscdk.LambdaFunctionCommonOptions`](#projen.awscdk.LambdaFunctionCommonOptions)
1971
+ - *Default:* default options
1972
+
1973
+ Common options for all AWS Lambda functions.
1974
+
1975
+ ---
1976
+
1977
+ ##### `deployOptions`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions.property.deployOptions"></a>
1978
+
1979
+ ```typescript
1980
+ public readonly deployOptions: DeployOptions;
1981
+ ```
1982
+
1983
+ - *Type:* [`deployable-awscdk-app-ts.DeployOptions`](#deployable-awscdk-app-ts.DeployOptions)
1984
+
1985
+ Deployment options.
1986
+
1987
+ ---
1988
+
1989
+ ### DeployOptions <a name="deployable-awscdk-app-ts.DeployOptions"></a>
1990
+
1991
+ #### Initializer <a name="[object Object].Initializer"></a>
1992
+
1993
+ ```typescript
1994
+ import { DeployOptions } from 'deployable-awscdk-app-ts'
1995
+
1996
+ const deployOptions: DeployOptions = { ... }
1997
+ ```
1998
+
1999
+ ##### `awsCredentials`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployOptions.property.awsCredentials"></a>
2000
+
2001
+ ```typescript
2002
+ public readonly awsCredentials: AWSCredentialsGitHubSecrets | AWSCredentialsValues;
2003
+ ```
2004
+
2005
+ - *Type:* [`deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets`](#deployable-awscdk-app-ts.AWSCredentialsGitHubSecrets) | [`deployable-awscdk-app-ts.AWSCredentialsValues`](#deployable-awscdk-app-ts.AWSCredentialsValues)
2006
+
2007
+ AWS credential details for deployment.
2008
+
2009
+ ---
2010
+
2011
+ ##### `environments`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployOptions.property.environments"></a>
2012
+
2013
+ ```typescript
2014
+ public readonly environments: string[];
2015
+ ```
2016
+
2017
+ - *Type:* `string`[]
2018
+
2019
+ Environment names to deploy to.
2020
+
2021
+ ---
2022
+
2023
+ ##### `stackPattern`<sup>Optional</sup> <a name="deployable-awscdk-app-ts.DeployOptions.property.stackPattern"></a>
2024
+
2025
+ ```typescript
2026
+ public readonly stackPattern: string;
2027
+ ```
2028
+
2029
+ - *Type:* `string`
2030
+
2031
+ Regex for stacks to be deployed.
2032
+
2033
+ if not provided matches all of the stacks in the CDK App.
2034
+
2035
+ ---
2036
+
2037
+ ## Classes <a name="Classes"></a>
2038
+
2039
+ ### DeployableAwsCdkTypeScriptApp <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptApp"></a>
2040
+
2041
+ #### Initializers <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptApp.Initializer"></a>
2042
+
2043
+ ```typescript
2044
+ import { DeployableAwsCdkTypeScriptApp } from 'deployable-awscdk-app-ts'
2045
+
2046
+ new DeployableAwsCdkTypeScriptApp(options: DeployableAwsCdkTypeScriptAppOptions)
2047
+ ```
2048
+
2049
+ ##### `options`<sup>Required</sup> <a name="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptApp.parameter.options"></a>
2050
+
2051
+ - *Type:* [`deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions`](#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppOptions)
2052
+
2053
+ ---
2054
+
2055
+
2056
+
2057
+
2058
+
2059
+