cdk-local 0.46.0 → 0.48.0

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/dist/index.d.ts CHANGED
@@ -1,206 +1,7 @@
1
- import { Command, Option } from "commander";
1
+ import { $t as substituteAgainstStateAsync, At as resetEmbedConfig, Bt as resolveCfnRegion, Dt as StackInfo, Ft as LocalStateSourceOptions, Gt as SsmParameterRef, Ht as LocalStateProvider, It as createLocalStateProvider, Jt as CrossStackResolver, Kt as collectSsmParameterRefs, Lt as isCfnFlagPresent, Mt as ExtraStateProviders, Nt as LocalStateProviderFactory, Ot as CdkLocalEmbedConfig, Pt as LocalStateSourceError, Qt as substituteAgainstState, Rt as rejectExplicitCfnStackWithMultipleStacks, Ut as LocalStateRecord, Vt as resolveCfnStackName, Wt as ResolvedSsmParameters, Xt as StateEnvSubstitutionAudit, Yt as PseudoParameters, Zt as SubstitutionContext, en as substituteEnvVarsFromState, i as CreateLocalStartApiCommandOptions, jt as setEmbedConfig, kt as getEmbedConfig, nn as CloudFormationTemplate, o as createLocalStartApiCommand, qt as resolveSsmParameters, tn as substituteEnvVarsFromStateAsync, zt as resolveCfnFallbackRegion } from "./error-handler-BfysjFFj.js";
2
+ import { Command } from "commander";
2
3
  import { CloudFormationClient } from "@aws-sdk/client-cloudformation";
3
- import { SSMClient } from "@aws-sdk/client-ssm";
4
- import { WebSocket } from "ws";
5
- import { IncomingMessage, Server, ServerResponse } from "node:http";
6
4
 
7
- //#region src/types/resource.d.ts
8
- interface CloudFormationTemplate {
9
- AWSTemplateFormatVersion?: string;
10
- Description?: string;
11
- Parameters?: Record<string, TemplateParameter>;
12
- Resources: Record<string, TemplateResource>;
13
- Outputs?: Record<string, TemplateOutput>;
14
- Conditions?: Record<string, unknown>;
15
- Mappings?: Record<string, unknown>;
16
- Transform?: unknown;
17
- Rules?: Record<string, unknown>;
18
- }
19
- interface TemplateParameter {
20
- Type: string;
21
- Default?: unknown;
22
- Description?: string;
23
- AllowedValues?: unknown[];
24
- AllowedPattern?: string;
25
- ConstraintDescription?: string;
26
- }
27
- interface TemplateResource {
28
- Type: string;
29
- Properties?: Record<string, unknown>;
30
- DependsOn?: string | readonly string[];
31
- Condition?: string;
32
- Metadata?: Record<string, unknown>;
33
- CreationPolicy?: Record<string, unknown>;
34
- UpdatePolicy?: Record<string, unknown>;
35
- DeletionPolicy?: 'Delete' | 'Retain' | 'Snapshot';
36
- UpdateReplacePolicy?: 'Delete' | 'Retain' | 'Snapshot';
37
- }
38
- interface TemplateOutput {
39
- Value: unknown;
40
- Description?: string;
41
- Export?: {
42
- Name: string;
43
- };
44
- }
45
- //#endregion
46
- //#region src/types/state.d.ts
47
- interface ResourceState {
48
- physicalId: string;
49
- resourceType: string;
50
- properties: Record<string, unknown>;
51
- observedProperties?: Record<string, unknown>;
52
- attributes?: Record<string, unknown>;
53
- dependencies?: string[];
54
- metadata?: Record<string, unknown>;
55
- deletionPolicy?: 'Delete' | 'Retain' | 'Snapshot' | 'RetainExceptOnCreate' | undefined;
56
- updateReplacePolicy?: 'Delete' | 'Retain' | 'Snapshot' | 'RetainExceptOnCreate' | undefined;
57
- provisionedBy?: 'sdk' | 'cc-api' | undefined;
58
- }
59
- //#endregion
60
- //#region src/local/state-resolver.d.ts
61
- type StateSubstitutionResult = {
62
- kind: 'literal';
63
- value: string | number | boolean;
64
- } | {
65
- kind: 'unresolved';
66
- reason: string;
67
- };
68
- interface PseudoParameters {
69
- accountId?: string;
70
- region?: string;
71
- partition?: string;
72
- urlSuffix?: string;
73
- }
74
- interface CrossStackResolver {
75
- resolveImport(exportName: string): Promise<string | undefined>;
76
- resolveGetStackOutput(producerStack: string, producerRegion: string, outputName: string): Promise<string | undefined>;
77
- }
78
- interface SubstitutionContext {
79
- resources: Record<string, ResourceState>;
80
- parameters?: Record<string, string>;
81
- sensitiveParameters?: ReadonlySet<string>;
82
- onSensitiveParameterConsumed?: (logicalId: string) => void;
83
- pseudoParameters?: PseudoParameters;
84
- crossStackResolver?: CrossStackResolver;
85
- consumerRegion?: string;
86
- }
87
- declare function substituteAgainstState(value: unknown, contextOrResources: SubstitutionContext | Record<string, ResourceState>): StateSubstitutionResult;
88
- declare function substituteAgainstStateAsync(value: unknown, contextOrResources: SubstitutionContext | Record<string, ResourceState>): Promise<StateSubstitutionResult>;
89
- interface StateEnvSubstitutionAudit {
90
- resolvedKeys: string[];
91
- unresolved: Array<{
92
- key: string;
93
- reason: string;
94
- }>;
95
- sensitiveKeys: string[];
96
- }
97
- declare function substituteEnvVarsFromState(templateEnv: Record<string, unknown> | undefined, contextOrResources: SubstitutionContext | Record<string, ResourceState>): {
98
- env: Record<string, unknown>;
99
- audit: StateEnvSubstitutionAudit;
100
- };
101
- declare function substituteEnvVarsFromStateAsync(templateEnv: Record<string, unknown> | undefined, contextOrResources: SubstitutionContext | Record<string, ResourceState>): Promise<{
102
- env: Record<string, unknown>;
103
- audit: StateEnvSubstitutionAudit;
104
- }>;
105
- //#endregion
106
- //#region src/local/ssm-parameter-resolver.d.ts
107
- interface SsmParameterRef {
108
- logicalId: string;
109
- ssmName: string;
110
- isList: boolean;
111
- }
112
- interface ResolvedSsmParameters {
113
- values: Record<string, string>;
114
- secureStringLogicalIds: string[];
115
- }
116
- declare function collectSsmParameterRefs(template: Pick<CloudFormationTemplate, 'Parameters'> | undefined): SsmParameterRef[];
117
- declare function resolveSsmParameters(client: SSMClient, refs: readonly SsmParameterRef[], label: string): Promise<ResolvedSsmParameters>;
118
- //#endregion
119
- //#region src/local/local-state-provider.d.ts
120
- interface LocalStateRecord {
121
- resources: Record<string, ResourceState>;
122
- outputs: Record<string, string>;
123
- region: string;
124
- }
125
- interface LocalStateProvider {
126
- readonly label: string;
127
- load(stackName: string, synthRegion: string | undefined): Promise<LocalStateRecord | undefined>;
128
- buildCrossStackResolver(consumerRegion: string): Promise<CrossStackResolver | undefined>;
129
- resolveDeployedFunctionEnv?(functionPhysicalId: string): Promise<Record<string, string> | undefined>;
130
- resolveTemplateSsmParameters?(template: CloudFormationTemplate): Promise<ResolvedSsmParameters>;
131
- dispose(): void;
132
- }
133
- //#endregion
134
- //#region src/cli/commands/local-state-source.d.ts
135
- interface LocalStateSourceOptions {
136
- fromCfnStack?: string | boolean;
137
- region?: string;
138
- profile?: string;
139
- stackRegion?: string;
140
- [key: string]: unknown;
141
- }
142
- type LocalStateProviderFactory = (options: LocalStateSourceOptions) => LocalStateProvider;
143
- type ExtraStateProviders = Record<string, LocalStateProviderFactory>;
144
- declare function resolveCfnStackName(fromCfnStack: string | boolean, stackName: string): string;
145
- declare function isCfnFlagPresent(opts: Pick<LocalStateSourceOptions, 'fromCfnStack'>): boolean;
146
- declare function resolveCfnRegion(options: Pick<LocalStateSourceOptions, 'stackRegion' | 'region'>, synthRegion: string | undefined): string;
147
- declare function resolveCfnFallbackRegion(options: Pick<LocalStateSourceOptions, 'fromCfnStack' | 'profile'>, synthRegion: string | undefined): Promise<string | undefined>;
148
- declare class LocalStateSourceError extends Error {
149
- constructor(message: string);
150
- }
151
- declare function rejectExplicitCfnStackWithMultipleStacks(options: Pick<LocalStateSourceOptions, 'fromCfnStack'>, routedStackCount: number): void;
152
- declare function createLocalStateProvider(options: LocalStateSourceOptions, stackName: string, synthRegion: string | undefined, extraStateProviders?: ExtraStateProviders): LocalStateProvider | undefined;
153
- //#endregion
154
- //#region src/local/embed-config.d.ts
155
- interface CdkLocalEmbedConfig {
156
- cliName?: string;
157
- binaryName?: string;
158
- productName?: string;
159
- resourceNamePrefix?: string;
160
- awsBindMountPath?: string;
161
- envPrefix?: string;
162
- sigV4StrictByDefault?: boolean;
163
- sigV4OptFlag?: string;
164
- }
165
- interface ResolvedEmbedConfig {
166
- cliName: string;
167
- binaryName: string;
168
- productName: string;
169
- resourceNamePrefix: string;
170
- awsBindMountPath: string;
171
- envPrefix: string;
172
- sigV4StrictByDefault: boolean;
173
- sigV4OptFlag: string;
174
- }
175
- declare function setEmbedConfig(config?: CdkLocalEmbedConfig): void;
176
- declare function getEmbedConfig(): ResolvedEmbedConfig;
177
- declare function resetEmbedConfig(): void;
178
- //#endregion
179
- //#region src/synthesis/assembly-reader.d.ts
180
- interface StackInfo {
181
- stackName: string;
182
- displayName: string;
183
- artifactId: string;
184
- template: CloudFormationTemplate;
185
- assetManifestPath?: string | undefined;
186
- dependencyNames: string[];
187
- region?: string | undefined;
188
- account?: string | undefined;
189
- terminationProtection?: boolean | undefined;
190
- nestedTemplates?: Record<string, string> | undefined;
191
- }
192
- //#endregion
193
- //#region src/local/lambda-resolver.d.ts
194
- interface ResolvedArnLambdaLayer {
195
- kind: 'arn';
196
- logicalId: string;
197
- arn: string;
198
- region: string;
199
- accountId: string;
200
- name: string;
201
- version: string;
202
- }
203
- //#endregion
204
5
  //#region src/cli/commands/local-invoke.d.ts
