@sst-community/sst 4.21.1 → 5.0.0-alpha.2

package/platform/types/components/aws/v5/alb.d.ts

@@ -0,0 +1,177 @@
+import { ComponentResourceOptions, type Output } from "@pulumi/pulumi";
+import { lb } from "@pulumi/aws";
+import { V5Args } from "../../parts-component";
+import type { Input } from "../../input";
+import { DnsValidatedCertificate } from "../dns-validated-certificate";
+import { type TakesVpc } from "../helpers/vpc";
+import type { AlbArgs as OriginalAlbArgs } from "../alb";
+declare const parts: () => {
+    /**
+     * The AWS Security Group of the load balancer.
+     */
+    securityGroup: typeof import("@pulumi/aws/ec2/securityGroup").SecurityGroup;
+    /**
+     * The certificate of the custom domain. Only created when there's a `domain` without
+     * a `cert` of its own.
+     */
+    certificate: import("../..").OptionalPart<typeof DnsValidatedCertificate>;
+    /**
+     * The AWS Load Balancer.
+     */
+    loadBalancer: typeof import("@pulumi/aws/lb/loadBalancer").LoadBalancer;
+    /**
+     * The AWS Load Balancer listeners, by protocol and port: `HTTPS443`. A listener that
+     * `getListener` looks up is added when it's asked for.
+     */
+    listener: import("../..").ManyPart<typeof import("@pulumi/aws/lb/listener").Listener>;
+};
+export interface AlbArgs extends V5Args<TakesVpc<OriginalAlbArgs>, typeof parts> {
+}
+declare const Alb_base: import("../..").ComponentClass<{
+    /**
+     * The AWS Security Group of the load balancer.
+     */
+    securityGroup: typeof import("@pulumi/aws/ec2/securityGroup").SecurityGroup;
+    /**
+     * The certificate of the custom domain. Only created when there's a `domain` without
+     * a `cert` of its own.
+     */
+    certificate: import("../..").OptionalPart<typeof DnsValidatedCertificate>;
+    /**
+     * The AWS Load Balancer.
+     */
+    loadBalancer: typeof import("@pulumi/aws/lb/loadBalancer").LoadBalancer;
+    /**
+     * The AWS Load Balancer listeners, by protocol and port: `HTTPS443`. A listener that
+     * `getListener` looks up is added when it's asked for.
+     */
+    listener: import("../..").ManyPart<typeof import("@pulumi/aws/lb/listener").Listener>;
+}>;
+/**
+ * The `Alb` component lets you create a standalone Application Load Balancer that can be
+ * shared across multiple services.
+ *
+ * It takes the same args as [`sst.aws.Alb`](/docs/component/aws/alb) and creates the same
+ * resources. It's built from parts, so every resource it creates can be transformed, is
+ * available in `nodes`, and can be swapped for one you already have.
+ *
+ * @example
+ *
+ * #### Create a shared ALB
+ *
+ * ```ts title="sst.config.ts"
+ * const vpc = new sst.aws.Vpc("MyVpc");
+ *
+ * const alb = new sst.aws.v5.Alb("SharedAlb", {
+ *   vpc,
+ *   domain: "app.example.com",
+ *   listeners: [
+ *     { port: 80, protocol: "http" },
+ *     { port: 443, protocol: "https" },
+ *   ],
+ * });
+ * ```
+ *
+ * #### Attach services to the ALB
+ *
+ * ```ts title="sst.config.ts"
+ * new sst.aws.v5.Service("Api", {
+ *   cluster,
+ *   image: "api:latest",
+ *   loadBalancer: {
+ *     instance: alb,
+ *     rules: [
+ *       { listen: "443/https", forward: "8080/http", conditions: { path: "/api/*" }, priority: 100 },
+ *     ],
+ *   },
+ * });
+ * ```
+ *
+ * #### Reference an existing ALB
+ *
+ * ```ts title="sst.config.ts"
+ * const alb = sst.aws.v5.Alb.get("SharedAlb", "arn:aws:elasticloadbalancing:...");
+ * ```
+ *
+ * #### Switch from `sst.aws.Alb`
+ *
+ * Change `sst.aws.Alb` to `sst.aws.v5.Alb` and keep the name. The load balancer, its
+ * security group, listeners, certificate and DNS records are kept.
+ *
+ * ```ts title="sst.config.ts" del={1} ins={2}
+ * const alb = new sst.aws.Alb("SharedAlb", { vpc, listeners });
+ * const alb = new sst.aws.v5.Alb("SharedAlb", { vpc, listeners });
+ * ```
+ *
+ * A few things work differently:
+ *
+ * - Switch the services on the load balancer first, or along with it. A
+ *   `sst.aws.v5.Service` takes either one. A
+ *   [`sst.aws.Service`](/docs/component/aws/service) only takes `sst.aws.Alb`.
+ * - `nodes.listeners` is `nodes.listener`. `nodes` also has the certificate, which can
+ *   be transformed.
+ * - A transform function for `listener` is also given the listener's protocol and port:
+ *   `HTTPS443`.
+ * - A `domain` with `dns: false` and no `cert` is refused. There's nothing to validate
+ *   a certificate with.
+ */
+export declare class Alb extends Alb_base {
+    private balancer;
+    constructor(name: string, args: AlbArgs, opts?: ComponentResourceOptions);
+    /**
+     * The URL of the load balancer. If a custom domain is set, this will be the custom
+     * domain URL (eg. `https://app.example.com/`). Otherwise, it's the ALB's DNS name.
+     */
+    get url(): Output<string>;
+    /**
+     * The ARN of the load balancer.
+     */
+    get arn(): Output<string>;
+    /**
+     * The DNS name of the load balancer.
+     */
+    get dnsName(): Output<string>;
+    /**
+     * The zone ID of the load balancer.
+     */
+    get zoneId(): Output<string>;
+    /**
+     * The security group ID of the load balancer.
+     */
+    get securityGroupId(): Output<string>;
+    /** @internal */
+    get _vpc(): Output<string>;
+    /**
+     * Get a specific listener by protocol and port. A listener the component didn't
+     * create is looked up on the load balancer.
+     *
+     * @example
+     * ```ts
+     * const listener = alb.getListener("https", 443);
+     * ```
+     */
+    getListener(protocol: string, port: number): lb.Listener;
+    /**
+     * Linking a load balancer gives the linked resource its URL.
+     */
+    link(): {
+        properties: {
+            url: Output<string>;
+        };
+    };
+    /**
+     * Reference an existing ALB by its ARN.
+     *
+     * @param name The name of the component.
+     * @param loadBalancerArn The ARN of the existing ALB.
+     * @param opts Component resource options.
+     *
+     * @example
+     * ```ts
+     * const alb = sst.aws.v5.Alb.get("SharedAlb", "arn:aws:elasticloadbalancing:...");
+     * ```
+     */
+    static get(name: string, loadBalancerArn: Input<string>, opts?: ComponentResourceOptions): Alb;
+}
+export {};
+//# sourceMappingURL=alb.d.ts.map

