alchemy 2.0.0-beta.cli-platform-split → 2.0.0-beta.pkg-setup-rc

package/lib/AWS/Lambda/EventSourceMapping.js

@@ -0,0 +1,198 @@
+import * as lambda from "@distilled.cloud/aws/lambda";
+import { Region } from "@distilled.cloud/aws/Region";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schedule from "effect/Schedule";
+import * as Stream from "effect/Stream";
+import { deepEqual, isResolved } from "../../Diff.js";
+import * as Provider from "../../Provider.js";
+import { Resource } from "../../Resource.js";
+import { createInternalTags, diffTags, hasTags } from "../../Tags.js";
+import { Account } from "../Account.js";
+export const EventSourceMapping = Resource("AWS.Lambda.EventSourceMapping");
+export const EventSourceMappingProvider = () => Provider.effect(EventSourceMapping, Effect.gen(function* () {
+    const region = yield* Region;
+    const accountId = yield* Account;
+    const createEventSourceMappingTags = Effect.fn(function* (id) {
+        const internalTags = yield* createInternalTags(id);
+        return {
+            ...internalTags,
+            "alchemy::id": sanitizeAwsTagValue(internalTags["alchemy::id"]),
+        };
+    });
+    const toCreateRequest = (props, tags) => ({
+        FunctionName: props.functionName,
+        EventSourceArn: props.eventSourceArn,
+        Enabled: props.enabled ?? true,
+        BatchSize: props.batchSize,
+        MaximumBatchingWindowInSeconds: props.maximumBatchingWindowInSeconds,
+        StartingPosition: props.startingPosition,
+        StartingPositionTimestamp: props.startingPositionTimestamp,
+        ParallelizationFactor: props.parallelizationFactor,
+        BisectBatchOnFunctionError: props.bisectBatchOnFunctionError,
+        MaximumRecordAgeInSeconds: props.maximumRecordAgeInSeconds,
+        MaximumRetryAttempts: props.maximumRetryAttempts,
+        TumblingWindowInSeconds: props.tumblingWindowInSeconds,
+        FunctionResponseTypes: props.functionResponseTypes ?? [
+            "ReportBatchItemFailures",
+        ],
+        ScalingConfig: props.scalingConfig,
+        DestinationConfig: props.destinationConfig,
+        FilterCriteria: props.filterCriteria,
+        KMSKeyArn: props.kmsKeyArn,
+        MetricsConfig: props.metricsConfig ?? { Metrics: ["EventCount"] },
+        ProvisionedPollerConfig: props.provisionedPollerConfig,
+        AmazonManagedKafkaEventSourceConfig: props.amazonManagedKafkaEventSourceConfig,
+        SelfManagedKafkaEventSourceConfig: props.selfManagedKafkaEventSourceConfig,
+        SelfManagedEventSource: props.selfManagedEventSource,
+        SourceAccessConfigurations: props.sourceAccessConfigurations,
+        Topics: props.topics,
+        Queues: props.queues,
+        DocumentDBEventSourceConfig: props.documentDBEventSourceConfig,
+        LoggingConfig: props.loggingConfig,
+        Tags: tags,
+    });
+    const toUpdateRequest = (uuid, props) => ({
+        UUID: uuid,
+        FunctionName: props.functionName,
+        Enabled: props.enabled ?? true,
+        BatchSize: props.batchSize,
+        MaximumBatchingWindowInSeconds: props.maximumBatchingWindowInSeconds,
+        BisectBatchOnFunctionError: props.bisectBatchOnFunctionError,
+        MaximumRecordAgeInSeconds: props.maximumRecordAgeInSeconds,
+        MaximumRetryAttempts: props.maximumRetryAttempts,
+        TumblingWindowInSeconds: props.tumblingWindowInSeconds,
+        FunctionResponseTypes: props.functionResponseTypes ?? [
+            "ReportBatchItemFailures",
+        ],
+        ScalingConfig: props.scalingConfig,
+        DestinationConfig: props.destinationConfig,
+        FilterCriteria: props.filterCriteria,
+        KMSKeyArn: props.kmsKeyArn,
+        MetricsConfig: props.metricsConfig ?? { Metrics: ["EventCount"] },
+        ProvisionedPollerConfig: props.provisionedPollerConfig,
+        AmazonManagedKafkaEventSourceConfig: props.amazonManagedKafkaEventSourceConfig,
+        SelfManagedKafkaEventSourceConfig: props.selfManagedKafkaEventSourceConfig,
+        SourceAccessConfigurations: props.sourceAccessConfigurations,
+        DocumentDBEventSourceConfig: props.documentDBEventSourceConfig,
+        LoggingConfig: props.loggingConfig,
+    });
+    const configToAttrs = (config) => ({
+        uuid: config.UUID,
+        eventSourceMappingArn: config.EventSourceMappingArn,
+        functionArn: config.FunctionArn,
+        state: config.State,
+    });
+    return {
+        stables: ["uuid", "eventSourceMappingArn"],
+        diff: Effect.fn(function* ({ news, olds }) {
+            if (!isResolved(news))
+                return;
+            if (news.eventSourceArn !== olds.eventSourceArn) {
+                return { action: "replace" };
+            }
+            if (news.startingPosition !== olds.startingPosition) {
+                return { action: "replace" };
+            }
+            if (news.startingPositionTimestamp?.getTime() !==
+                olds.startingPositionTimestamp?.getTime()) {
+                return { action: "replace" };
+            }
+            if (!deepEqual(news.selfManagedEventSource, olds.selfManagedEventSource)) {
+                return { action: "replace" };
+            }
+        }),
+        create: Effect.fn(function* ({ id, news, session }) {
+            const expectedInternalTags = yield* createEventSourceMappingTags(id);
+            const allTags = { ...expectedInternalTags, ...news.tags };
+            const functionName = news.functionName;
+            const eventSourceArn = news.eventSourceArn;
+            const config = yield* lambda
+                .createEventSourceMapping(toCreateRequest(news, allTags))
+                .pipe(Effect.catchTags({
+                ResourceConflictException: () => lambda.listEventSourceMappings
+                    .pages({
+                    FunctionName: functionName,
+                })
+                    .pipe(
+                // TODO(sam): maybe process chunks to avoid linear scanning of Event Sources
+                Stream.mapEffect(Effect.fn(function* (page) {
+                    const mapping = page.EventSourceMappings?.find((m) => m.EventSourceArn === eventSourceArn);
+                    if (mapping?.UUID) {
+                        const { Tags } = yield* lambda
+                            .listTags({
+                            Resource: `arn:aws:lambda:${region}:${accountId}:event-source-mapping:${mapping.UUID}`,
+                        })
+                            .pipe(retryTransient);
+                        if (hasTags(expectedInternalTags, Tags)) {
+                            return mapping;
+                        }
+                    }
+                })), Stream.filter((item) => item !== undefined), Stream.runHead, Effect.map(Option.getOrUndefined), Effect.flatMap((mapping) => mapping
+                    ? Effect.succeed(mapping)
+                    : Effect.die(new Error(`EventSourceMapping(${id}) not found on function ${functionName}`)))),
+            }), retryPermissionsPropagation, retryTransient);
+            yield* session.note(config.EventSourceMappingArn);
+            return configToAttrs(config);
+        }),
+        update: Effect.fn(function* ({ id, news, olds, output, session }) {
+            const config = yield* lambda
+                .updateEventSourceMapping(toUpdateRequest(output.uuid, news))
+                .pipe(Effect.retry({
+                while: (e) => e._tag === "ResourceInUseException" ||
+                    e._tag === "ResourceConflictException",
+                schedule: Schedule.exponential(100).pipe(Schedule.both(Schedule.recurs(20))),
+            }), retryPermissionsPropagation, retryTransient);
+            const internalTags = yield* createEventSourceMappingTags(id);
+            const oldTags = { ...internalTags, ...olds.tags };
+            const newTags = { ...internalTags, ...news.tags };
+            const { removed, upsert } = diffTags(oldTags, newTags);
+            const mappingArn = `arn:aws:lambda:${region}:${accountId}:event-source-mapping:${output.uuid}`;
+            if (removed.length > 0) {
+                yield* lambda
+                    .untagResource({ Resource: mappingArn, TagKeys: removed })
+                    .pipe(retryTransient);
+            }
+            if (upsert.length > 0) {
+                const tagsToAdd = {};
+                for (const { Key, Value } of upsert) {
+                    tagsToAdd[Key] = Value;
+                }
+                yield* lambda
+                    .tagResource({ Resource: mappingArn, Tags: tagsToAdd })
+                    .pipe(retryTransient);
+            }
+            yield* session.note(`Updated event source mapping ${output.uuid}`);
+            return configToAttrs(config);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* lambda.deleteEventSourceMapping({ UUID: output.uuid }).pipe(Effect.retry({
+                while: (e) => e._tag === "ResourceInUseException" ||
+                    e._tag === "ResourceConflictException",
+                schedule: Schedule.exponential(100).pipe(Schedule.both(Schedule.recurs(20))),
+            }), Effect.catchTag("ResourceNotFoundException", () => Effect.void));
+        }),
+    };
+}));
+const retryTransient = Effect.retry({
+    while: (e) => e._tag === "InternalFailure" ||
+        e._tag === "RequestExpired" ||
+        e._tag === "ServiceException" ||
+        e._tag === "ServiceUnavailable" ||
+        e._tag === "ThrottlingException" ||
+        e._tag === "TooManyRequestsException" ||
+        e._tag === "RequestLimitExceeded" ||
+        e._tag === "ResourceInUseException",
+    schedule: Schedule.exponential(100).pipe(Schedule.both(Schedule.recurs(30))),
+});
+const retryPermissionsPropagation = Effect.retry({
+    while: (e) => e._tag === "InvalidParameterValueException" &&
+        (e.message?.includes("The function execution role does not have permissions to call") ||
+            e.message?.includes("cannot be assumed by Lambda") ||
+            e.message?.includes("Please add Lambda as a Trusted Entity") ||
+            e.message?.includes("Cannot access stream") ||
+            e.message?.includes("Please ensure the role can perform the GetRecords")),
+    schedule: Schedule.exponential(100).pipe(Schedule.both(Schedule.recurs(30))),
+});
+const sanitizeAwsTagValue = (value) => value.replace(/[^\p{L}\p{Z}\p{N}_.:/=+\-@]/gu, "-");
+//# sourceMappingURL=EventSourceMapping.js.map

