Add runLoop function

Sources/AWSLambdaRuntimeCore/NewLambda.swift

@@ -0,0 +1,56 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the SwiftAWSLambdaRuntime open source project
+//
+// Copyright (c) 2024 Apple Inc. and the SwiftAWSLambdaRuntime project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of SwiftAWSLambdaRuntime project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+import Dispatch
+import Logging
+import NIOCore
+
+package protocol StreamingLambdaHandler {
+    mutating func handle(
+        _ event: ByteBuffer,
+        responseWriter: some LambdaResponseStreamWriter,
+        context: NewLambdaContext
+    ) async throws
+}
+
+extension Lambda {
+    package static func runLoop<RuntimeClient: LambdaRuntimeClientProtocol, Handler>(
+        runtimeClient: RuntimeClient,
+        handler: Handler,
+        logger: Logger
+    ) async throws where Handler: StreamingLambdaHandler {
+        var handler = handler
+
+        while !Task.isCancelled {
+            let (invocation, writer) = try await runtimeClient.nextInvocation()
+
+            do {
+                try await handler.handle(
+                    invocation.event,
+                    responseWriter: writer,
+                    context: NewLambdaContext(
+                        requestID: invocation.metadata.requestID,
+                        traceID: invocation.metadata.traceID,
+                        invokedFunctionARN: invocation.metadata.invokedFunctionARN,
+                        deadline: DispatchWallTime(millisSinceEpoch: invocation.metadata.deadlineInMillisSinceEpoch),
+                        logger: logger
+                    )
+                )
+            } catch {
+                try await writer.reportError(error)
+                continue
+            }
+        }
+    }
+}

Sources/AWSLambdaTesting/LambdaMockClient.swift

