Skip to content

armgit / floci

Public Imported from GitHub
0

Light, fluffy, and always free - The AWS Local Emulator alternative

chore: release 1.5.16

Hector Ventura3be62bc1d8de
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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.13
diff --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.java
new file mode 100644
index 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.lock
index 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.java
index 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;
@ApplicationScoped
public 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.java
index 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.java
index 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());
+ }
+
@Test
void putMetricDataAutoFillsStatistics() {
service.putMetricData(NAMESPACE, List.of(datum("Requests", 5.0)), REGION);