package/lib/AWS/Lambda/EventSourceMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSourceMapping.js","sourceRoot":"","sources":["../../../src/AWS/Lambda/EventSourceMapping.ts"],"names":[],"mappings":"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"}

package/lib/AWS/Lambda/Function.d.ts

@@ -0,0 +1,305 @@
+import type { Credentials } from "@distilled.cloud/aws/Credentials";
+import { Region } from "@distilled.cloud/aws/Region";
+import type * as lambda from "aws-lambda";
+import * as Context from "effect/Context";
+import * as FileSystem from "effect/FileSystem";
+import type * as rolldown from "rolldown";
+import { Platform, type Main, type PlatformProps } from "../../Platform.ts";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+import * as Serverless from "../../Serverless/index.ts";
+import { Stack } from "../../Stack.ts";
+import { Account } from "../Account.ts";
+import type { PolicyStatement } from "../IAM/Policy.ts";
+export declare const FunctionTypeId: "AWS.Lambda.Function";
+export type FunctionTypeId = typeof FunctionTypeId;
+declare const HandlerContext_base: Context.ServiceClass<HandlerContext, "AWS.Lambda.HandlerContext", lambda.Context>;
+export declare class HandlerContext extends HandlerContext_base {
+}
+export declare const isFunction: (value: any) => value is Function;
+export interface FunctionBuildOptions {
+    readonly input?: Partial<rolldown.InputOptions>;
+    readonly output?: Partial<rolldown.OutputOptions>;
+}
+export interface FunctionProps extends PlatformProps {
+    /**
+     * Entry module for the bundled Lambda function.
+     */
+    main: string;
+    /**
+     * Exported handler symbol inside the bundled module.
+     * @default "handler"
+     */
+    handler?: string;
+    /**
+     * Whether to create a public Lambda function URL.
+     * @default false
+     */
+    url?: boolean;
+    functionName?: string;
+    runtime?: "nodejs22.x" | "nodejs24.x";
+    build?: FunctionBuildOptions;
+    uploadSourceMap?: boolean;
+    env?: Record<string, any>;
+    exports?: string[];
+    /**
+     * Attach the function to a VPC for private AWS connectivity such as Aurora.
+     */
+    vpc?: {
+        subnetIds: string[];
+        securityGroupIds: string[];
+    };
+}
+export interface Function extends Resource<FunctionTypeId, FunctionProps, {
+    functionArn: string;
+    functionName: string;
+    functionUrl: string | undefined;
+    roleName: string;
+    roleArn: string;
+    code: {
+        hash: string;
+    };
+}, {
+    env?: Record<string, any>;
+    policyStatements?: PolicyStatement[];
+}, Providers> {
+}
+export type FunctionServices = Credentials | Region;
+export type FunctionShape = Main<FunctionServices>;
+/**
+ * An AWS Lambda host resource that combines code bundling, IAM role
+ * provisioning, and runtime binding collection.
+ *
+ * `Function` is the canonical runtime host for AWS. Alchemy automatically
+ * bundles your TypeScript entry module with Rolldown, creates an IAM
+ * execution role, and uploads the zip artifact. On subsequent deploys, the
+ * function is only updated when the bundle hash changes.
+ *
+ * There are two ways to define a Lambda Function:
+ *
+ * - **Async** — plain handler export, no Effect runtime in the bundle.
+ * - **Effect** — Effect implementation with typed bindings and event sources.
+ *
+ * See the {@link https://alchemy.run/guides/async-lambda | Async Lambda Guide}
+ * for plain handler patterns, or the
+ * {@link https://alchemy.run/guides/lambda | Effect Lambda Guide}
+ * for the full Effect-based approach with bindings, event sources, and sinks.
+ *
+ * @section Async Functions
+ * Point `main` at a file that exports a standard Lambda handler. No
+ * Effect runtime is included in the bundle. Useful when migrating
+ * existing Lambda functions or when you don't need Effect.
+ *
+ * @example Defining an async Lambda in your stack
+ * ```typescript
+ * // alchemy.run.ts
+ * import * as AWS from "alchemy/AWS";
+ *
+ * const func = yield* AWS.Lambda.Function("ApiFunction", {
+ *   main: "./src/handler.ts",
+ *   url: true,
+ * });
+ * ```
+ *
+ * @example Writing the async handler
+ * ```typescript
+ * // src/handler.ts
+ * export const handler = async (event: any) => {
+ *   return {
+ *     statusCode: 200,
+ *     body: JSON.stringify({ message: "Hello from Lambda!" }),
+ *   };
+ * };
+ * ```
+ *
+ * @section Effect Functions
+ * Pass the Effect implementation as the third argument. Bindings
+ * attach IAM permissions and environment variables at deploy time,
+ * while the runtime execution context collects listeners and exports.
+ *
+ * @example Effect Function with HTTP handler
+ * ```typescript
+ * export default class ApiFunction extends AWS.Lambda.Function<ApiFunction>()(
+ *   "ApiFunction",
+ *   { main: import.meta.filename, url: true },
+ *   Effect.gen(function* () {
+ *     // init: bind resources
+ *     const getItem = yield* DynamoDB.GetItem.bind(table);
+ *
+ *     return {
+ *       // runtime: use them
+ *       fetch: Effect.gen(function* () {
+ *         const request = yield* HttpServerRequest;
+ *         const url = new URL(request.url);
+ *         const id = url.searchParams.get("id");
+ *         const result = yield* getItem({ Key: { pk: { S: id! } } });
+ *         return yield* HttpServerResponse.json(result.Item);
+ *       }),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * @section Configuration
+ * @example Function with URL
+ * ```typescript
+ * const func = yield* AWS.Lambda.Function("ApiFunction", {
+ *   main: "./src/handler.ts",
+ *   url: true,
+ * });
+ * ```
+ *
+ * @example Function in a VPC
+ * ```typescript
+ * const func = yield* AWS.Lambda.Function("VpcFunction", {
+ *   main: "./src/handler.ts",
+ *   vpc: {
+ *     subnetIds: ["subnet-abc123", "subnet-def456"],
+ *     securityGroupIds: ["sg-xyz789"],
+ *   },
+ * });
+ * ```
+ *
+ * @section S3 Bindings
+ * Bind S3 operations in the init phase to give the function IAM
+ * permissions and inject the bucket name as an environment variable.
+ *
+ * @example Read and write S3 objects
+ * ```typescript
+ * // init
+ * const getObject = yield* S3.GetObject.bind(bucket);
+ * const putObject = yield* S3.PutObject.bind(bucket);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* putObject({ Key: "hello.txt", Body: "Hello!" });
+ *     const obj = yield* getObject({ Key: "hello.txt" });
+ *     return HttpServerResponse.text("OK");
+ *   }),
+ * };
+ * ```
+ *
+ * @section DynamoDB Bindings
+ * Bind DynamoDB operations in the init phase to grant table-scoped
+ * IAM permissions.
+ *
+ * @example Get and put items
+ * ```typescript
+ * // init
+ * const getItem = yield* DynamoDB.GetItem.bind(table);
+ * const putItem = yield* DynamoDB.PutItem.bind(table);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* putItem({ Item: { pk: { S: "user#1" }, name: { S: "Alice" } } });
+ *     const result = yield* getItem({ Key: { pk: { S: "user#1" } } });
+ *     return yield* HttpServerResponse.json(result.Item);
+ *   }),
+ * };
+ * ```
+ *
+ * @section SQS Bindings
+ * Bind SQS operations in the init phase to send messages to a queue.
+ *
+ * @example Send a message
+ * ```typescript
+ * // init
+ * const sendMessage = yield* SQS.SendMessage.bind(queue);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* sendMessage({
+ *       MessageBody: JSON.stringify({ orderId: "123" }),
+ *     });
+ *     return HttpServerResponse.text("Queued");
+ *   }),
+ * };
+ * ```
+ *
+ * @section SNS Bindings
+ * Bind SNS operations in the init phase to publish messages to a
+ * topic.
+ *
+ * @example Publish a notification
+ * ```typescript
+ * // init
+ * const publish = yield* SNS.Publish.bind(topic);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* publish({
+ *       Message: JSON.stringify({ event: "order.created" }),
+ *       Subject: "OrderCreated",
+ *     });
+ *     return HttpServerResponse.text("Published");
+ *   }),
+ * };
+ * ```
+ *
+ * @section Kinesis Bindings
+ * Bind Kinesis operations in the init phase to put records into a
+ * stream.
+ *
+ * @example Put a record
+ * ```typescript
+ * // init
+ * const putRecord = yield* Kinesis.PutRecord.bind(stream);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* putRecord({
+ *       PartitionKey: "order-123",
+ *       Data: new TextEncoder().encode(JSON.stringify({ orderId: "123" })),
+ *     });
+ *     return HttpServerResponse.text("Sent");
+ *   }),
+ * };
+ * ```
+ *
+ * @section Event Sources
+ * Lambda functions can be triggered by event sources like SQS queues,
+ * DynamoDB streams, S3 notifications, SNS topics, and Kinesis streams.
+ *
+ * @example Process SQS messages
+ * ```typescript
+ * yield* SQS.messages(queue).process(
+ *   Effect.fn(function* (message) {
+ *     yield* Effect.log(`Received: ${message.body}`);
+ *   }),
+ * );
+ * ```
+ *
+ * @example Process DynamoDB stream changes
+ * ```typescript
+ * yield* DynamoDB.streams(table, {
+ *   StreamViewType: "NEW_AND_OLD_IMAGES",
+ * }).process(
+ *   Effect.fn(function* (record) {
+ *     yield* Effect.log(`Change: ${record.eventName}`);
+ *   }),
+ * );
+ * ```
+ *
+ * @example Process S3 notifications
+ * ```typescript
+ * yield* S3.notifications(bucket, {
+ *   events: ["s3:ObjectCreated:*"],
+ * }).subscribe((stream) =>
+ *   stream.pipe(
+ *     Stream.runForEach((event) =>
+ *       Effect.log(`New object: ${event.key}`),
+ *     ),
+ *   ),
+ * );
+ * ```
+ */
+export declare const Function: Platform<Function, FunctionServices, FunctionShape, Serverless.FunctionContext>;
+export declare const FunctionProvider: () => import("effect/Layer").Layer<Provider.Provider<Function>, never, FileSystem.FileSystem | import("effect/Path").Path | import("../../Stage.ts").Stage | Stack | Account | import("../Assets.ts").AssetsRequirements>;
+export {};
+//# sourceMappingURL=Function.d.ts.map

package/lib/AWS/Lambda/Function.d.ts.map

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