@@ -0,0 +1,266 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the SwiftAWSLambdaRuntime open source project
+//
+// Copyright (c) 2024 Apple Inc. and the SwiftAWSLambdaRuntime project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of SwiftAWSLambdaRuntime project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+import AWSLambdaRuntimeCore
+import Foundation
+import Logging
+import NIOCore
+
+package struct LambdaMockWriter: LambdaResponseStreamWriter {
+    var underlying: LambdaMockClient
+
+    package init(underlying: LambdaMockClient) {
+        self.underlying = underlying
+    }
+
+    package mutating func write(_ buffer: ByteBuffer) async throws {
+        try await self.underlying.write(buffer)
+    }
+
+    package consuming func finish() async throws {
+        try await self.underlying.finish()
+    }
+
+    package consuming func writeAndFinish(_ buffer: ByteBuffer) async throws {
+        try await self.write(buffer)
+        try await self.finish()
+    }
+
+    package func reportError(_ error: any Error) async throws {
+    }
+}
+
+package struct LambdaError: Error, Equatable {
+    private enum Code: Equatable {
+        case cannotCallNextEndpointWhenAlreadyWaitingForEvent
+        case cannotCallNextEndpointWhenAlreadyProcessingAnEvent
+        case cannotReportResultWhenNoEventHasBeenProcessed
+    }
+
+    private let code: Code
+
+    private init(code: Code) {
+        self.code = code
+    }
+
+    package func shortDescription() -> String {
+        switch self.code {
+        case .cannotCallNextEndpointWhenAlreadyWaitingForEvent:
+            "Cannot call the next endpoint when already waiting for an event"
+        case .cannotCallNextEndpointWhenAlreadyProcessingAnEvent:
+            "Cannot call the next endpoint when an event is already being processed"
+        case .cannotReportResultWhenNoEventHasBeenProcessed:
+            "Cannot report a result when no event has been processed"
+        }
+    }
+
+    package static let cannotCallNextEndpointWhenAlreadyWaitingForEvent = LambdaError(
+        code: .cannotCallNextEndpointWhenAlreadyWaitingForEvent
+    )
+    package static let cannotCallNextEndpointWhenAlreadyProcessingAnEvent = LambdaError(
+        code: .cannotCallNextEndpointWhenAlreadyProcessingAnEvent
+    )
+    package static let cannotReportResultWhenNoEventHasBeenProcessed = LambdaError(
+        code: .cannotReportResultWhenNoEventHasBeenProcessed
+    )
+}
+
+package final actor LambdaMockClient: LambdaRuntimeClientProtocol {
+    package typealias Writer = LambdaMockWriter
+
+    private struct StateMachine {
+        private enum State {
+            // The Lambda has just started, or an event has finished processing and the runtime is ready to receive more events.
+            // Expecting a next() call by the runtime.
+            case initialState
+
+            // The next endpoint has been called but no event has arrived yet.
+            case waitingForNextEvent(eventArrivedHandler: CheckedContinuation<Invocation, any Error>)
+
+            // The handler is processing the event. Buffers written to the writer are accumulated.
+            case handlerIsProcessing(
+                accumulatedResponse: [ByteBuffer],
+                eventProcessedHandler: CheckedContinuation<ByteBuffer, any Error>
+            )
+        }
+
+        private var state: State = .initialState
+
+        // Queue incoming events if the runtime is busy handling an event.
+        private var eventQueue = [Event]()
+
+        enum InvokeAction {
+            // The next endpoint is waiting for an event. Deliver this newly arrived event to it.
+            case readyToProcess(_ eventArrivedHandler: CheckedContinuation<Invocation, any Error>)
+
+            // The next endpoint has not been called yet. This event has been added to the queue.
+            case wait
+        }
+
+        enum NextAction {
+            // There is an event available to be processed.
+            case readyToProcess(Invocation)
+
+            // No events available yet. Wait for an event to arrive.
+            case wait
+
+            case fail(LambdaError)
+        }
+
+        enum ResultAction {
+            case readyForMore
+
+            case fail(LambdaError)
+        }
+
+        mutating func next(_ eventArrivedHandler: CheckedContinuation<Invocation, any Error>) -> NextAction {
+            switch self.state {
+            case .initialState:
+                if self.eventQueue.isEmpty {
+                    // No event available yet -- store the continuation for the next invoke() call.
+                    self.state = .waitingForNextEvent(eventArrivedHandler: eventArrivedHandler)
+                    return .wait
+                } else {
+                    // An event is already waiting to be processed
+                    let event = self.eventQueue.removeFirst()  // TODO: use Deque
+
+                    self.state = .handlerIsProcessing(
+                        accumulatedResponse: [],
+                        eventProcessedHandler: event.eventProcessedHandler
+                    )
+                    return .readyToProcess(event.invocation)
+                }
+            case .waitingForNextEvent:
+                return .fail(.cannotCallNextEndpointWhenAlreadyWaitingForEvent)
+            case .handlerIsProcessing:
+                return .fail(.cannotCallNextEndpointWhenAlreadyProcessingAnEvent)
+            }
+        }
+
+        mutating func invoke(_ event: Event) -> InvokeAction {
+            switch self.state {
+            case .initialState, .handlerIsProcessing:
+                // next() hasn't been called yet. Add to the event queue.
+                self.eventQueue.append(event)
+                return .wait
+            case .waitingForNextEvent(let eventArrivedHandler):
+                // The runtime is already waiting for an event
+                self.state = .handlerIsProcessing(
+                    accumulatedResponse: [],
+                    eventProcessedHandler: event.eventProcessedHandler
+                )
+                return .readyToProcess(eventArrivedHandler)
+            }
+        }
+
+        mutating func writeResult(buffer: ByteBuffer) -> ResultAction {
+            switch self.state {
+            case .handlerIsProcessing(var accumulatedResponse, let eventProcessedHandler):
+                accumulatedResponse.append(buffer)
+                self.state = .handlerIsProcessing(
+                    accumulatedResponse: accumulatedResponse,
+                    eventProcessedHandler: eventProcessedHandler
+                )
+                return .readyForMore
+            case .initialState, .waitingForNextEvent:
+                return .fail(.cannotReportResultWhenNoEventHasBeenProcessed)
+            }
+        }
+
+        mutating func finish() throws {
+            switch self.state {
+            case .handlerIsProcessing(let accumulatedResponse, let eventProcessedHandler):
+                let finalResult: ByteBuffer = accumulatedResponse.reduce(ByteBuffer()) { (accumulated, current) in
+                    var accumulated = accumulated
+                    accumulated.writeBytes(current.readableBytesView)
+                    return accumulated
+                }
+
+                eventProcessedHandler.resume(returning: finalResult)
+                // reset back to the initial state
+                self.state = .initialState
+            case .initialState, .waitingForNextEvent:
+                throw LambdaError.cannotReportResultWhenNoEventHasBeenProcessed
+            }
+        }
+    }
+
+    private var stateMachine: StateMachine = .init()
+
+    struct Event {
+        let invocation: Invocation
+        let eventProcessedHandler: CheckedContinuation<ByteBuffer, any Error>
+    }
+
+    package func invoke(event: ByteBuffer) async throws -> ByteBuffer {
+        try await withCheckedThrowingContinuation { eventProcessedHandler in
+            do {
+                let metadata = try InvocationMetadata(
+                    headers: .init([
+                        ("Lambda-Runtime-Aws-Request-Id", "100"),  // arbitrary values
+                        ("Lambda-Runtime-Deadline-Ms", "100"),
+                        ("Lambda-Runtime-Invoked-Function-Arn", "100"),
+                    ])
+                )
+                let invocation = Invocation(metadata: metadata, event: event)
+
+                let invokeAction = self.stateMachine.invoke(
+                    Event(
+                        invocation: invocation,
+                        eventProcessedHandler: eventProcessedHandler
+                    )
+                )
+
+                switch invokeAction {
+                case .readyToProcess(let eventArrivedHandler):
+                    // nextInvocation had been called earlier and is currently waiting for an event; deliver
+                    eventArrivedHandler.resume(returning: invocation)
+                case .wait:
+                    // The event has been added to the event queue; wait for it to be picked up
+                    break
+                }
+            } catch {
+                eventProcessedHandler.resume(throwing: error)
+            }
+        }
+    }
+
+    package func nextInvocation() async throws -> (Invocation, Writer) {
+        let invocation = try await withCheckedThrowingContinuation { eventArrivedHandler in
+            switch self.stateMachine.next(eventArrivedHandler) {
+            case .readyToProcess(let event):
+                eventArrivedHandler.resume(returning: event)
+            case .fail(let error):
+                eventArrivedHandler.resume(throwing: error)
+            case .wait:
+                break
+            }
+        }
+
+        return (invocation, Writer(underlying: self))
+    }
+
+    package func write(_ buffer: ByteBuffer) async throws {
+        switch self.stateMachine.writeResult(buffer: buffer) {
+        case .readyForMore:
+            break
+        case .fail(let error):
+            throw error
+        }
+    }
+
+    package func finish() async throws {
+        try self.stateMachine.finish()
+    }
+}

