com.steamstreet:env-js
Advanced tools
A comprehensive collection of Kotlin libraries for building AWS applications, with special focus on AWS Lambda functions. The libraries support both JVM-only and multiplatform (JVM/JS/iOS) targets.
Add the following to your build.gradle.kts:
dependencies {
implementation("com.steamstreet:awskt-standards:VERSION")
implementation("com.steamstreet:awskt-dynamokt:VERSION")
implementation("com.steamstreet:awskt-lambda-core:VERSION")
// Add other modules as needed
}
Language-level extensions and utilities optimized for AWS environments. Provides foundational Kotlin extensions that enhance productivity when working with AWS services.
Key Features:
Unified configuration management across multiple sources. Seamlessly access configuration values from environment variables, system properties, or AWS Secrets Manager.
Usage:
// Automatically resolves from env var, system property, or AWS secret
val apiKey = getEnvironmentVariable("API_KEY")
val dbPassword = getSecret("db/password")
Structured logging utilities with Kotlin Serialization support. Provides explicit, type-safe logging without requiring a Logger implementation.
Usage:
logInfo("Some info")
logWarning("Some warning", t)
// Log structured data
@Serializable
data class UserEvent(val name: String, val action: String)
logValue("User action", "event", UserEvent("Alice", "login"))
Lambda-Core automatically configures CloudWatch Logs integration for proper structured logging.
JSON serialization utilities built on Kotlin Serialization. Provides common serialization patterns and utilities for AWS services.
Key Features:
Event handling and EventBridge integration. Simplifies working with AWS EventBridge for event-driven architectures.
Usage:
// Define event schema
@Serializable
data class OrderEvent(val orderId: String, val status: String)
// Publish events
eventBridge.putEvent(OrderEvent("123", "completed"))
Type-safe DynamoDB client with full coroutine support. Provides a Kotlin-first API for DynamoDB operations with compile-time safety.
Key Features:
Foundation for all Lambda functions. Provides base classes, annotations, and core Lambda functionality.
Key Features:
Usage:
class MyHandler : LambdaHandler<Request, Response> {
override suspend fun handleRequest(input: Request, context: Context): Response {
logInfo("Processing request", "id" to input.id)
return Response("Success")
}
}
API Gateway proxy integration for REST APIs. Simplifies building REST APIs with Lambda.
Key Features:
Usage:
class ApiHandler : ApiGatewayHandler() {
override suspend fun handleRequest(event: APIGatewayProxyRequestEvent): APIGatewayProxyResponseEvent {
return response(200) {
body = Json.encodeToString(Result("success"))
headers = mapOf("Content-Type" to "application/json")
}
}
}
Ktor server integration for API Gateway. Run full Ktor applications in Lambda.
Key Features:
Usage:
class KtorHandler : ApiGatewayKtorHandler() {
override fun Application.module() {
routing {
get("/users/{id}") {
val id = call.parameters["id"]
call.respond(User(id!!, "John"))
}
}
}
}
AppSync resolver support for GraphQL APIs. Build GraphQL resolvers with type safety.
Key Features:
Usage:
class UserResolver : AppSyncResolver<GetUserRequest, User> {
override suspend fun resolve(request: GetUserRequest): User {
return dynamoKt.get(request.id)
}
}
DynamoDB Streams event processing. Handle table changes with type-safe stream records.
Key Features:
Usage:
class StreamHandler : DynamoStreamHandler<User>() {
override suspend fun handleRecord(record: StreamRecord<User>) {
when (record.eventName) {
INSERT -> handleNewUser(record.newImage)
MODIFY -> handleUserUpdate(record.oldImage, record.newImage)
REMOVE -> handleUserDeletion(record.oldImage)
}
}
}
EventBridge event handling. Process custom events from EventBridge.
Key Features:
Usage:
class OrderEventHandler : EventBridgeHandler<OrderEvent>() {
override suspend fun handleEvent(event: OrderEvent, context: Context) {
when (event.status) {
"pending" -> processPendingOrder(event)
"completed" -> finalizeOrder(event)
}
}
}
Kinesis stream processing. Handle high-throughput streaming data.
Key Features:
Usage:
class KinesisProcessor : KinesisHandler<SensorData>() {
override suspend fun processRecords(records: List<SensorData>) {
records.forEach { data ->
if (data.temperature > threshold) {
sendAlert(data)
}
}
}
}
SNS message processing. Handle notifications from SNS topics.
Key Features:
Usage:
class NotificationHandler : SNSHandler<Notification>() {
override suspend fun handleMessage(message: Notification, context: Context) {
sendEmail(message.recipient, message.content)
logInfo("Notification sent", "recipient" to message.recipient)
}
}
SQS message processing. Build reliable queue processors.
Key Features:
Usage:
class QueueProcessor : SQSHandler<Job>() {
override suspend fun processMessage(message: Job): ProcessingResult {
return try {
executeJob(message)
ProcessingResult.Success
} catch (e: Exception) {
ProcessingResult.Retry
}
}
}
Lambda-specific logging configuration. Enhanced logging for Lambda environments.
Key Features:
AppSync utilities and helpers. Additional tools for GraphQL API development.
Key Features:
Cognito integration utilities. Simplify user authentication and authorization.
Key Features:
Usage:
// Validate JWT token
val claims = cognito.validateToken(token)
// Get user attributes
val user = cognito.getUser(userId)
AWS testing utilities and mocks. Comprehensive testing support for AWS services.
Key Features:
Usage:
class UserServiceTest {
@Test
fun testUserCreation() = runTest {
withLocalDynamoDB { dynamo ->
val service = UserService(dynamo)
val user = service.createUser("Alice")
user.name shouldBe "Alice"
}
}
}
The project uses convention plugins for consistent build configuration:
plugins {
id("steamstreet-common.jvm-library-conventions") // For JVM-only modules
id("steamstreet-common.multiplatform-library-conventions") // For multiplatform
}
-Xcontext-receivers)./gradlew testLicensed under the Apache License 2.0. See LICENSE file for details.
FAQs
Tools for retrieving environment variables from different sources.
We found that com.steamstreet:env-js demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Socket Threat Research maps a rare inside look at OtterCookie’s npm-Vercel-GitHub chain, adding 197 malicious packages and evidence of North Korean operators.
Research
Socket researchers identified a malicious Chrome extension that manipulates Raydium swaps to inject an undisclosed SOL transfer, quietly routing fees to an attacker wallet.
Research
/Security News
Another wave of Shai-Hulud campaign has hit npm with more than 500 packages and 700+ versions affected.