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/.gitattributes +22 -0
- package/.jsii +408 -0
- package/.nvmrc +1 -0
- package/.projenrc.ts +55 -0
- package/API.md +2059 -0
- package/LICENSE +202 -0
- package/README.md +42 -0
- package/lib/index.d.ts +14 -0
- package/lib/index.js +73 -0
- package/lib/steps.d.ts +7 -0
- package/lib/steps.js +73 -0
- package/lib/types.d.ts +99 -0
- package/lib/types.js +3 -0
- package/package.json +127 -0
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
|
+
|