package/platform/types/components/aws/v5/alb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alb.d.ts","sourceRoot":"","sources":["../../../../../src/components/aws/v5/alb.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAExB,KAAK,MAAM,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAO,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAA6B,MAAM,uBAAuB,CAAC;AAG1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAQvE,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzD,QAAA,MAAM,KAAK;IACT;;OAEG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;CAEH,CAAC;AAEH,MAAM,WAAW,OACf,SAAQ,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,KAAK,CAAC;CAAG;;IArB1D;;OAEG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;;AAOL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,qBAAa,GAAI,SAAQ,QAA+B;IAEtD,OAAO,CAAC,QAAQ,CAAiD;gBAErD,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,wBAAwB;IA6FxE;;;OAGG;IACH,IAAW,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAE/B;IAED;;OAEG;IACH,IAAW,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAEnC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAElC;IAED;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC,CAE3C;IAED,gBAAgB;IAChB,IAAW,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,CAEhC;IAED;;;;;;;;OAQG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ;IAc/D;;OAEG;IACI,IAAI;;;;;IAQX;;;;;;;;;;;OAWG;WACW,GAAG,CACf,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAC9B,IAAI,CAAC,EAAE,wBAAwB;CAQlC"}

package/platform/types/components/aws/v5/apigatewayv2.d.ts

