@sst-community/sst 4.19.0 → 5.0.0-alpha.1

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

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

package/platform/types/components/aws/v5/sns-topic.d.ts

@@ -0,0 +1,226 @@
+import { ComponentResourceOptions } from "@pulumi/pulumi";
+import { V5Args } from "../../parts-component";
+import type { Input } from "../../input";
+import type { FunctionArgs as OriginalFunctionArgs, FunctionArn } from "../function";
+import { Function } from "./function";
+import type { Queue as OriginalQueue } from "../queue";
+import type { Queue } from "./queue";
+import type { SnsTopicArgs as OriginalSnsTopicArgs, SnsTopicSubscriberArgs as OriginalSnsTopicSubscriberArgs } from "../sns-topic";
+declare const parts: () => {
+    /**
+     * The Amazon SNS Topic.
+     */
+    topic: typeof import("@pulumi/aws/sns/topic").Topic;
+    /**
+     * The functions subscribed to the topic, by subscriber name.
+     */
+    subscriber: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permissions that let the topic invoke each subscriber function, by subscriber name.
+     */
+    permission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+    /**
+     * The topic's subscriptions, by subscriber name.
+     */
+    subscription: import("../..").ManyPart<typeof import("@pulumi/aws/sns/topicSubscription").TopicSubscription>;
+    /**
+     * The policies that let the topic send to each subscribed queue, by subscriber name.
+     */
+    queuePolicy: import("../..").ManyPart<typeof import("@pulumi/aws/sqs/queuePolicy").QueuePolicy>;
+};
+export interface SnsTopicArgs extends V5Args<OriginalSnsTopicArgs, typeof parts> {
+}
+export interface SnsTopicSubscriberArgs extends Omit<OriginalSnsTopicSubscriberArgs, "transform"> {
+}
+declare const SnsTopic_base: import("../..").ComponentClass<{
+    /**
+     * The Amazon SNS Topic.
+     */
+    topic: typeof import("@pulumi/aws/sns/topic").Topic;
+    /**
+     * The functions subscribed to the topic, by subscriber name.
+     */
+    subscriber: import("../..").ManyPart<import("../..").DeferredPart<typeof Function>>;
+    /**
+     * The permissions that let the topic invoke each subscriber function, by subscriber name.
+     */
+    permission: import("../..").ManyPart<typeof import("@pulumi/aws/lambda/permission").Permission>;
+    /**
+     * The topic's subscriptions, by subscriber name.
+     */
+    subscription: import("../..").ManyPart<typeof import("@pulumi/aws/sns/topicSubscription").TopicSubscription>;
+    /**
+     * The policies that let the topic send to each subscribed queue, by subscriber name.
+     */
+    queuePolicy: import("../..").ManyPart<typeof import("@pulumi/aws/sqs/queuePolicy").QueuePolicy>;
+}>;
+/**
+ * The `SnsTopic` component lets you add an [Amazon SNS Topic](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) to your app.
+ *
+ * It takes the same args as [`sst.aws.SnsTopic`](/docs/component/aws/sns-topic). 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 topic
+ *
+ * ```ts title="sst.config.ts"
+ * const topic = new sst.aws.v5.SnsTopic("MyTopic");
+ * ```
+ *
+ * #### Add subscribers
+ *
+ * Each subscriber has a name.
+ *
+ * ```ts title="sst.config.ts"
+ * topic.subscribe("Emailer", "src/emailer.handler");
+ * topic.subscribeQueue("Orders", queue);
+ * ```
+ *
+ * #### Link the topic to a resource
+ *
+ * ```ts title="sst.config.ts"
+ * new sst.aws.Nextjs("MyWeb", {
+ *   link: [topic]
+ * });
+ * ```
+ *
+ * #### Switch from `sst.aws.SnsTopic`
+ *
+ * Change `sst.aws.SnsTopic` to `sst.aws.v5.SnsTopic` and keep the name. The topic and the
+ * subscribers you've deployed are kept, as long as the subscribers have names.
+ *
+ * ```ts title="sst.config.ts" del={1} ins={2}
+ * const topic = new sst.aws.SnsTopic("MyTopic");
+ * const topic = new sst.aws.v5.SnsTopic("MyTopic");
+ * ```
+ *
+ * A few things work differently:
+ *
+ * - A queue subscriber is created with the topic's `provider`. `sst.aws.SnsTopic` created
+ *   it with your app's provider, whatever the topic was given. If your topic has a
+ *   `provider` and a queue subscribed to it, the subscription and the queue's policy are
+ *   replaced on switch: remove the subscriber and deploy before you switch, then add it
+ *   back.
+ */
+export declare class SnsTopic extends SnsTopic_base {
+    constructor(name: string, args?: SnsTopicArgs, opts?: ComponentResourceOptions);
+    /**
+     * The ARN of the SNS Topic.
+     */
+    get arn(): import("@pulumi/pulumi").Output<string>;
+    /**
+     * The name of the SNS Topic.
+     */
+    get name(): import("@pulumi/pulumi").Output<string>;
+    /**
+     * Subscribe a function to this topic.
+     *
+     * @param name The name of the subscriber.
+     * @param subscriber The function that'll be notified.
+     * @param args Configure the subscription.
+     *
+     * @example
+     *
+     * ```js title="sst.config.ts"
+     * topic.subscribe("MySubscriber", "src/subscriber.handler");
+     * ```
+     *
+     * Add a filter to the subscription.
+     *
+     * ```js title="sst.config.ts"
+     * topic.subscribe("MySubscriber", "src/subscriber.handler", {
+     *   filter: {
+     *     price_usd: [{numeric: [">=", 100]}]
+     *   }
+     * });
+     * ```
+     *
+     * Or pass in the ARN of an existing Lambda function.
+     *
+     * ```js title="sst.config.ts"
+     * topic.subscribe("MySubscriber", "arn:aws:lambda:us-east-1:123456789012:function:my-function");
+     * ```
+     *
+     * To change how one subscriber is created, use the topic's `transform`. Its function form
+     * is given the subscriber's name.
+     *
+     * ```js title="sst.config.ts"
+     * new sst.aws.v5.SnsTopic("MyTopic", {
+     *   transform: {
+     *     subscription: (args, opts, name, subscriber) => {
+     *       if (subscriber === "MySubscriber") args.rawMessageDelivery = true;
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    subscribe(name: string, subscriber: Input<string | OriginalFunctionArgs | FunctionArn>, args?: SnsTopicSubscriberArgs): this;
+    /**
+     * Subscribe a queue to this topic.
+     *
+     * @param name The name of the subscriber.
+     * @param queue The queue that'll be notified, or its ARN.
+     * @param args Configure the subscription.
+     *
+     * @example
+     *
+     * ```js title="sst.config.ts"
+     * const queue = new sst.aws.v5.Queue("MyQueue");
+     *
+     * topic.subscribeQueue("MySubscriber", queue);
+     * ```
+     *
+     * Add a filter to the subscription.
+     *
+     * ```js title="sst.config.ts"
+     * topic.subscribeQueue("MySubscriber", queue, {
+     *   filter: {
+     *     price_usd: [{numeric: [">=", 100]}]
+     *   }
+     * });
+     * ```
+     */
+    subscribeQueue(name: string, queue: Input<string | OriginalQueue | Queue>, args?: SnsTopicSubscriberArgs): this;
+    /**
+     * Reference an existing SNS topic with its topic ARN. This is useful when you create a
+     * topic in one stage and want to share it in another stage, or to subscribe to a topic
+     * that isn't in your app.
+     *
+     * @param name The name of the component.
+     * @param topicArn The ARN of the existing SNS Topic.
+     * @param opts Component resource options.
+     *
+     * @example
+     *
+     * ```ts title="sst.config.ts"
+     * const topic = $app.stage === "frank"
+     *   ? sst.aws.v5.SnsTopic.get("MyTopic", "arn:aws:sns:us-east-1:123456789012:MyTopic")
+     *   : new sst.aws.v5.SnsTopic("MyTopic");
+     * ```
+     */
+    static get(name: string, topicArn: Input<string>, opts?: ComponentResourceOptions): SnsTopic;
+    /**
+     * Linking a topic gives the linked resource the topic's ARN and permission
+     * to use it.
+     */
+    link(): {
+        properties: {
+            arn: import("@pulumi/pulumi").Output<string>;
+        };
+        include: {
+            effect?: "allow" | "deny" | undefined;
+            actions: string[];
+            resources: Input<Input<string>[]>;
+            conditions?: Input<Input<{
+                test: Input<string>;
+                variable: Input<string>;
+                values: Input<Input<string>[]>;
+            }>[]> | undefined;
+            type: "aws.permission";
+        }[];
+    };
+}
+export {};
+//# sourceMappingURL=sns-topic.d.ts.map