Sources/AWSLambdaTesting/LambdaRunLoopTests.swift

@@ -0,0 +1,50 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the SwiftAWSLambdaRuntime open source project
+//
+// Copyright (c) 2024 Apple Inc. and the SwiftAWSLambdaRuntime project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of SwiftAWSLambdaRuntime project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+import Foundation
+import Logging
+import NIOCore
+import Testing
+
+@testable import AWSLambdaRuntimeCore
+
+struct LambdaRunLoopTests {
+    struct MockEchoHandler: StreamingLambdaHandler {
+        func handle(
+            _ event: ByteBuffer,
+            responseWriter: some LambdaResponseStreamWriter,
+            context: NewLambdaContext
+        ) async throws {
+            try await responseWriter.writeAndFinish(event)
+        }
+    }
+
+    let mockClient = LambdaMockClient()
+    let mockEchoHandler = MockEchoHandler()
+
+    @Test func testRunLoop() async throws {
+        _ = Task { () in
+            try await Lambda.runLoop(
+                runtimeClient: self.mockClient,
+                handler: self.mockEchoHandler,
+                logger: Logger(label: "RunLoopTest")
+            )
+        }
+
+        let inputEvent = ByteBuffer(string: "Test Invocation Event")
+        let response = try await self.mockClient.invoke(event: inputEvent)
+
+        #expect(response == inputEvent)
+    }
+}