@@ -0,0 +1,482 @@
+import { ComponentResourceOptions } from "@pulumi/pulumi";
+import { V5Args } from "../../parts-component";
+import type { Input } from "../../input";
+import { DnsValidatedCertificate } from "../dns-validated-certificate";
+import type { FunctionArgs as OriginalFunctionArgs, FunctionArn } from "../function";
+import { Function } from "./function";
+import { CustomDomainArgs } from "../helpers/custom-domain";
+import type { ApiGatewayV2DomainArgs as OriginalApiGatewayV2DomainArgs } from "../helpers/apigatewayv2-domain";
+import { type TakesVpc } from "../helpers/vpc";
+import type { ApiGatewayV2Args as OriginalApiGatewayV2Args, ApiGatewayV2AuthorizerArgs as OriginalApiGatewayV2AuthorizerArgs, ApiGatewayV2RouteArgs as OriginalApiGatewayV2RouteArgs } from "../apigatewayv2";
+declare const parts: () => {
+    /**
+     * The Amazon API Gateway HTTP API.
+     */
+    api: typeof import("@pulumi/aws/apigatewayv2/api").Api;
+    /**
+     * The API's `$default` stage.
+     */
+    stage: typeof import("@pulumi/aws/apigatewayv2/stage").Stage;
+    /**
+     * The CloudWatch log group for the access logs.
+     */
+    logGroup: typeof import("@pulumi/aws/cloudwatch/logGroup").LogGroup;
+    /**
+     * The VPC link, created when `vpc` is set.
+     */
+    vpcLink: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/vpcLink").VpcLink>;
+    /**
+     * The certificate for the custom domain, created when `domain` is set
+     * without a `cert`.
+     */
+    certificate: import("../..").OptionalPart<typeof DnsValidatedCertificate>;
+    /**
+     * The API Gateway custom domain name, when `domain` is set.
+     */
+    domainName: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/domainName").DomainName>;
+    /**
+     * The mapping between the custom domain name and the API.
+     */
+    domainMapping: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/apiMapping").ApiMapping>;
+    /**
+     * The function behind each route added with `route`, by route.
+     */
+    handler: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permission that lets the API invoke each handler, by route.
+     */
+    permission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+    /**
+     * The integration behind each route, by route.
+     */
+    integration: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/integration").Integration>;
+    /**
+     * The API's routes, by route.
+     */
+    route: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/route").Route>;
+    /**
+     * The API's authorizers, by authorizer name.
+     */
+    authorizer: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/authorizer").Authorizer>;
+    /**
+     * The function behind each Lambda authorizer, by authorizer name.
+     */
+    authorizerFunction: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permission that lets the API invoke each authorizer function, by
+     * authorizer name.
+     */
+    authorizerPermission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+};
+export interface ApiGatewayV2DomainArgs extends Omit<OriginalApiGatewayV2DomainArgs, "nameId" | "dns">, Pick<CustomDomainArgs, "dns"> {
+}
+export interface ApiGatewayV2Args extends V5Args<TakesVpc<Omit<OriginalApiGatewayV2Args, "domain">>, typeof parts> {
+    /**
+     * Set a custom domain for your HTTP API.
+     *
+     * Automatically manages domains hosted on AWS Route 53, Cloudflare, and
+     * Vercel. For other providers, pass in a `cert` that validates domain
+     * ownership and add the DNS records yourself.
+     *
+     * @example
+     *
+     * By default this assumes the domain is hosted on Route 53.
+     *
+     * ```js
+     * {
+     *   domain: "example.com"
+     * }
+     * ```
+     *
+     * For domains hosted on Cloudflare.
+     *
+     * ```js
+     * {
+     *   domain: {
+     *     name: "example.com",
+     *     dns: sst.cloudflare.dns()
+     *   }
+     * }
+     * ```
+     *
+     * To put this API under a path of a domain name another API created, pass
+     * that domain name in `existing`.
+     *
+     * ```js
+     * {
+     *   domain: { path: "v2" },
+     *   existing: { domainName: "api.example.com" }
+     * }
+     * ```
+     */
+    domain?: string | ApiGatewayV2DomainArgs;
+}
+export interface ApiGatewayV2RouteArgs extends Omit<OriginalApiGatewayV2RouteArgs, "name" | "transform"> {
+    /**
+     * A name for the route. It's used in place of the route itself in the names
+     * of the route's resources, and as the route's id in the API's `nodes` and
+     * `transform`.
+     *
+     * Must be unique across all routes.
+     *
+     * @example
+     * ```js
+     * {
+     *   name: "GetUser"
+     * }
+     * ```
+     */
+    name?: string;
+}
+export interface ApiGatewayV2AuthorizerArgs extends Omit<OriginalApiGatewayV2AuthorizerArgs, "transform"> {
+}
+declare const ApiGatewayV2_base: import("../..").ComponentClass<{
+    /**
+     * The Amazon API Gateway HTTP API.
+     */
+    api: typeof import("@pulumi/aws/apigatewayv2/api").Api;
+    /**
+     * The API's `$default` stage.
+     */
+    stage: typeof import("@pulumi/aws/apigatewayv2/stage").Stage;
+    /**
+     * The CloudWatch log group for the access logs.
+     */
+    logGroup: typeof import("@pulumi/aws/cloudwatch/logGroup").LogGroup;
+    /**
+     * The VPC link, created when `vpc` is set.
+     */
+    vpcLink: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/vpcLink").VpcLink>;
+    /**
+     * The certificate for the custom domain, created when `domain` is set
+     * without a `cert`.
+     */
+    certificate: import("../..").OptionalPart<typeof DnsValidatedCertificate>;
+    /**
+     * The API Gateway custom domain name, when `domain` is set.
+     */
+    domainName: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/domainName").DomainName>;
+    /**
+     * The mapping between the custom domain name and the API.
+     */
+    domainMapping: import("../..").OptionalPart<typeof import("@pulumi/aws/apigatewayv2/apiMapping").ApiMapping>;
+    /**
+     * The function behind each route added with `route`, by route.
+     */
+    handler: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permission that lets the API invoke each handler, by route.
+     */
+    permission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+    /**
+     * The integration behind each route, by route.
+     */
+    integration: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/integration").Integration>;
+    /**
+     * The API's routes, by route.
+     */
+    route: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/route").Route>;
+    /**
+     * The API's authorizers, by authorizer name.
+     */
+    authorizer: import("../..").ManyPart<typeof import("@pulumi/aws/apigatewayv2/authorizer").Authorizer>;
+    /**
+     * The function behind each Lambda authorizer, by authorizer name.
+     */
+    authorizerFunction: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permission that lets the API invoke each authorizer function, by
+     * authorizer name.
+     */
+    authorizerPermission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+}>;
+/**
+ * The `ApiGatewayV2` component lets you add an [Amazon API Gateway HTTP API](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api.html) to your app.
+ *
+ * It's built from parts, so every resource it creates can be transformed, is available in
+ * `nodes`, and can be swapped for one you already have. That includes the resources of each
+ * route.
+ *
+ * @example
+ *
+ * #### Create the API
+ *
+ * ```ts title="sst.config.ts"
+ * const api = new sst.aws.v5.ApiGatewayV2("MyApi");
+ * ```
+ *
+ * #### Add a custom domain
+ *
+ * ```js {2} title="sst.config.ts"
+ * new sst.aws.v5.ApiGatewayV2("MyApi", {
+ *   domain: "api.example.com"
+ * });
+ * ```
+ *
+ * #### Add routes
+ *
+ * ```ts title="sst.config.ts"
+ * api.route("GET /", "src/get.handler");
+ * api.route("POST /", "src/post.handler");
+ * ```
+ *
+ * #### Configure the routes
+ *
+ * ```ts title="sst.config.ts"
+ * api.route("GET /", "src/get.handler", {
+ *   auth: { iam: true }
+ * });
+ * ```
+ *
+ * #### Configure the route handler
+ *
+ * ```ts title="sst.config.ts"
+ * api.route("POST /", {
+ *   handler: "src/post.handler",
+ *   memory: "2048 MB"
+ * });
+ * ```
+ *
+ * #### Default props for all routes
+ *
+ * Use the `transform` to change every route's handler, integration or route. An object
+ * is merged into each one.
+ *
+ * ```ts title="sst.config.ts" {3}
+ * const api = new sst.aws.v5.ApiGatewayV2("MyApi", {
+ *   transform: {
+ *     handler: { memory: "2048 MB" }
+ *   }
+ * });
+ * ```
+ *
+ * A function is also given the route, so it can change one of them.
+ *
+ * ```ts title="sst.config.ts"
+ * const api = new sst.aws.v5.ApiGatewayV2("MyApi", {
+ *   transform: {
+ *     handler: (args, opts, name, route) => {
+ *       if (route === "POST /upload") args.timeout = "60 seconds";
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * #### Switch from `sst.aws.ApiGatewayV2`
+ *
+ * Change `sst.aws.ApiGatewayV2` to `sst.aws.v5.ApiGatewayV2` and keep the name. The API,
+ * its routes, their functions and its authorizers are kept. A few things are written
+ * differently:
+ *
+ * - A route's own `transform`, and the API's `transform.route.handler`, become the API's
+ *   `transform` for `handler`, `integration` and `route`.
+ * - `domain.nameId` becomes `existing: { domainName }`.
+ * - `domain` and `domain.dns` have to be plain values, not outputs.
+ *
+ * ```ts title="sst.config.ts" del={1} ins={2}
+ * const api = new sst.aws.ApiGatewayV2("MyApi");
+ * const api = new sst.aws.v5.ApiGatewayV2("MyApi");
+ * ```
+ */
+export declare class ApiGatewayV2 extends ApiGatewayV2_base {
+    private handlerLink;
+    constructor(name: string, args?: ApiGatewayV2Args, opts?: ComponentResourceOptions);
+    private createDomainName;
+    /**
+     * The URL of the API.
+     *
+     * If the `domain` is set, this is the URL with the custom domain.
+     * Otherwise, it's the auto-generated API Gateway URL.
+     */
+    get url(): import("@pulumi/pulumi").Output<string>;
+    /**
+     * Add a route to the API Gateway HTTP API. The route is a combination of
+     * - An HTTP method and a path, `{METHOD} /{path}`.
+     * - Or a `$default` route.
+     *
+     * :::caution
+     * [API Gateway has strict rate limits](https://docs.aws.amazon.com/apigateway/latest/developerguide/limits.html) for creating and updating resources. Creating one Lambda function for every endpoint can significantly slow down your deployments.
+     *
+     * Use a single Lambda and handle routing in code if you don't need specific API Gateway features.
+     * :::
+     *
+     * A method could be one of `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS`, or `ANY`. Here `ANY` matches any HTTP method.
+     *
+     * The path can be a combination of
+     * - Literal segments, `/notes`, `/notes/new`, etc.
+     * - Parameter segments, `/notes/{noteId}`, `/notes/{noteId}/attachments/{attachmentId}`, etc.
+     * - Greedy segments, `/{proxy+}`, `/notes/{proxy+}`,  etc. The `{proxy+}` segment is a greedy segment that matches all child paths. It needs to be at the end of the path.
+     *
+     * The `$default` route is a catch-all. It's invoked when no other route matches.
+     *
+     * :::note
+     * You cannot have duplicate routes.
+     * :::
+     *
+     * @param rawRoute The path for the route.
+     * @param handler The function that'll be invoked.
+     * @param args Configure the route.
+     *
+     * @example
+     * Add a simple route.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("GET /", "src/get.handler");
+     * ```
+     *
+     * Add a default or fallback route.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("$default", "src/default.handler");
+     * ```
+     *
+     * Add a parameterized route.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("GET /notes/{id}", "src/get.handler");
+     * ```
+     *
+     * Enable auth for a route.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("POST /", "src/post.handler", {
+     *   auth: {
+     *     iam: true
+     *   }
+     * });
+     * ```
+     *
+     * Customize the route handler.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("GET /", {
+     *   handler: "src/get.handler",
+     *   memory: "2048 MB"
+     * });
+     * ```
+     *
+     * Or pass in the ARN of an existing Lambda function.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("GET /", "arn:aws:lambda:us-east-1:123456789012:function:my-function");
+     * ```
+     *
+     * The route's resources are in the API's `nodes`, by route.
+     *
+     * ```js title="sst.config.ts"
+     * api.nodes.handler["GET /"];
+     * ```
+     */
+    route(rawRoute: string, handler: Input<string | OriginalFunctionArgs | FunctionArn>, args?: ApiGatewayV2RouteArgs): this;
+    /**
+     * Add a URL route to the API Gateway HTTP API.
+     *
+     * @param rawRoute The path for the route.
+     * @param url The URL to forward to.
+     * @param args Configure the route.
+     *
+     * @example
+     * Add a simple route.
+     *
+     * ```js title="sst.config.ts"
+     * api.routeUrl("GET /", "https://google.com");
+     * ```
+     *
+     * Enable auth for a route.
+     *
+     * ```js title="sst.config.ts"
+     * api.routeUrl("POST /", "https://google.com", {
+     *   auth: {
+     *     iam: true
+     *   }
+     * });
+     * ```
+     */
+    routeUrl(rawRoute: string, url: Input<string>, args?: ApiGatewayV2RouteArgs): this;
+    /**
+     * Adds a private route to the API Gateway HTTP API.
+     *
+     * To add private routes, you need to have a VPC link. Make sure to pass in a `vpc`.
+     * Learn more about [adding private routes](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-develop-integrations-private.html).
+     *
+     * A couple of things to note:
+     *
+     * 1. Your API Gateway HTTP API also needs to be in the **same VPC** as the service.
+     *
+     * 2. You also need to verify that your VPC's [**availability zones support VPC link**](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-vpc-links.html#http-api-vpc-link-availability).
+     *
+     * @param rawRoute The path for the route.
+     * @param arn The ARN of the AWS Load Balancer or Cloud Map service.
+     * @param args Configure the route.
+     *
+     * @example
+     * Add a route to Application Load Balancer.
+     *
+     * ```js title="sst.config.ts"
+     * const loadBalancerArn = "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188";
+     * api.routePrivate("GET /", loadBalancerArn);
+     * ```
+     *
+     * Add a route to AWS Cloud Map service.
+     *
+     * ```js title="sst.config.ts"
+     * const serviceArn = "arn:aws:servicediscovery:us-east-2:123456789012:service/srv-id?stage=prod&deployment=green_deployment";
+     * api.routePrivate("GET /", serviceArn);
+     * ```
+     */
+    routePrivate(rawRoute: string, arn: Input<string>, args?: ApiGatewayV2RouteArgs): this;
+    private newRoute;
+    private integrate;
+    /**
+     * Add an authorizer to the API Gateway HTTP API.
+     *
+     * @param args Configure the authorizer.
+     * @example
+     * Add a Lambda authorizer.
+     *
+     * ```js title="sst.config.ts"
+     * api.addAuthorizer({
+     *   name: "myAuthorizer",
+     *   lambda: {
+     *     function: "src/authorizer.index"
+     *   }
+     * });
+     * ```
+     *
+     * Add a JWT authorizer.
+     *
+     * ```js title="sst.config.ts"
+     * const authorizer = api.addAuthorizer({
+     *   name: "myAuthorizer",
+     *   jwt: {
+     *     issuer: "https://issuer.com/",
+     *     audiences: ["https://api.example.com"],
+     *     identitySource: "$request.header.AccessToken"
+     *   }
+     * });
+     * ```
+     *
+     * Now you can use the authorizer in your routes.
+     *
+     * ```js title="sst.config.ts"
+     * api.route("GET /", "src/get.handler", {
+     *   auth: {
+     *     jwt: {
+     *       authorizer: authorizer.id
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    addAuthorizer(args: ApiGatewayV2AuthorizerArgs): import("@pulumi/aws/apigatewayv2/authorizer").Authorizer;
+    /**
+     * Linking an API gives the linked resource its URL.
+     */
+    link(): {
+        properties: {
+            url: import("@pulumi/pulumi").Output<string>;
+        };
+    };
+}
+export {};
+//# sourceMappingURL=apigatewayv2.d.ts.map

package/platform/types/components/aws/v5/apigatewayv2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apigatewayv2.d.ts","sourceRoot":"","sources":["../../../../../src/components/aws/v5/apigatewayv2.ts"],"names":[],"mappings":"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"}