package/platform/types/components/aws/v5/sns-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sns-topic.d.ts","sourceRoot":"","sources":["../../../../../src/components/aws/v5/sns-topic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,MAAM,EAA6B,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,IAAI,oBAAoB,EACpC,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC,OAAO,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EACV,YAAY,IAAI,oBAAoB,EACpC,sBAAsB,IAAI,8BAA8B,EACzD,MAAM,cAAc,CAAC;AAEtB,QAAA,MAAM,KAAK;IACT;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEH,CAAC;AAEH,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,oBAAoB,EAAE,OAAO,KAAK,CAAC;CAAG;AAEnF,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,8BAA8B,EAAE,WAAW,CAAC;CAAG;;IAzB5D;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;;AASL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,QAAS,SAAQ,aAAoC;gBAE9D,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,YAAiB,EACvB,IAAI,CAAC,EAAE,wBAAwB;IAOjC;;OAEG;IACH,IAAW,GAAG,4CAEb;IAED;;OAEG;IACH,IAAW,IAAI,4CAEd;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACI,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,oBAAoB,GAAG,WAAW,CAAC,EAC9D,IAAI,GAAE,sBAA2B;IA2BnC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC,EAC5C,IAAI,GAAE,sBAA2B;IAoBnC;;;;;;;;;;;;;;;;OAgBG;WACW,GAAG,CACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EACvB,IAAI,CAAC,EAAE,wBAAwB;IAKjC;;;OAGG;IACI,IAAI;;;;;;;;;;;;;;;;CAMZ"}

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