205
6
  interface CreateLocalInvokeCommandOptions {
206
7
  extraStateProviders?: ExtraStateProviders;
@@ -208,117 +9,6 @@ interface CreateLocalInvokeCommandOptions {
208
9
  }
209
10
  declare function createLocalInvokeCommand(opts?: CreateLocalInvokeCommandOptions): Command;
210
11
  //#endregion
211
- //#region src/local/intrinsic-image.d.ts
212
- interface ImageResolutionContext {
213
- pseudoParameters?: {
214
- accountId?: string;
215
- region?: string;
216
- partition?: string;
217
- urlSuffix?: string;
218
- };
219
- stateResources?: Record<string, ResourceState>;
220
- stateParameters?: Record<string, string>;
221
- stateSensitiveParameters?: readonly string[];
222
- }
223
- declare function derivePseudoParametersFromRegion(region: string | undefined, accountId?: string): {
224
- accountId?: string;
225
- region: string;
226
- partition: string;
227
- urlSuffix: string;
228
- } | undefined;
229
- type FnJoinResolveOutcome = {
230
- kind: 'not-applicable';
231
- } | {
232
- kind: 'resolved';
233
- uri: string;
234
- } | {
235
- kind: 'needs-state';
236
- repoLogicalId: string;
237
- } | {
238
- kind: 'unsupported-join';
239
- reason: string;
240
- };
241
- declare function tryResolveImageFnJoin(raw: unknown, resources: Record<string, TemplateResource>, context: ImageResolutionContext | undefined): FnJoinResolveOutcome;
242
- declare function substituteImagePlaceholders(flat: string, resources: Record<string, TemplateResource>, context: ImageResolutionContext | undefined): string;
243
- //#endregion
244
- //#region src/local/agentcore-resolver.d.ts
245
- declare const AGENTCORE_RUNTIME_TYPE = "AWS::BedrockAgentCore::Runtime";
246
- declare const AGENTCORE_HTTP_PROTOCOL = "HTTP";
247
- declare const AGENTCORE_MCP_PROTOCOL = "MCP";
248
- interface ResolvedAgentCoreRuntime {
249
- stack: StackInfo;
250
- logicalId: string;
251
- resource: TemplateResource;
252
- containerUri?: string;
253
- codeArtifact?: AgentCoreCodeArtifact;
254
- environmentVariables: Record<string, unknown>;
255
- roleArn?: string;
256
- protocol: string;
257
- jwtAuthorizer?: AgentCoreJwtAuthorizer;
258
- }
259
- interface AgentCoreJwtAuthorizer {
260
- discoveryUrl: string;
261
- allowedAudience?: string[];
262
- allowedClients?: string[];
263
- }
264
- interface AgentCoreCodeArtifact {
265
- runtime: string;
266
- entryPoint: string[];
267
- codeAssetHash: string;
268
- }
269
- declare class AgentCoreResolutionError extends Error {
270
- constructor(message: string);
271
- }
272
- declare function resolveAgentCoreTarget(target: string, stacks: StackInfo[], imageContext?: ImageResolutionContext): ResolvedAgentCoreRuntime;
273
- //#endregion
274
- //#region src/local/agentcore-client.d.ts
275
- declare const AGENTCORE_SESSION_ID_HEADER = "X-Amzn-Bedrock-AgentCore-Runtime-Session-Id";
276
- interface AgentCoreInvokeResult {
277
- status: number;
278
- contentType: string | null;
279
- raw: string;
280
- streamed: boolean;
281
- }
282
- declare function waitForAgentCorePing(host: string, port: number, timeoutMs?: number): Promise<void>;
283
- interface InvokeAgentCoreOptions {
284
- sessionId: string;
285
- timeoutMs: number;
286
- authorization?: string;
287
- onChunk?: (text: string) => void;
288
- }
289
- declare function invokeAgentCore(host: string, port: number, event: unknown, options: InvokeAgentCoreOptions): Promise<AgentCoreInvokeResult>;
290
- //#endregion
291
- //#region src/local/agentcore-mcp-client.d.ts
292
- declare const MCP_CONTAINER_PORT = 8000;
293
- declare const MCP_PATH = "/mcp";
294
- declare const MCP_PROTOCOL_VERSION = "2025-06-18";
295
- interface McpJsonRpcRequest {
296
- method: string;
297
- params?: unknown;
298
- }
299
- interface McpInvokeResult {
300
- ok: boolean;
301
- raw: string;
302
- }
303
- interface McpInvokeOptions {
304
- readyTimeoutMs?: number;
305
- requestTimeoutMs?: number;
306
- fetchImpl?: typeof fetch;
307
- }
308
- declare function mcpInvokeOnce(host: string, port: number, request: McpJsonRpcRequest, options?: McpInvokeOptions): Promise<McpInvokeResult>;
309
- declare function parseSseForJsonRpc(text: string, id: number): unknown;
310
- //#endregion
311
- //#region src/local/env-resolver.d.ts
312
- interface EnvResolutionResult {
313
- resolved: Record<string, string>;
314
- unresolved: string[];
315
- }
316
- interface EnvOverrideFile {
317
- Parameters?: Record<string, string | null>;
318
- [logicalIdOrDisplayPath: string]: Record<string, string | null> | undefined;
319
- }
320
- declare function resolveEnvVars(logicalId: string, displayPath: string | undefined, templateEnv: Record<string, unknown> | undefined, overrides?: EnvOverrideFile): EnvResolutionResult;
321
- //#endregion
322
12
  //#region src/cli/commands/local-invoke-agentcore.d.ts
323
13
  interface CreateLocalInvokeAgentCoreCommandOptions {
324
14
  extraStateProviders?: ExtraStateProviders;
@@ -326,364 +16,6 @@ interface CreateLocalInvokeAgentCoreCommandOptions {
326
16
  }
327
17
  declare function createLocalInvokeAgentCoreCommand(opts?: CreateLocalInvokeAgentCoreCommandOptions): Command;
328
18
  //#endregion
329
- //#region src/cli/config-loader.d.ts
330
- interface CdkWatchConfig {
331
- include: string[];
332
- exclude: string[];
333
- }
334
- declare function resolveWatchConfig(): CdkWatchConfig;
335
- //#endregion
336
- //#region src/local/httpv2-service-integration.d.ts
337
- type SupportedSubtype = 'EventBridge-PutEvents' | 'SQS-SendMessage' | 'SQS-ReceiveMessage' | 'SQS-DeleteMessage' | 'SQS-PurgeQueue' | 'Kinesis-PutRecord' | 'StepFunctions-StartExecution' | 'StepFunctions-StartSyncExecution' | 'StepFunctions-StopExecution' | 'AppConfig-GetConfiguration';
338
- //#endregion
339
- //#region src/local/container-pool.d.ts
340
- interface ContainerHandle {
341
- logicalId: string;
342
- containerId: string;
343
- containerName: string;
344
- hostPort: number;
345
- containerHost: string;
346
- stopLogStream: () => void;
347
- }
348
- interface ContainerPool {
349
- acquire(logicalId: string): Promise<ContainerHandle>;
350
- release(handle: ContainerHandle): void;
351
- dispose(): Promise<void>;
352
- }
353
- //#endregion
354
- //#region src/local/vtl-engine.d.ts
355
- declare class VtlEvaluationError extends Error {
356
- constructor(message: string);
357
- }
358
- //#endregion
359
- //#region src/local/integration-response-selector.d.ts
360
- interface IntegrationResponseEntry {
361
- StatusCode: string;
362
- SelectionPattern?: string;
363
- ResponseParameters?: Record<string, string>;
364
- ResponseTemplates?: Record<string, string>;
365
- ContentHandling?: string;
366
- }
367
- interface SelectedIntegrationResponse {
368
- entry: IntegrationResponseEntry | null;
369
- statusCode: number;
370
- }
371
- declare function selectIntegrationResponse(entries: IntegrationResponseEntry[] | undefined, matchTarget: string, fallbackStatusCode?: number): SelectedIntegrationResponse;
372
- declare function tryParseStatus(raw: unknown): number | undefined;
373
- declare function evaluateResponseParameters(responseParameters: Record<string, string> | undefined, opts?: {
374
- onUnsupported?: (key: string, value: string, reason: string) => void;
375
- }): Record<string, string>;
376
- declare function pickResponseTemplate(responseTemplates: Record<string, string> | undefined, accept: string | undefined): {
377
- template: string;
378
- contentType: string;
379
- } | undefined;
380
- //#endregion
381
- //#region src/local/rest-v1-integrations.d.ts
382
- interface MockIntegrationConfig {
383
- kind: 'mock';
384
- requestTemplate: string | undefined;
385
- responses: IntegrationResponseEntry[];
386
- }
387
- interface HttpProxyIntegrationConfig {
388
- kind: 'http-proxy';
389
- uri: string;
390
- integrationHttpMethod?: string;
391
- requestParameters?: Record<string, string>;
392
- responses: IntegrationResponseEntry[];
393
- }
394
- interface HttpIntegrationConfig {
395
- kind: 'http';
396
- uri: string;
397
- integrationHttpMethod?: string;
398
- requestParameters?: Record<string, string>;
399
- requestTemplates?: Record<string, string>;
400
- responses: IntegrationResponseEntry[];
401
- }
402
- interface AwsLambdaIntegrationConfig {
403
- kind: 'aws-lambda';
404
- lambdaLogicalId: string;
405
- requestTemplates?: Record<string, string>;
406
- responses: IntegrationResponseEntry[];
407
- }
408
- //#endregion
409
- //#region src/local/route-discovery.d.ts
410
- type RestV1IntegrationConfig = MockIntegrationConfig | HttpProxyIntegrationConfig | HttpIntegrationConfig | AwsLambdaIntegrationConfig;
411
- interface DiscoveredRoute {
412
- method: string;
413
- pathPattern: string;
414
- lambdaLogicalId: string;
415
- source: 'http-api' | 'rest-v1' | 'function-url';
416
- apiVersion: 'v1' | 'v2';
417
- stage: string;
418
- apiLogicalId?: string;
419
- apiStackName?: string;
420
- apiCdkPath?: string;
421
- stageVariables?: Record<string, string> | null;
422
- invokeMode?: 'BUFFERED' | 'RESPONSE_STREAM';
423
- unsupported?: {
424
- reason: string;
425
- };
426
- mockCors?: {
427
- statusCode: number;
428
- headers: Record<string, string>;
429
- };
430
- serviceIntegration?: {
431
- subtype: SupportedSubtype;
432
- requestParameters: Readonly<Record<string, unknown>>;
433
- responseParameters?: Readonly<Record<string, Readonly<Record<string, string>>>>;
434
- };
435
- restV1Integration?: RestV1IntegrationConfig;
436
- declaredAt: string;
437
- }
438
- declare function discoverRoutes(stacks: readonly StackInfo[]): DiscoveredRoute[];
439
- //#endregion
440
- //#region src/local/cors-handler.d.ts
441
- interface CorsConfig {
442
- AllowOrigins: string[];
443
- AllowMethods: string[];
444
- AllowHeaders: string[];
445
- ExposeHeaders: string[];
446
- MaxAge?: number;
447
- AllowCredentials?: boolean;
448
- }
449
- declare function buildCorsConfigByApiId(template: CloudFormationTemplate): Map<string, CorsConfig>;
450
- declare function buildCorsConfigFromCloudFrontChain(template: CloudFormationTemplate): Map<string, CorsConfig>;
451
- declare function isFunctionUrlOacFronted(template: CloudFormationTemplate, fnUrlLogicalId: string): boolean;
452
- interface PreflightResponse {
453
- statusCode: number;
454
- headers: Record<string, string>;
455
- }
456
- declare function matchPreflight(req: {
457
- method: string;
458
- headers: Record<string, string[]>;
459
- }, config: CorsConfig): PreflightResponse | null;
460
- declare function applyCorsResponseHeaders(res: ServerResponse, apiLogicalId: string | undefined, corsConfigByApiId: Map<string, CorsConfig>, requestOrigin: string | undefined): void;
461
- //#endregion
462
- //#region src/local/authorizer-resolver.d.ts
463
- interface LambdaTokenAuthorizer {
464
- kind: 'lambda-token';
465
- logicalId: string;
466
- lambdaLogicalId: string;
467
- tokenHeader: string;
468
- resultTtlSeconds: number;
469
- declaredAt: string;
470
- }
471
- interface LambdaRequestAuthorizer {
472
- kind: 'lambda-request';
473
- logicalId: string;
474
- lambdaLogicalId: string;
475
- identitySources: ReadonlyArray<IdentitySourceSelector>;
476
- resultTtlSeconds: number;
477
- apiVersion: 'v1' | 'v2';
478
- declaredAt: string;
479
- }
480
- interface CognitoPoolRef {
481
- userPoolArn: string;
482
- region: string;
483
- userPoolId: string;
484
- }
485
- interface CognitoUserPoolAuthorizer {
486
- kind: 'cognito';
487
- logicalId: string;
488
- pools: ReadonlyArray<CognitoPoolRef>;
489
- userPoolArn: string;
490
- region: string;
491
- userPoolId: string;
492
- declaredAt: string;
493
- }
494
- interface JwtAuthorizer {
495
- kind: 'jwt';
496
- logicalId: string;
497
- issuer: string;
498
- audience: ReadonlyArray<string>;
499
- region?: string;
500
- userPoolId?: string;
501
- declaredAt: string;
502
- }
503
- interface IamAuthorizer {
504
- kind: 'iam';
505
- logicalId: 'AWS_IAM';
506
- declaredAt: string;
507
- oacFronted?: boolean;
508
- }
509
- type AuthorizerInfo = LambdaTokenAuthorizer | LambdaRequestAuthorizer | CognitoUserPoolAuthorizer | JwtAuthorizer | IamAuthorizer;
510
- type IdentitySourceSelector = {
511
- kind: 'header';
512
- name: string;
513
- } | {
514
- kind: 'query';
515
- name: string;
516
- } | {
517
- kind: 'context';
518
- name: string;
519
- } | {
520
- kind: 'stage-variable';
521
- name: string;
522
- };
523
- interface RouteWithAuth {
524
- route: DiscoveredRoute;
525
- authorizer?: AuthorizerInfo;
526
- }
527
- declare function attachAuthorizers(stacks: readonly StackInfo[], routes: readonly DiscoveredRoute[]): RouteWithAuth[];
528
- //#endregion
529
- //#region src/local/authorizer-cache.d.ts
530
- interface CachedAuthorizerResult {
531
- allow: boolean;
532
- principalId?: string;
533
- context?: Record<string, unknown>;
534
- policy?: unknown;
535
- }
536
- interface AuthorizerCache {
537
- get(authorizerLogicalId: string, identityHash: string): CachedAuthorizerResult | undefined;
538
- set(authorizerLogicalId: string, identityHash: string, ttlSeconds: number, result: CachedAuthorizerResult): void;
539
- clear(): void;
540
- size(): number;
541
- }
542
- declare function createAuthorizerCache(opts?: {
543
- now?: () => number;
544
- }): AuthorizerCache;
545
- //#endregion
546
- //#region src/local/cognito-jwt.d.ts
547
- interface JwksKey {
548
- kid: string;
549
- n: string;
550
- e: string;
551
- alg?: string;
552
- kty: string;
553
- use?: string;
554
- }
555
- interface JwksCacheEntry {
556
- byKid: Map<string, JwksKey>;
557
- expiresAt: number;
558
- passThrough: boolean;
559
- }
560
- interface JwksCache {
561
- fetchAndCache(jwksUrl: string): Promise<JwksCacheEntry>;
562
- peek(jwksUrl: string): JwksCacheEntry | undefined;
563
- clear(): void;
564
- }
565
- declare function createJwksCache(opts?: {
566
- fetchImpl?: (url: string) => Promise<{
567
- ok: boolean;
568
- status: number;
569
- text: () => Promise<string>;
570
- }>;
571
- now?: () => number;
572
- ttlMs?: number;
573
- failureTtlMs?: number;
574
- }): JwksCache;
575
- declare function buildCognitoJwksUrl(region: string, userPoolId: string): string;
576
- declare function buildJwksUrlFromIssuer(issuer: string): string;
577
- declare function verifyCognitoJwt(authorizer: CognitoUserPoolAuthorizer, authorizationHeader: string | undefined, jwksCache: JwksCache, opts?: {
578
- now?: () => number;
579
- warned?: Set<string>;
580
- }): Promise<CachedAuthorizerResult & {
581
- identityHash: string | undefined;
582
- ttlSeconds: number;
583
- }>;
584
- declare function verifyJwtAuthorizer(authorizer: JwtAuthorizer, authorizationHeader: string | undefined, jwksCache: JwksCache, opts?: {
585
- now?: () => number;
586
- warned?: Set<string>;
587
- }): Promise<CachedAuthorizerResult & {
588
- identityHash: string | undefined;
589
- ttlSeconds: number;
590
- }>;
591
- interface DiscoveryJwtAuthorizer {
592
- discoveryUrl: string;
593
- allowedAudience?: readonly string[];
594
- allowedClients?: readonly string[];
595
- }
596
- declare function verifyJwtViaDiscovery(authorizer: DiscoveryJwtAuthorizer, authorizationHeader: string | undefined, jwksCache: JwksCache, opts?: {
597
- now?: () => number;
598
- warned?: Set<string>;
599
- fetchImpl?: (url: string) => Promise<{
600
- ok: boolean;
601
- status: number;
602
- text: () => Promise<string>;
603
- }>;
604
- }): Promise<CachedAuthorizerResult & {
605
- identityHash: string | undefined;
606
- ttlSeconds: number;
607
- }>;
608
- //#endregion
609
- //#region src/local/sigv4-verify.d.ts
610
- interface ResolvedCredentials {
611
- accessKeyId: string;
612
- secretAccessKey: string;
613
- sessionToken?: string | undefined;
614
- }
615
- type CredentialsLoader = () => Promise<ResolvedCredentials>;
616
- declare function defaultCredentialsLoader(): CredentialsLoader;
617
- //#endregion
618
- //#region src/local/http-server.d.ts
619
- interface ServerState {
620
- routes: readonly RouteWithAuth[];
621
- pool: ContainerPool;
622
- corsConfigByApiId: Map<string, CorsConfig>;
623
- }
624
- interface StartApiServerOptions {
625
- state: ServerState;
626
- rieTimeoutMs: number;
627
- host: string;
628
- port: number;
629
- authorizerCache?: AuthorizerCache;
630
- jwksCache?: JwksCache;
631
- jwksWarnedUrls?: Set<string>;
632
- mtls?: MtlsServerConfig;
633
- sigV4CredentialsLoader?: CredentialsLoader;
634
- sigV4WarnedForeignIds?: Set<string>;
635
- sigV4Strict?: boolean;
636
- defaultRegion?: string;
637
- preDispatch?: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
638
- }
639
- interface MtlsServerConfig {
640
- caPem: Buffer;
641
- certPem: Buffer;
642
- keyPem: Buffer;
643
- }
644
- interface StartedApiServer {
645
- port: number;
646
- host: string;
647
- scheme: 'http' | 'https';
648
- server: Server;
649
- close: () => Promise<void>;
650
- setServerState: (next: ServerState) => ServerState;
651
- getServerState: () => ServerState;
652
- }
653
- declare function startApiServer(opts: StartApiServerOptions): Promise<StartedApiServer>;
654
- declare function readMtlsMaterialsFromDisk(opts: {
655
- truststorePath: string;
656
- certPath: string;
657
- keyPath: string;
658
- }): MtlsServerConfig;
659
- //#endregion
660
- //#region src/cli/commands/local-start-api.d.ts
661
- interface CreateLocalStartApiCommandOptions {
662
- extraStateProviders?: ExtraStateProviders;
663
- embedConfig?: CdkLocalEmbedConfig;
664
- }
665
- interface WatchPredicates {
666
- ignored: (absPath: string) => boolean;
667
- shouldTrigger: (absPath: string) => boolean;
668
- excludePatterns: string[];
669
- }
670
- declare function createWatchPredicates(args: {
671
- watchRoot: string;
672
- output: string;
673
- watchConfig: CdkWatchConfig;
674
- }): WatchPredicates;
675
- interface ApiTargetSubset {
676
- readonly filtered: RouteWithAuth[];
677
- readonly unmatched: string[];
678
- }
679
- declare function resolveApiTargetSubset(routes: readonly RouteWithAuth[], identifiers: readonly string[], stackNames: readonly string[]): ApiTargetSubset;
680
- declare function createLocalStartApiCommand(opts?: CreateLocalStartApiCommandOptions): Command;
681
- //#endregion
682
- //#region src/local/ecs-task-resolver.d.ts
683
- declare class EcsTaskResolutionError extends Error {
684
- constructor(message: string);
685
- }
686
- //#endregion
687
19
  //#region src/cli/commands/local-run-task.d.ts
688
20
  interface CreateLocalRunTaskCommandOptions {
689
21
  extraStateProviders?: ExtraStateProviders;
@@ -691,16 +23,6 @@ interface CreateLocalRunTaskCommandOptions {
691
23
  }
692
24
  declare function createLocalRunTaskCommand(opts?: CreateLocalRunTaskCommandOptions): Command;
693
25
  //#endregion
694
- //#region src/utils/error-handler.d.ts
695
- declare class CdkLocalError extends Error {
696
- readonly code: string;
697
- readonly cause: Error | undefined;
698
- constructor(message: string, code: string, cause?: Error);
699
- }
700
- declare class LocalInvokeBuildError extends CdkLocalError {
701
- constructor(message: string, cause?: Error);
702
- }
703
- //#endregion
704
26
  //#region src/local/target-lister.d.ts
705
27
  interface TargetEntry {
706
28
  logicalId: string;
@@ -770,441 +92,5 @@ declare class CfnLocalStateProvider implements LocalStateProvider {
770
92
  dispose(): void;
771
93
  }
772
94
  //#endregion
773
- //#region src/local/intrinsic-utils.d.ts
774
- declare function pickRefLogicalId(value: unknown): string | null;
775
- //#endregion
776
- //#region src/local/intrinsic-lambda-arn.d.ts
777
- type LambdaArnResolveOutcome = {
778
- kind: 'resolved';
779
- logicalId: string;
780
- } | {
781
- kind: 'unsupported';
782
- detail: string;
783
- };
784
- declare function resolveLambdaArnIntrinsic(value: unknown): LambdaArnResolveOutcome;
785
- //#endregion
786
- //#region src/local/parameter-mapping.d.ts
787
- interface RequestParameterContext {
788
- headers: Readonly<Record<string, string>>;
789
- queryString: Readonly<Record<string, string>>;
790
- pathParameters: Readonly<Record<string, string>>;
791
- requestPath: string;
792
- body: string;
793
- context: Readonly<Record<string, string>>;
794
- stageVariables: Readonly<Record<string, string>>;
795
- authorizer?: Readonly<Record<string, unknown>>;
796
- }
797
- type ResolveParametersOutcome = {
798
- kind: 'ok';
799
- resolved: Record<string, string>;
800
- } | {
801
- kind: 'error';
802
- reason: string;
803
- };
804
- declare function resolveServiceIntegrationParameters(parameters: Readonly<Record<string, unknown>>, ctx: RequestParameterContext): ResolveParametersOutcome;
805
- declare function resolveSelectionExpression(input: string, ctx: RequestParameterContext): string;
806
- //#endregion
807
- //#region src/local/api-gateway-response.d.ts
808
- interface TranslatedHttpResponse {
809
- statusCode: number;
810
- headers: Record<string, string>;
811
- cookies: string[];
812
- body: Buffer;
813
- }
814
- declare function translateLambdaResponse(payload: unknown, version: 'v1' | 'v2'): TranslatedHttpResponse;
815
- //#endregion
816
- //#region src/local/docker-inspect.d.ts
817
- declare function getContainerNetworkIp(containerId: string, networkName: string): Promise<string | undefined>;
818
- //#endregion
819
- //#region src/local/route-matcher.d.ts
820
- interface RouteMatchResult {
821
- route: DiscoveredRoute;
822
- pathParameters: Record<string, string>;
823
- }
824
- declare function matchRoute(method: string, requestPath: string, routes: readonly DiscoveredRoute[]): RouteMatchResult | null;
825
- //#endregion
826
- //#region src/local/api-gateway-event.d.ts
827
- interface HttpRequestSnapshot {
828
- method: string;
829
- rawUrl: string;
830
- headers: Record<string, string[]>;
831
- body: Buffer;
832
- sourceIp?: string;
833
- clientCert?: Record<string, unknown>;
834
- }
835
- interface MatchedRouteContext {
836
- route: DiscoveredRoute;
837
- pathParameters: Record<string, string>;
838
- matchedPath: string;
839
- }
840
- declare function buildHttpApiV2Event(req: HttpRequestSnapshot, ctx: MatchedRouteContext, opts?: {
841
- now?: () => Date;
842
- }): Record<string, unknown>;
843
- declare function buildRestV1Event(req: HttpRequestSnapshot, ctx: MatchedRouteContext, opts?: {
844
- now?: () => Date;
845
- }): Record<string, unknown>;
846
- type AuthorizerEventOverlay = {
847
- kind: 'lambda-rest-v1';
848
- principalId?: string;
849
- context?: Record<string, unknown>;
850
- } | {
851
- kind: 'lambda-http-v2';
852
- principalId?: string;
853
- context?: Record<string, unknown>;
854
- } | {
855
- kind: 'cognito-rest-v1';
856
- claims: Record<string, unknown>;
857
- } | {
858
- kind: 'jwt-http-v2';
859
- claims: Record<string, unknown>;
860
- scopes?: string[];
861
- };
862
- declare function applyAuthorizerOverlay(event: Record<string, unknown>, overlay: AuthorizerEventOverlay): Record<string, unknown>;
863
- //#endregion
864
- //#region src/local/websocket-route-discovery.d.ts
865
- interface DiscoveredWebSocketApi {
866
- apiLogicalId: string;
867
- apiStackName: string;
868
- declaredAt: string;
869
- apiCdkPath?: string;
870
- routeSelectionExpression: string;
871
- stage: string;
872
- routes: WebSocketRouteEntry[];
873
- unsupported?: {
874
- reason: string;
875
- };
876
- }
877
- interface WebSocketRouteEntry {
878
- routeKey: string;
879
- targetLambdaLogicalId: string;
880
- lambdaStackName: string;
881
- declaredAt: string;
882
- }
883
- declare function discoverWebSocketApis(stacks: readonly StackInfo[]): {
884
- apis: DiscoveredWebSocketApi[];
885
- errors: string[];
886
- };
887
- declare function discoverWebSocketApisOrThrow(stacks: readonly StackInfo[]): DiscoveredWebSocketApi[];
888
- declare function parseSelectionExpressionPath(expr: string): string[];
889
- //#endregion
890
- //#region src/local/lambda-authorizer.d.ts
891
- interface RequestSnapshotForAuthorizer {
892
- method: string;
893
- headers: Record<string, string>;
894
- queryStringParameters: Record<string, string>;
895
- pathParameters: Record<string, string>;
896
- sourceIp: string;
897
- matchedPath: string;
898
- stage: string;
899
- }
900
- interface AuthorizerInvocationContext {
901
- pool: ContainerPool;
902
- rieTimeoutMs: number;
903
- methodArn: string;
904
- mockAccountId: string;
905
- mockApiId: string;
906
- }
907
- declare function buildMethodArn(opts: {
908
- apiId: string;
909
- accountId: string;
910
- region?: string;
911
- stage: string;
912
- method: string;
913
- path: string;
914
- }): string;
915
- declare function invokeTokenAuthorizer(authorizer: LambdaTokenAuthorizer, request: RequestSnapshotForAuthorizer, ctx: AuthorizerInvocationContext): Promise<CachedAuthorizerResult & {
916
- identityHash: string | undefined;
917
- }>;
918
- declare function invokeRequestAuthorizer(authorizer: LambdaRequestAuthorizer, request: RequestSnapshotForAuthorizer, ctx: AuthorizerInvocationContext): Promise<CachedAuthorizerResult & {
919
- identityHash: string | undefined;
920
- }>;
921
- declare function computeRequestIdentityHash(authorizer: LambdaRequestAuthorizer, request: RequestSnapshotForAuthorizer): {
922
- identityHash: string;
923
- missing: boolean;
924
- };
925
- declare function evaluateCachedLambdaPolicy(cached: CachedAuthorizerResult, methodArn: string): CachedAuthorizerResult;
926
- //#endregion
927
- //#region src/local/stage-resolver.d.ts
928
- interface ResolvedStage {
929
- stageLogicalId: string;
930
- stageName: string;
931
- apiVersion: 'v1' | 'v2';
932
- variables: Record<string, string> | null;
933
- }
934
- declare function buildStageMap(template: CloudFormationTemplate, stageOverride?: string): Map<string, ResolvedStage>;
935
- declare function attachStageContext(routes: DiscoveredRoute[], stageMap: Map<string, ResolvedStage>): void;
936
- //#endregion
937
- //#region src/local/cloud-map-registry.d.ts
938
- interface RegisteredEndpoint {
939
- ip: string;
940
- port: number;
941
- ownerKey: string;
942
- }
943
- interface RegistrationHandle {
944
- readonly fqdn: string;
945
- readonly ownerKey: string;
946
- }
947
- interface RegistryListing {
948
- namespace: string;
949
- discoveryName: string;
950
- endpoints: ReadonlyArray<RegisteredEndpoint>;
951
- isAlias: boolean;
952
- }
953
- declare class CloudMapRegistry {
954
- private readonly byFqdn;
955
- private readonly aliasIndex;
956
- register(namespace: string, discoveryName: string, endpoint: RegisteredEndpoint): RegistrationHandle;
957
- registerAlias(alias: string, targetFqdn: string): void;
958
- unregister(handle: RegistrationHandle): boolean;
959
- unregisterByOwner(ownerKeyPrefix: string): number;
960
- lookup(namespace: string, discoveryName: string): ReadonlyArray<RegisteredEndpoint> | undefined;
961
- lookupAlias(alias: string): ReadonlyArray<RegisteredEndpoint> | undefined;
962
- buildAddHostFlags(excludeOwnerKeyPrefix?: string): string[];
963
- list(): ReadonlyArray<RegistryListing>;
964
- isEmpty(): boolean;
965
- }
966
- //#endregion
967
- //#region src/local/runtime-image.d.ts
968
- declare function resolveRuntimeImage(runtime: string): string;
969
- declare function resolveRuntimeFileExtension(runtime: string): string;
970
- declare function resolveRuntimeCodeMountPath(runtime: string): string;
971
- //#endregion
972
- //#region src/local/websocket-event.d.ts
973
- interface WebSocketHandshakeSnapshot {
974
- headers: Record<string, string[]>;
975
- rawQueryString: string;
976
- queryStringParameters?: Record<string, string>;
977
- multiValueQueryStringParameters?: Record<string, string[]>;
978
- sourceIp?: string;
979
- userAgent?: string;
980
- }
981
- interface WebSocketRequestContextBase {
982
- routeKey: string;
983
- eventType: 'CONNECT' | 'MESSAGE' | 'DISCONNECT';
984
- connectionId: string;
985
- extendedRequestId: string;
986
- requestTime: string;
987
- requestTimeEpoch: number;
988
- messageDirection: 'IN';
989
- stage: string;
990
- connectedAt: number;
991
- requestId: string;
992
- domainName: string;
993
- apiId: string;
994
- authorizer: null;
995
- identity: {
996
- accountId: string;
997
- sourceIp: string;
998
- userAgent: string;
999
- };
1000
- }
1001
- interface WebSocketLambdaEvent {
1002
- headers?: Record<string, string>;
1003
- multiValueHeaders?: Record<string, string[]>;
1004
- queryStringParameters?: Record<string, string> | null;
1005
- multiValueQueryStringParameters?: Record<string, string[]> | null;
1006
- requestContext: WebSocketRequestContextBase & Record<string, unknown>;
1007
- isBase64Encoded: boolean;
1008
- body: string;
1009
- }
1010
- declare function buildConnectEvent(opts: {
1011
- connectionId: string;
1012
- connectedAt: number;
1013
- stage: string;
1014
- snapshot: WebSocketHandshakeSnapshot;
1015
- }): WebSocketLambdaEvent;
1016
- declare function buildMessageEvent(opts: {
1017
- connectionId: string;
1018
- connectedAt: number;
1019
- stage: string;
1020
- snapshot: WebSocketHandshakeSnapshot;
1021
- routeKey: string;
1022
- body: string;
1023
- isBase64Encoded: boolean;
1024
- }): WebSocketLambdaEvent;
1025
- declare function buildDisconnectEvent(opts: {
1026
- connectionId: string;
1027
- connectedAt: number;
1028
- stage: string;
1029
- snapshot: WebSocketHandshakeSnapshot;
1030
- disconnectStatusCode?: number;
1031
- disconnectReason?: string;
1032
- }): WebSocketLambdaEvent;
1033
- //#endregion
1034
- //#region src/local/websocket-mgmt-api.d.ts
1035
- interface ConnectionRegistryEntry {
1036
- connectionId: string;
1037
- socket: WebSocket;
1038
- connectedAt: number;
1039
- apiLogicalId: string;
1040
- stage: string;
1041
- }
1042
- declare class ConnectionRegistry {
1043
- private readonly entries;
1044
- register(entry: ConnectionRegistryEntry): void;
1045
- unregister(connectionId: string): ConnectionRegistryEntry | undefined;
1046
- get(connectionId: string): ConnectionRegistryEntry | undefined;
1047
- size(): number;
1048
- list(): ConnectionRegistryEntry[];
1049
- clear(): void;
1050
- }
1051
- declare function parseConnectionsPath(url: string): {
1052
- connectionId: string;
1053
- } | null;
1054
- declare function buildMgmtEndpointEnvUrl(host: string, port: number, stage: string): string;
1055
- declare function handleConnectionsRequest(opts: {
1056
- req: IncomingMessage;
1057
- res: ServerResponse;
1058
- registry: ConnectionRegistry;
1059
- }): Promise<void>;
1060
- //#endregion
1061
- //#region src/local/websocket-body.d.ts
1062
- declare function bufferToBody(raw: Buffer | ArrayBuffer | Buffer[], isBinary: boolean): {
1063
- body: string;
1064
- isBase64Encoded: boolean;
1065
- };
1066
- //#endregion
1067
- //#region src/local/docker-version.d.ts
1068
- declare const HOST_GATEWAY_MIN_VERSION: ParsedDockerVersion;
1069
- interface ParsedDockerVersion {
1070
- major: number;
1071
- minor: number;
1072
- patch: number;
1073
- }
1074
- interface HostGatewayProbeResult {
1075
- rawVersion: string;
1076
- parsed: ParsedDockerVersion | null;
1077
- supported: boolean;
1078
- }
1079
- declare function probeHostGatewaySupport(): Promise<HostGatewayProbeResult>;
1080
- //#endregion
1081
- //#region src/local/api-server-grouping.d.ts
1082
- interface ApiServerGroup {
1083
- readonly serverKey: string;
1084
- readonly displayName: string;
1085
- readonly kind: 'rest-v1' | 'http-api' | 'function-url' | 'websocket';
1086
- readonly identifier: string;
1087
- readonly routes: readonly RouteWithAuth[];
1088
- }
1089
- declare function groupRoutesByServer(routes: readonly RouteWithAuth[]): ApiServerGroup[];
1090
- declare function filterRoutesByApiIdentifier(routes: readonly RouteWithAuth[], identifier: string): RouteWithAuth[];
1091
- declare function filterRoutesByApiIdentifiers(routes: readonly RouteWithAuth[], identifiers: readonly string[]): RouteWithAuth[];
1092
- declare function availableApiIdentifiers(routes: readonly RouteWithAuth[]): string[];
1093
- //#endregion
1094
- //#region src/local/layer-arn-materializer.d.ts
1095
- interface MaterializeLayerOptions {
1096
- roleArn?: string;
1097
- lambdaClientFactory?: (region: string, credentials?: AwsCredentials) => LambdaSendClient;
1098
- stsClientFactory?: (region: string) => StsSendClient;
1099
- fetchZip?: (presignedUrl: string) => Promise<Uint8Array>;
1100
- }
1101
- interface AwsCredentials {
1102
- accessKeyId: string;
1103
- secretAccessKey: string;
1104
- sessionToken?: string;
1105
- }
1106
- interface LambdaSendClient {
1107
- send(command: any): Promise<{
1108
- Content?: {
1109
- Location?: string;
1110
- };
1111
- }>;
1112
- destroy?: () => void;
1113
- }
1114
- interface StsSendClient {
1115
- send(command: any): Promise<{
1116
- Credentials?: {
1117
- AccessKeyId?: string;
1118
- SecretAccessKey?: string;
1119
- SessionToken?: string;
1120
- };
1121
- }>;
1122
- destroy?: () => void;
1123
- }
1124
- declare function materializeLayerFromArn(layer: ResolvedArnLambdaLayer, options?: MaterializeLayerOptions): Promise<string>;
1125
- //#endregion
1126
- //#region src/local/cloud-map-resolver.d.ts
1127
- interface ResolvedCloudMapNamespace {
1128
- logicalId: string;
1129
- name: string;
1130
- }
1131
- interface ResolvedCloudMapService {
1132
- logicalId: string;
1133
- namespaceLogicalId: string;
1134
- namespaceName: string;
1135
- name: string;
1136
- dnsRecords: ReadonlyArray<{
1137
- type: 'A' | 'SRV';
1138
- ttlSeconds: number;
1139
- }>;
1140
- }
1141
- interface CloudMapIndex {
1142
- namespacesByLogicalId: Map<string, ResolvedCloudMapNamespace>;
1143
- namespacesByName: Map<string, ResolvedCloudMapNamespace>;
1144
- servicesByLogicalId: Map<string, ResolvedCloudMapService>;
1145
- warnings: string[];
1146
- }
1147
- declare function buildCloudMapIndex(stack: StackInfo): CloudMapIndex;
1148
- //#endregion
1149
- //#region src/local/agentcore-code-build.d.ts
1150
- declare const SUPPORTED_CODE_RUNTIMES: string[];
1151
- interface BuildAgentCoreCodeImageOptions {
1152
- sourceDir: string;
1153
- runtime: string;
1154
- entryPoint: string[];
1155
- architecture: 'x86_64' | 'arm64';
1156
- noBuild?: boolean;
1157
- }
1158
- declare function buildAgentCoreCodeImage(options: BuildAgentCoreCodeImageOptions): Promise<string>;
1159
- declare function renderCodeDockerfile(base: string, entryPoint: string[], isNode: boolean): string;
1160
- declare function toCmdArgv(entryPoint: string[], isNode: boolean): string[];
1161
- declare function computeCodeImageTag(sourceDir: string, runtime: string, entryPoint: string[], dockerfile: string): string;
1162
- //#endregion
1163
- //#region src/types/assets.d.ts
1164
- interface DockerImageAssetSource {
1165
- directory?: string;
1166
- executable?: string[];
1167
- dockerFile?: string;
1168
- dockerBuildTarget?: string;
1169
- dockerBuildArgs?: Record<string, string>;
1170
- dockerBuildContexts?: Record<string, string>;
1171
- dockerBuildSsh?: string;
1172
- dockerBuildSecrets?: Record<string, string>;
1173
- networkMode?: string;
1174
- platform?: string;
1175
- dockerOutputs?: string[];
1176
- cacheFrom?: DockerCacheOption[];
1177
- cacheTo?: DockerCacheOption;
1178
- cacheDisabled?: boolean;
1179
- }
1180
- interface DockerCacheOption {
1181
- type: string;
1182
- params?: Record<string, string>;
1183
- }
1184
- //#endregion
1185
- //#region src/local/docker-image-builder.d.ts
1186
- interface BuildContainerImageOptions {
1187
- architecture: 'x86_64' | 'arm64';
1188
- noBuild?: boolean;
1189
- }
1190
- declare function buildContainerImage(asset: {
1191
- source: DockerImageAssetSource;
1192
- }, cdkOutDir: string, options: BuildContainerImageOptions): Promise<string>;
1193
- declare function architectureToPlatform(architecture: 'x86_64' | 'arm64'): string;
1194
- //#endregion
1195
- //#region src/local/file-watcher.d.ts
1196
- interface FileWatcher {
1197
- close(): Promise<void>;
1198
- }
1199
- interface FileWatcherOptions {
1200
- paths: readonly string[];
1201
- onChange: () => void;
1202
- debounceMs?: number;
1203
- ignoreInitial?: boolean;
1204
- ignored?: (path: string) => boolean;
1205
- shouldTrigger?: (path: string) => boolean;
1206
- }
1207
- declare function createFileWatcher(options: FileWatcherOptions): FileWatcher;
1208
- //#endregion
1209
- export { AGENTCORE_HTTP_PROTOCOL, AGENTCORE_MCP_PROTOCOL, AGENTCORE_RUNTIME_TYPE, AGENTCORE_SESSION_ID_HEADER, type AgentCoreCodeArtifact, type AgentCoreInvokeResult, type AgentCoreJwtAuthorizer, AgentCoreResolutionError, type ApiServerGroup, type ApiTargetSubset, type AuthorizerCache, type AuthorizerEventOverlay, type AuthorizerInfo, type BuildAgentCoreCodeImageOptions, type BuildContainerImageOptions, type CachedAuthorizerResult, type CdkLocalEmbedConfig, type CdkWatchConfig, CfnLocalStateProvider, type CfnLocalStateProviderOptions, type CloudMapIndex, CloudMapRegistry, ConnectionRegistry, type ConnectionRegistryEntry, type CorsConfig, type CreateLocalInvokeAgentCoreCommandOptions, type CreateLocalInvokeCommandOptions, type CreateLocalListCommandOptions, type CreateLocalRunTaskCommandOptions, type CreateLocalStartAlbCommandOptions, type CreateLocalStartApiCommandOptions, type CreateLocalStartServiceCommandOptions, type CredentialsLoader, type CrossStackResolver, type DiscoveredRoute, type DiscoveredWebSocketApi, type DiscoveryJwtAuthorizer, EcsTaskResolutionError, type EnvOverrideFile, type ExtraStateProviders, type FileWatcher, type FileWatcherOptions, type FormatTargetListingOptions, HOST_GATEWAY_MIN_VERSION, type HttpRequestSnapshot, type ImageResolutionContext, type IntegrationResponseEntry, type InvokeAgentCoreOptions, type JwksCache, type LambdaArnResolveOutcome, LocalInvokeBuildError, type LocalStateProvider, type LocalStateProviderFactory, type LocalStateRecord, LocalStateSourceError, type LocalStateSourceOptions, MCP_CONTAINER_PORT, MCP_PATH, MCP_PROTOCOL_VERSION, type MatchedRouteContext, type McpInvokeOptions, type McpInvokeResult, type McpJsonRpcRequest, type MtlsServerConfig, type PseudoParameters, type RegistrationHandle, type RequestParameterContext, type ResolveParametersOutcome, type ResolvedAgentCoreRuntime, type ResolvedSsmParameters, type ResolvedStage, type RestV1IntegrationConfig, type RouteMatchResult, type RouteWithAuth, SUPPORTED_CODE_RUNTIMES, type ServerState, type SsmParameterRef, type StartedApiServer, type StateEnvSubstitutionAudit, type SubstitutionContext, type TargetEntry, type TargetListing, type TranslatedHttpResponse, VtlEvaluationError, type WatchPredicates, type WebSocketHandshakeSnapshot, type WebSocketLambdaEvent, type WebSocketRouteEntry, applyAuthorizerOverlay, applyCorsResponseHeaders, architectureToPlatform, attachAuthorizers, attachStageContext, availableApiIdentifiers, bufferToBody, buildAgentCoreCodeImage, buildCloudMapIndex, buildCognitoJwksUrl, buildConnectEvent, buildContainerImage, buildCorsConfigByApiId, buildCorsConfigFromCloudFrontChain, buildDisconnectEvent, buildHttpApiV2Event, buildJwksUrlFromIssuer, buildMessageEvent, buildMethodArn, buildMgmtEndpointEnvUrl, buildRestV1Event, buildStageMap, collectSsmParameterRefs, computeCodeImageTag, computeRequestIdentityHash, countTargets, createAuthorizerCache, createFileWatcher, createJwksCache, createLocalInvokeAgentCoreCommand, createLocalInvokeCommand, createLocalListCommand, createLocalRunTaskCommand, createLocalStartAlbCommand, createLocalStartApiCommand, createLocalStartServiceCommand, createLocalStateProvider, createWatchPredicates, defaultCredentialsLoader, derivePseudoParametersFromRegion, discoverRoutes, discoverWebSocketApis, discoverWebSocketApisOrThrow, evaluateCachedLambdaPolicy, evaluateResponseParameters, filterRoutesByApiIdentifier, filterRoutesByApiIdentifiers, formatTargetListing, getContainerNetworkIp, getEmbedConfig, groupRoutesByServer, handleConnectionsRequest, invokeAgentCore, invokeRequestAuthorizer, invokeTokenAuthorizer, isCfnFlagPresent, isFunctionUrlOacFronted, listTargets, matchPreflight, matchRoute, materializeLayerFromArn, mcpInvokeOnce, parseConnectionsPath, parseSelectionExpressionPath, parseSseForJsonRpc, pickRefLogicalId, pickResponseTemplate, probeHostGatewaySupport, readMtlsMaterialsFromDisk, rejectExplicitCfnStackWithMultipleStacks, renderCodeDockerfile, resetEmbedConfig, resolveAgentCoreTarget, resolveApiTargetSubset, resolveCfnFallbackRegion, resolveCfnRegion, resolveCfnStackName, resolveEnvVars, resolveLambdaArnIntrinsic, resolveRuntimeCodeMountPath, resolveRuntimeFileExtension, resolveRuntimeImage, resolveSelectionExpression, resolveServiceIntegrationParameters, resolveSsmParameters, resolveWatchConfig, selectIntegrationResponse, setEmbedConfig, startApiServer, substituteAgainstState, substituteAgainstStateAsync, substituteEnvVarsFromState, substituteEnvVarsFromStateAsync, substituteImagePlaceholders, toCmdArgv, translateLambdaResponse, tryParseStatus, tryResolveImageFnJoin, verifyCognitoJwt, verifyJwtAuthorizer, verifyJwtViaDiscovery, waitForAgentCorePing };
95
+ export { type CdkLocalEmbedConfig, CfnLocalStateProvider, type CfnLocalStateProviderOptions, type CreateLocalInvokeAgentCoreCommandOptions, type CreateLocalInvokeCommandOptions, type CreateLocalListCommandOptions, type CreateLocalRunTaskCommandOptions, type CreateLocalStartAlbCommandOptions, type CreateLocalStartApiCommandOptions, type CreateLocalStartServiceCommandOptions, type CrossStackResolver, type ExtraStateProviders, type FormatTargetListingOptions, type LocalStateProvider, type LocalStateProviderFactory, type LocalStateRecord, LocalStateSourceError, type LocalStateSourceOptions, type PseudoParameters, type ResolvedSsmParameters, type SsmParameterRef, type StateEnvSubstitutionAudit, type SubstitutionContext, type TargetEntry, type TargetListing, collectSsmParameterRefs, countTargets, createLocalInvokeAgentCoreCommand, createLocalInvokeCommand, createLocalListCommand, createLocalRunTaskCommand, createLocalStartAlbCommand, createLocalStartApiCommand, createLocalStartServiceCommand, createLocalStateProvider, formatTargetListing, getEmbedConfig, isCfnFlagPresent, listTargets, rejectExplicitCfnStackWithMultipleStacks, resetEmbedConfig, resolveCfnFallbackRegion, resolveCfnRegion, resolveCfnStackName, resolveSsmParameters, setEmbedConfig, substituteAgainstState, substituteAgainstStateAsync, substituteEnvVarsFromState, substituteEnvVarsFromStateAsync };
1210
96
  //# sourceMappingURL=index.d.ts.map