Light, fluffy, and always free - The AWS Local Emulator alternative
chore: release 1.5.16
Hector Ventura3be62bc1d8de
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex ecf795c2a4..6c83d63433 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0## [Unreleased]+## [1.5.16] - 2026-05-15++### Added++- **stepfunctions:** `ValidateStateMachineDefinition` — validates ASL definitions and returns structured diagnostics with `/States/<state>/<field>` paths for precise error location ([#845](https://github.com/floci-io/floci/pull/845))+- **stepfunctions:** `ListTagsForResource`, `TagResource`, `UntagResource` for state machines and activities; covers both the AWS SDK (JSON 1.0) and Terraform (REST) wire paths ([#767](https://github.com/floci-io/floci/pull/767))+- **rds:** cluster parameter group actions — `CreateDBClusterParameterGroup`, `DescribeDBClusterParameterGroups`, `DeleteDBClusterParameterGroup`, `ModifyDBClusterParameterGroup`, `DescribeDBClusterParameters`; mirrors the existing instance-level parameter group shape and unblocks IaC stacks that define Aurora `ClusterParameterGroup` resources ([#838](https://github.com/floci-io/floci/pull/838))+- **s3:** full `SelectObjectContent` evaluator with floci-duck integration — recursive WHERE (AND, OR, NOT, LIKE, BETWEEN, IN, IS NULL, comparisons), JSON Lines and JSON array input formats, cross-format output (CSV→JSON, JSON→CSV), real `BytesScanned`/`BytesReturned` stats; routes CSV and JSON through floci-duck when available with a pure-Java fallback for standalone mode ([#835](https://github.com/floci-io/floci/pull/835))+- **eventbridge:** `UpdateEventBus` — update event bus description, KMS key, dead-letter config, or log config ([#834](https://github.com/floci-io/floci/pull/834))+- **ce:** AWS Cost Explorer service — `GetCostAndUsage`, `GetCostAndUsageWithResources`, `GetDimensionValues`, `GetTags`, `GetReservationCoverage`, `GetReservationUtilization`, `GetSavingsPlansCoverage`, `GetSavingsPlansUtilization`, `GetCostCategories`; cost is synthesized from existing resource state multiplied by the bundled pricing snapshot; supports `DAILY`/`MONTHLY`/`HOURLY` granularity, all standard metrics, and `GroupBy` on `DIMENSION`, `TAG`, and `COST_CATEGORY` ([#832](https://github.com/floci-io/floci/pull/832))+- **transcribe:** AWS Transcribe service — `StartTranscriptionJob`, `GetTranscriptionJob`, `ListTranscriptionJobs`, `DeleteTranscriptionJob`, `CreateVocabulary`, `GetVocabulary`, `ListVocabularies`, `UpdateVocabulary`, `DeleteVocabulary` ([#827](https://github.com/floci-io/floci/pull/827))++### Fixed++- **core:** remove AWS SDK from Floci's runtime classpath to eliminate version conflicts with user-bundled SDKs ([#846](https://github.com/floci-io/floci/pull/846))+- **core:** improve log level structure and reduce noise in hot paths ([#847](https://github.com/floci-io/floci/pull/847))+- **s3:** make `us-east-1` bucket creation idempotent — repeated `CreateBucket` calls for the same bucket in `us-east-1` no longer raise `BucketAlreadyOwnedByYou` ([#844](https://github.com/floci-io/floci/pull/844))+- **ec2:** support wildcard (`*`, `?`) filter values across all EC2 resources (VPCs, Subnets, Security Groups, Instances, Internet Gateways, Route Tables, Volumes), matching real AWS filter behavior ([#837](https://github.com/floci-io/floci/pull/837))+- **pricing:** bundle pricing snapshot resources into the native image — the Price List service was unavailable in GraalVM native builds ([#836](https://github.com/floci-io/floci/pull/836))+- **kms:** `Encrypt` now derives a fresh AES-GCM nonce per call (was deterministic, leaking plaintext equality); `Decrypt` now validates `EncryptionContext` as AAD and raises `InvalidCiphertextException` on any mismatch ([#825](https://github.com/floci-io/floci/pull/825))+- **s3:** strip `charset` parameter from `Content-Type` in XML responses ([#809](https://github.com/floci-io/floci/pull/809))+- **sqs:** FIFO `ReceiveMessage` now returns messages from multiple distinct message groups in a single call ([#785](https://github.com/floci-io/floci/pull/785))+- **sqs:** honor `AttributeNames` and `MessageSystemAttributeNames` on `ReceiveMessage` ([#784](https://github.com/floci-io/floci/pull/784))+- **sqs:** implement `AddPermission` and `RemovePermission` ([#781](https://github.com/floci-io/floci/pull/781))+- **stepfunctions:** honor `TimeoutSeconds` on `Parallel` state ([#771](https://github.com/floci-io/floci/pull/771))++### Documentation++- Improve README readability ([#831](https://github.com/floci-io/floci/pull/831))+## [1.5.15] - 2026-05-13### Added@@ -609,7 +639,8 @@ Initial public release of Floci — a fast, free, open-source local AWS emulator----[Unreleased]: https://github.com/floci-io/floci/compare/1.5.15...HEAD+[Unreleased]: https://github.com/floci-io/floci/compare/1.5.16...HEAD+[1.5.16]: https://github.com/floci-io/floci/compare/1.5.15...1.5.16[1.5.15]: https://github.com/floci-io/floci/compare/1.5.14...1.5.15[1.5.14]: https://github.com/floci-io/floci/compare/1.5.13...1.5.14[1.5.13]: https://github.com/floci-io/floci/compare/1.5.12...1.5.13diff --git a/compatibility-tests/sdk-test-java/src/test/java/com/floci/test/CWWireDebugTest.java b/compatibility-tests/sdk-test-java/src/test/java/com/floci/test/CWWireDebugTest.javanew file mode 100644index 0000000000..a252d08bac--- /dev/null+++ b/compatibility-tests/sdk-test-java/src/test/java/com/floci/test/CWWireDebugTest.java@@ -0,0 +1,61 @@+package com.floci.test;++import org.junit.jupiter.api.Test;+import software.amazon.awssdk.auth.credentials.*;+import software.amazon.awssdk.core.interceptor.*;+import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration;+import software.amazon.awssdk.regions.Region;+import software.amazon.awssdk.services.cloudwatch.CloudWatchClient;+import software.amazon.awssdk.services.cloudwatch.model.*;+import java.net.URI;+import java.time.Instant;+import java.time.temporal.ChronoUnit;+import java.util.concurrent.atomic.AtomicReference;++class CWWireDebugTest {+ @Test+ void captureRequestBody() throws Exception {+ AtomicReference<String> capturedBody = new AtomicReference<>();++ ExecutionInterceptor interceptor = new ExecutionInterceptor() {+ @Override+ public void beforeTransmission(Context.BeforeTransmission context, ExecutionAttributes attrs) {+ try {+ var req = context.httpRequest();+ if (req.getUri().toString().contains("4566")) {+ var body = context.requestBody();+ if (body.isPresent()) {+ String b = new String(body.get().contentStreamProvider().newStream().readAllBytes());+ if (b.contains("PutMetricData")) {+ capturedBody.set(b);+ System.out.println("=== SDK PutMetricData request body ===");+ System.out.println(b);+ System.out.println("===");+ }+ }+ }+ } catch (Exception e) { e.printStackTrace(); }+ }+ };++ CloudWatchClient cw = CloudWatchClient.builder()+ .endpointOverride(URI.create("http://localhost:4566"))+ .region(Region.US_EAST_1)+ .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create("test", "test")))+ .overrideConfiguration(ClientOverrideConfiguration.builder()+ .addExecutionInterceptor(interceptor).build())+ .build();++ cw.putMetricData(r -> r+ .namespace("WireDebugNS")+ .metricData(d -> d+ .metricName("WireMetric")+ .statisticValues(s -> s.sampleCount(5.0).sum(150.0).minimum(20.0).maximum(40.0))+ .unit(StandardUnit.COUNT)+ )+ );++ System.out.println("Captured: " + capturedBody.get());+ cw.close();+ }+}diff --git a/compatibility-tests/sdk-test-rust/Cargo.lock b/compatibility-tests/sdk-test-rust/Cargo.lockindex 1c48f43f7a..9e15204570 100644--- a/compatibility-tests/sdk-test-rust/Cargo.lock+++ b/compatibility-tests/sdk-test-rust/Cargo.lock@@ -362,6 +362,30 @@ dependencies = ["tracing",]+[[package]]+name = "aws-sdk-pipes"+version = "1.100.0"+source = "registry+https://github.com/rust-lang/crates.io-index"+checksum = "a4041f4bc4f3a593bafb648b88836d16268f020f243865905634a400b13f9d31"+dependencies = [+ "aws-credential-types",+ "aws-runtime",+ "aws-smithy-async",+ "aws-smithy-http",+ "aws-smithy-json",+ "aws-smithy-observability",+ "aws-smithy-runtime",+ "aws-smithy-runtime-api",+ "aws-smithy-types",+ "aws-types",+ "bytes",+ "fastrand",+ "http 0.2.12",+ "http 1.4.0",+ "regex-lite",+ "tracing",+]+[[package]]name = "aws-sdk-s3"version = "1.127.0"@@ -2306,6 +2330,7 @@ dependencies = ["aws-sdk-kinesis","aws-sdk-kms","aws-sdk-lambda",+ "aws-sdk-pipes","aws-sdk-s3","aws-sdk-secretsmanager","aws-sdk-sns",diff --git a/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsJsonHandler.java b/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsJsonHandler.javaindex 685ea1aede..1442321f04 100644--- a/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsJsonHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsJsonHandler.java@@ -1,16 +1,17 @@package io.github.hectorvent.floci.services.cloudwatch.metrics;-import io.github.hectorvent.floci.core.common.AwsErrorResponse;-import io.github.hectorvent.floci.services.cloudwatch.metrics.model.Dimension;-import io.github.hectorvent.floci.services.cloudwatch.metrics.model.MetricAlarm;-import io.github.hectorvent.floci.services.cloudwatch.metrics.model.MetricDatum;import com.fasterxml.jackson.databind.JsonNode;import com.fasterxml.jackson.databind.ObjectMapper;import com.fasterxml.jackson.databind.node.ArrayNode;import com.fasterxml.jackson.databind.node.ObjectNode;+import io.github.hectorvent.floci.core.common.AwsErrorResponse;+import io.github.hectorvent.floci.services.cloudwatch.metrics.model.Dimension;+import io.github.hectorvent.floci.services.cloudwatch.metrics.model.MetricAlarm;+import io.github.hectorvent.floci.services.cloudwatch.metrics.model.MetricDatum;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;import jakarta.ws.rs.core.Response;+import org.jboss.logging.Logger;import java.time.Instant;import java.util.ArrayList;@@ -25,6 +26,7 @@ import java.util.Map;@ApplicationScopedpublic class CloudWatchMetricsJsonHandler {+ private static final Logger LOG = Logger.getLogger(CloudWatchMetricsJsonHandler.class);private final CloudWatchMetricsService metricsService;private final ObjectMapper objectMapper;@@ -56,7 +58,10 @@ public class CloudWatchMetricsJsonHandler {private Response handlePutMetricData(JsonNode request, String region) {String namespace = request.path("Namespace").asText();+ LOG.infov("JSON PutMetricData raw: {0}", request);List<MetricDatum> datums = parseMetricDataJson(request.path("MetricData"));+ LOG.infov("JSON PutMetricData parsed {0} datums, sums={1}", datums.size(),+ datums.stream().map(d -> d.getMetricName() + "=" + d.getSum()).toList());metricsService.putMetricData(namespace, datums, region);return Response.ok(objectMapper.createObjectNode()).build();}@@ -320,7 +325,7 @@ public class CloudWatchMetricsJsonHandler {datum.setMinimum(statsValues.path("Minimum").asDouble(0));datum.setMaximum(statsValues.path("Maximum").asDouble(0));}-+datums.add(datum);}return datums;@@ -335,7 +340,9 @@ public class CloudWatchMetricsJsonHandler {return dims;}- /** Parse a JsonNode that may be a numeric epoch (long/double) or an ISO-8601 string. */+ /**+ * Parse a JsonNode that may be a numeric epoch (long/double) or an ISO-8601 string.+ */private Instant parseInstantNode(JsonNode node) {if (node == null || node.isMissingNode() || node.isNull()) return null;if (node.isNumber()) {diff --git a/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsQueryHandler.javaindex 893ca6aadd..fecc8e3804 100644--- a/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsQueryHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsQueryHandler.java@@ -289,6 +289,7 @@ public class CloudWatchMetricsQueryHandler {// ──────────────────────────── Parsing Helpers ────────────────────────────private List<MetricDatum> parseMetricData(MultivaluedMap<String, String> params) {+ LOG.infov("Query PutMetricData params: {0}", params);List<MetricDatum> datums = new ArrayList<>();for (int i = 1; ; i++) {String metricName = params.getFirst("MetricData.member." + i + ".MetricName");diff --git a/src/test/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsServiceTest.java b/src/test/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsServiceTest.javaindex b182db2ae2..969ba0356f 100644--- a/src/test/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsServiceTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/cloudwatch/metrics/CloudWatchMetricsServiceTest.java@@ -84,6 +84,30 @@ class CloudWatchMetricsServiceTest {assertEquals(1, result.size());}+ @Test+ void putMetricDataWithStatisticValues() {+ MetricDatum d = new MetricDatum();+ d.setMetricName("AggregatedMetric");+ d.setSampleCount(5.0);+ d.setSum(150.0);+ d.setMinimum(20.0);+ d.setMaximum(40.0);+ service.putMetricData(NAMESPACE, List.of(d), REGION);++ Instant start = Instant.now().minusSeconds(60);+ Instant end = Instant.now().plusSeconds(60);+ List<CloudWatchMetricsService.Datapoint> points = service.getMetricStatistics(+ NAMESPACE, "AggregatedMetric", null, start, end, 60,+ List.of("Sum", "SampleCount", "Average", "Minimum", "Maximum"), null, REGION);++ assertFalse(points.isEmpty());+ assertEquals(150.0, points.getFirst().sum());+ assertEquals(5.0, points.getFirst().sampleCount());+ assertEquals(20.0, points.getFirst().minimum());+ assertEquals(40.0, points.getFirst().maximum());+ assertEquals(30.0, points.getFirst().average());+ }+@Testvoid putMetricDataAutoFillsStatistics() {service.putMetricData(NAMESPACE, List.of(datum("Requests", 5.0)), REGION);