@@ -0,0 +1,346 @@
+import { ComponentResourceOptions, type Output } from "@pulumi/pulumi";
+import { V5Args } from "../../parts-component";
+import { type ContainerArgs, type FargateArgs } from "../helpers/fargate";
+import type { TaskArgs as OriginalTaskArgs } from "../task";
+declare const parts: {
+    /**
+     * The Amazon ECS Execution Role.
+     */
+    executionRole: typeof import("@pulumi/aws/iam/role").Role;
+    /**
+     * The Amazon ECS Task Role.
+     */
+    taskRole: typeof import("@pulumi/aws/iam/role").Role;
+    /**
+     * The images built for the task's containers, by the container's name. There's one
+     * for each container that's built from a Dockerfile. It's added once the container's
+     * image settings are known.
+     */
+    image: import("../..").ManyPart<typeof import("@pulumi/docker-build/image").Image>;
+    /**
+     * The CloudWatch log groups of the task's containers, by the container's name.
+     */
+    logGroup: import("../..").ManyPart<typeof import("@pulumi/aws/cloudwatch/logGroup").LogGroup>;
+    /**
+     * The Amazon ECS Task Definition.
+     */
+    taskDefinition: typeof import("@pulumi/aws/ecs/taskDefinition").TaskDefinition;
+    /**
+     * The AWS Security Group for public tasks. Only created when `public` is `true`.
+     */
+    publicSecurityGroup: import("../..").OptionalPart<typeof import("@pulumi/aws/ec2/securityGroup").SecurityGroup>;
+};
+export interface TaskArgs extends V5Args<Omit<OriginalTaskArgs, "cluster" | "containers" | "volumes" | "taskRole" | "executionRole">, typeof parts>, FargateArgs {
+    /**
+     * The containers to run in the task.
+     *
+     * :::tip
+     * You can optionally run multiple containers in a task.
+     * :::
+     *
+     * By default this starts a single container. To add multiple containers in the task, pass
+     * in an array of containers args.
+     *
+     * ```ts
+     * {
+     *   containers: [
+     *     {
+     *       name: "app",
+     *       image: "nginxdemos/hello:plain-text"
+     *     },
+     *     {
+     *       name: "admin",
+     *       image: {
+     *         context: "./admin",
+     *         dockerfile: "Dockerfile"
+     *       }
+     *     }
+     *   ]
+     * }
+     * ```
+     *
+     * If you specify `containers`, you cannot list the above args at the top-level. For example,
+     * you **cannot** pass in `image` at the top level.
+     *
+     * ```diff lang="ts"
+     * {
+     * -  image: "nginxdemos/hello:plain-text",
+     *   containers: [
+     *     {
+     *       name: "app",
+     *       image: "nginxdemos/hello:plain-text"
+     *     },
+     *     {
+     *       name: "admin",
+     *       image: "nginxdemos/hello:plain-text"
+     *     }
+     *   ]
+     * }
+     * ```
+     *
+     * You will need to pass in `image` as a part of the `containers`.
+     *
+     * The list, each container and its `name` have to be plain values. What's inside a
+     * container can be an output.
+     */
+    containers?: ContainerArgs[];
+}
+declare const Task_base: import("../..").ComponentClass<{
+    /**
+     * The Amazon ECS Execution Role.
+     */
+    executionRole: typeof import("@pulumi/aws/iam/role").Role;
+    /**
+     * The Amazon ECS Task Role.
+     */
+    taskRole: typeof import("@pulumi/aws/iam/role").Role;
+    /**
+     * The images built for the task's containers, by the container's name. There's one
+     * for each container that's built from a Dockerfile. It's added once the container's
+     * image settings are known.
+     */
+    image: import("../..").ManyPart<typeof import("@pulumi/docker-build/image").Image>;
+    /**
+     * The CloudWatch log groups of the task's containers, by the container's name.
+     */
+    logGroup: import("../..").ManyPart<typeof import("@pulumi/aws/cloudwatch/logGroup").LogGroup>;
+    /**
+     * The Amazon ECS Task Definition.
+     */
+    taskDefinition: typeof import("@pulumi/aws/ecs/taskDefinition").TaskDefinition;
+    /**
+     * The AWS Security Group for public tasks. Only created when `public` is `true`.
+     */
+    publicSecurityGroup: import("../..").OptionalPart<typeof import("@pulumi/aws/ec2/securityGroup").SecurityGroup>;
+}>;
+/**
+ * The `Task` component lets you create containers that are used for long running asynchronous
+ * work, like data processing. It uses [Amazon ECS](https://aws.amazon.com/ecs/) on
+ * [AWS Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html).
+ *
+ * It takes the same args as [`sst.aws.Task`](/docs/component/aws/task) 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 Task
+ *
+ * Tasks are run inside an ECS Cluster. If you haven't already, create one.
+ *
+ * ```ts title="sst.config.ts"
+ * const vpc = new sst.aws.Vpc("MyVpc");
+ * const cluster = new sst.aws.v5.Cluster("MyCluster", { vpc });
+ * ```
+ *
+ * Add the task to it.
+ *
+ * ```ts title="sst.config.ts"
+ * const task = new sst.aws.v5.Task("MyTask", { cluster });
+ * ```
+ *
+ * #### Configure the container image
+ *
+ * By default, the task will look for a Dockerfile in the root directory. Optionally,
+ * configure the image context and dockerfile.
+ *
+ * ```ts title="sst.config.ts"
+ * new sst.aws.v5.Task("MyTask", {
+ *   cluster,
+ *   image: {
+ *     context: "./app",
+ *     dockerfile: "Dockerfile"
+ *   }
+ * });
+ * ```
+ *
+ * To add multiple containers in the task, pass in an array of containers args.
+ *
+ * ```ts title="sst.config.ts"
+ * new sst.aws.v5.Task("MyTask", {
+ *   cluster,
+ *   containers: [
+ *     {
+ *       name: "app",
+ *       image: "nginxdemos/hello:plain-text"
+ *     },
+ *     {
+ *       name: "admin",
+ *       image: {
+ *         context: "./admin",
+ *         dockerfile: "Dockerfile"
+ *       }
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * This is useful for running sidecar containers.
+ *
+ * #### Link resources
+ *
+ * [Link resources](/docs/linking/) to your task. This will grant permissions
+ * to the resources and allow you to access it in your app.
+ *
+ * ```ts {5} title="sst.config.ts"
+ * const bucket = new sst.aws.v5.Bucket("MyBucket");
+ *
+ * new sst.aws.v5.Task("MyTask", {
+ *   cluster,
+ *   link: [bucket]
+ * });
+ * ```
+ *
+ * You can use the [SDK](/docs/reference/sdk/) to access the linked resources in your task.
+ *
+ * ```ts title="app.ts"
+ * import { Resource } from "sst";
+ *
+ * console.log(Resource.MyBucket.name);
+ * ```
+ *
+ * #### Task SDK
+ *
+ * With the [Task JS SDK](/docs/component/aws/task#sdk), you can run your tasks, stop your
+ * tasks, and get the status of your tasks.
+ *
+ * For example, you can link the task to a function in your app.
+ *
+ * ```ts title="sst.config.ts" {3}
+ * new sst.aws.v5.Function("MyFunction", {
+ *   handler: "src/lambda.handler",
+ *   link: [task]
+ * });
+ * ```
+ *
+ * Then from your function run the task.
+ *
+ * ```ts title="src/lambda.ts"
+ * import { Resource } from "sst";
+ * import { task } from "sst/aws/task";
+ *
+ * const runRet = await task.run(Resource.MyTask);
+ * const taskArn = runRet.arn;
+ * ```
+ *
+ * If you are not using Node.js, you can use the AWS SDK instead. Here's
+ * [how to run a task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html).
+ *
+ * #### Use roles you already have
+ *
+ * Pass the role, or its name.
+ *
+ * ```ts title="sst.config.ts"
+ * new sst.aws.v5.Task("MyTask", {
+ *   cluster,
+ *   existing: {
+ *     taskRole: "my-task-role",
+ *     executionRole: "my-execution-role"
+ *   }
+ * });
+ * ```
+ *
+ * #### Switch from `sst.aws.Task`
+ *
+ * Change `sst.aws.Task` to `sst.aws.v5.Task` and keep the name. The task definition, its
+ * roles, the containers' log groups and images, and the security group of a public task
+ * are kept.
+ *
+ * ```ts title="sst.config.ts" del={1} ins={2}
+ * const task = new sst.aws.Task("MyTask", { cluster });
+ * const task = new sst.aws.v5.Task("MyTask", { cluster });
+ * ```
+ *
+ * A few things are written differently:
+ *
+ * - `taskRole: "my-task-role"` becomes `existing: { taskRole: "my-task-role" }`, and the
+ *   same for `executionRole`.
+ * - The list of `containers`, each container and its `name` are plain values, not
+ *   outputs. They decide which log groups and images are created.
+ * - `nodes.taskDefinition` is the task definition, not an output of it. `nodes` also has
+ *   the log groups and the images, by container name.
+ * - A `transform` function for `logGroup` or `taskDefinition` is given outputs where
+ *   `sst.aws.Task` gave it plain values. For `logGroup` and `image` it's also given the
+ *   container's name.
+ * - If you set part of the task definition's `runtimePlatform` with an object in
+ *   `transform`, the rest of it is kept.
+ *
+ * ---
+ *
+ * ### Cost
+ *
+ * By default, this uses a _Linux/X86_ _Fargate_ container with 0.25 vCPUs at $0.04048 per
+ * vCPU per hour and 0.5 GB of memory at $0.004445 per GB per hour. It includes 20GB of
+ * _Ephemeral Storage_ for free with additional storage at $0.000111 per GB per hour. When
+ * using an SST VPC, each task also gets a public IPv4 address at $0.005 per hour.
+ *
+ * It works out to $0.04048 x 0.25 + $0.004445 x 0.5 + $0.005. Or **$0.02 per hour**
+ * your task runs for.
+ *
+ * Adjust this for the `cpu`, `memory` and `storage` you are using. And
+ * check the prices for _Linux/ARM_ if you are using `arm64` as your `architecture`.
+ *
+ * The above are rough estimates for _us-east-1_, check out the
+ * [Fargate pricing](https://aws.amazon.com/fargate/pricing/) and the
+ * [Public IPv4 Address pricing](https://aws.amazon.com/vpc/pricing/) for more details.
+ */
+export declare class Task extends Task_base {
+    private readonly run;
+    constructor(name: string, args: TaskArgs, opts?: ComponentResourceOptions);
+    /**
+     * The ARN of the ECS Task Definition.
+     */
+    get taskDefinition(): Output<string>;
+    /**
+     * The names of the containers in the task.
+     * @internal
+     */
+    get containers(): Output<string[]>;
+    /**
+     * The ARN of the cluster this task is deployed to.
+     * @internal
+     */
+    get cluster(): Output<string>;
+    /**
+     * The security groups for the task.
+     * @internal
+     */
+    get securityGroups(): Output<string[]>;
+    /**
+     * The subnets for the task.
+     * @internal
+     */
+    get subnets(): Output<string[]>;
+    /**
+     * Whether to assign a public IP address to the task.
+     * @internal
+     */
+    get assignPublicIp(): import("@pulumi/pulumi").OutputInstance<boolean>;
+    /**
+     * Linking a task gives the linked resource what it needs to run it with the
+     * [Task SDK](/docs/component/aws/task#sdk), and lets it run, describe and stop the task.
+     */
+    link(): {
+        properties: {
+            cluster: Output<string>;
+            containers: Output<string[]>;
+            taskDefinition: Output<string>;
+            subnets: Output<string[]>;
+            securityGroups: Output<string[]>;
+            assignPublicIp: import("@pulumi/pulumi").OutputInstance<boolean>;
+        };
+        include: {
+            effect?: "allow" | "deny" | undefined;
+            actions: string[];
+            resources: import("../../input").Input<import("../../input").Input<string>[]>;
+            conditions?: import("../../input").Input<import("../../input").Input<{
+                test: import("../../input").Input<string>;
+                variable: import("../../input").Input<string>;
+                values: import("../../input").Input<import("../../input").Input<string>[]>;
+            }>[]> | undefined;
+            type: "aws.permission";
+        }[];
+    };
+}
+export {};
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../../src/components/aws/v5/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,wBAAwB,EACxB,KAAK,MAAM,EAEZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,MAAM,EAA6B,MAAM,uBAAuB,CAAC;AAI1E,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EAWjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE5D,QAAA,MAAM,KAAK;IACT;;OAEG;;IAEH;;OAEG;;IAEH;;;;OAIG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEJ,CAAC;AAEF,MAAM,WAAW,QACf,SAAQ,MAAM,CACV,IAAI,CACF,gBAAgB,EAChB,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CACpE,EACD,OAAO,KAAK,CACb,EACD,WAAW;IACb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;;IA1FC;;OAEG;;IAEH;;OAEG;;IAEH;;;;OAIG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;;AAoEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0KG;AACH,qBAAa,IAAK,SAAQ,SAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAMlB;gBAGA,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,IAAI,GAAE,wBAA6B;IAmKrC;;OAEG;IACH,IAAW,cAAc,mBAExB;IAED;;;OAGG;IACH,IAAW,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAExC;IAED;;;OAGG;IACH,IAAW,OAAO,mBAEjB;IAED;;;OAGG;IACH,IAAW,cAAc,qBAExB;IAED;;;OAGG;IACH,IAAW,OAAO,qBAEjB;IAED;;;OAGG;IACH,IAAW,cAAc,qDAExB;IAED;;;OAGG;IACI,IAAI;;;;;;;;;;;;;;;;;;;;;CA4BZ"}