Light, fluffy, and always free - The AWS Local Emulator alternative
feat(floci-core): implement state reset and nuke endpoints (#1482)
Prakhar Kapoorf4c7a84de67c
diff --git a/src/main/java/io/github/hectorvent/floci/core/common/Resettable.java b/src/main/java/io/github/hectorvent/floci/core/common/Resettable.javanew file mode 100644index 0000000000..4f12b6da82--- /dev/null+++ b/src/main/java/io/github/hectorvent/floci/core/common/Resettable.java@@ -0,0 +1,9 @@+package io.github.hectorvent.floci.core.common;++/**+ * Interface for services or components that hold in-memory state+ * and need to be cleared when the emulator state is reset or nuked.+ */+public interface Resettable {+ void clear();+}diff --git a/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java b/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.javaindex 715291747c..c2a04d7c29 100644--- a/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java+++ b/src/main/java/io/github/hectorvent/floci/core/storage/StorageFactory.java@@ -100,6 +100,14 @@ public class StorageFactory {}}+ /** Clear all storage backends. */+ public void clearAll() {+ for (StorageBackend<?, ?> backend : allBackends) {+ backend.clear();+ }+ flushAll();+ }+/** Shutdown all managed backends (stop schedulers, close connections). */public void shutdownAll() {for (HybridStorage<?, ?> hybrid : hybridBackends) {diff --git a/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java b/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.javaindex 5eab37dd5d..c03f688c87 100644--- a/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java+++ b/src/main/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoController.java@@ -9,6 +9,11 @@ import jakarta.ws.rs.Produces;import jakarta.ws.rs.core.MediaType;import jakarta.ws.rs.core.Response;+import io.github.hectorvent.floci.core.storage.StorageFactory;+import io.github.hectorvent.floci.core.common.Resettable;+import jakarta.enterprise.inject.Instance;+import jakarta.ws.rs.POST;+import java.util.LinkedHashMap;import java.util.Map;@@ -20,10 +25,18 @@ public class EmulatorInfoController {private final InitLifecycleState initLifecycleState;private final String version;+ private final StorageFactory storageFactory;+ private final Instance<Resettable> resettables;+@Inject- public EmulatorInfoController(ServiceRegistry serviceRegistry, InitLifecycleState initLifecycleState) {+ public EmulatorInfoController(ServiceRegistry serviceRegistry,+ InitLifecycleState initLifecycleState,+ StorageFactory storageFactory,+ Instance<Resettable> resettables) {this.serviceRegistry = serviceRegistry;this.initLifecycleState = initLifecycleState;+ this.storageFactory = storageFactory;+ this.resettables = resettables;this.version = resolveVersion();}@@ -77,6 +90,26 @@ public class EmulatorInfoController {return Response.ok(Map.of()).build();}+ @POST+ @Path("/state/reset")+ public Response reset() {+ performReset();+ return Response.ok(Map.of("status", "OK")).build();+ }++ @POST+ @Path("/state/nuke")+ public Response nuke() {+ return reset();+ }++ private void performReset() {+ for (Resettable r : resettables) {+ r.clear();+ }+ storageFactory.clearAll();+ }+static String resolveVersion() {String env = System.getenv("FLOCI_VERSION");if (env != null && !env.isBlank()) {diff --git a/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java b/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.javaindex 7af07d9470..33fcd20672 100644--- a/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java+++ b/src/main/java/io/github/hectorvent/floci/services/apigatewayv2/websocket/WebSocketConnectionManager.java@@ -1,5 +1,6 @@package io.github.hectorvent.floci.services.apigatewayv2.websocket;+import io.github.hectorvent.floci.core.common.Resettable;import io.vertx.core.http.ServerWebSocket;import jakarta.enterprise.context.ApplicationScoped;import org.jboss.logging.Logger;@@ -12,7 +13,7 @@ import java.util.concurrent.ConcurrentHashMap;* Tracks connection metadata and live socket references.*/@ApplicationScoped-public class WebSocketConnectionManager {+public class WebSocketConnectionManager implements Resettable {private static final Logger LOG = Logger.getLogger(WebSocketConnectionManager.class);@@ -46,6 +47,17 @@ public class WebSocketConnectionManager {LOG.debugv("Unregistered WebSocket connection {0}", connectionId);}+ public void clear() {+ sockets.values().forEach(ws -> {+ try {+ ws.close();+ } catch (Exception ignored) {}+ });+ connections.clear();+ sockets.clear();+ serverInitiatedCloses.clear();+ }+/*** Send a text message to the specified connection.*diff --git a/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java b/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.javaindex 9215c86ec1..e325eba88c 100644--- a/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java+++ b/src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2HealthChecker.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.services.elbv2;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.ec2.Ec2Service;import io.github.hectorvent.floci.services.elbv2.model.TargetDescription;import io.github.hectorvent.floci.services.elbv2.model.TargetGroup;@@ -18,7 +19,7 @@ import java.util.Map;import java.util.concurrent.ConcurrentHashMap;@ApplicationScoped-public class ElbV2HealthChecker {+public class ElbV2HealthChecker implements Resettable {private static final Logger LOG = Logger.getLogger(ElbV2HealthChecker.class);@@ -71,6 +72,12 @@ public class ElbV2HealthChecker {states.remove(tgArn);}+ public void clear() {+ timers.values().forEach(vertx::cancelTimer);+ timers.clear();+ states.clear();+ }+public void addTargets(String tgArn, List<TargetDescription> targets, TargetGroup tg) {if (config.services().elbv2().mock()) {return;diff --git a/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java b/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.javaindex 367f81fa45..db0150ddf2 100644--- a/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java+++ b/src/main/java/io/github/hectorvent/floci/services/eventbridge/RuleScheduler.java@@ -3,6 +3,7 @@ package io.github.hectorvent.floci.services.eventbridge;import com.fasterxml.jackson.databind.ObjectMapper;import com.fasterxml.jackson.databind.node.ObjectNode;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.eventbridge.model.Rule;import io.github.hectorvent.floci.services.eventbridge.model.RuleState;import io.github.hectorvent.floci.services.eventbridge.model.Target;@@ -20,7 +21,7 @@ import java.util.concurrent.ConcurrentHashMap;import java.util.function.Supplier;@ApplicationScoped-public class RuleScheduler {+public class RuleScheduler implements Resettable {private static final Logger LOG = Logger.getLogger(RuleScheduler.class);@@ -48,6 +49,11 @@ public class RuleScheduler {LOG.info("RuleScheduler shut down, all timers cancelled");}+ public void clear() {+ scheduleContexts.values().forEach(ctx -> vertx.cancelTimer(ctx.timerId));+ scheduleContexts.clear();+ }+public void startScheduler(String ruleArn, String scheduleExpr,Supplier<ScheduleData> dataSupplier) {if (scheduleContexts.containsKey(ruleArn)) {diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.javaindex a0e3391e27..dc9c3ef36b 100644--- a/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/DynamoDbStreamsEventSourcePoller.java@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.lambda;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsException;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.dynamodb.DynamoDbStreamService;import io.github.hectorvent.floci.services.dynamodb.model.DynamoDbStreamRecord;import io.github.hectorvent.floci.services.lambda.model.EventSourceMapping;@@ -23,7 +24,7 @@ import java.util.concurrent.ExecutorService;import java.util.concurrent.Executors;@ApplicationScoped-public class DynamoDbStreamsEventSourcePoller {+public class DynamoDbStreamsEventSourcePoller implements Resettable {private static final Logger LOG = Logger.getLogger(DynamoDbStreamsEventSourcePoller.class);@@ -74,6 +75,12 @@ public class DynamoDbStreamsEventSourcePoller {timerIds.clear();}+ public void clear() {+ timerIds.values().forEach(vertx::cancelTimer);+ timerIds.clear();+ activePolls.clear();+ }+public void startPolling(EventSourceMapping esm) {if (timerIds.containsKey(esm.getUuid())) {return;diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.javaindex b594661175..b9d951ed35 100644--- a/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/KinesisEventSourcePoller.java@@ -5,6 +5,7 @@ import com.fasterxml.jackson.databind.node.ObjectNode;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;import io.github.hectorvent.floci.core.common.AwsException;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.kinesis.KinesisService;import io.github.hectorvent.floci.services.kinesis.model.KinesisRecord;import io.github.hectorvent.floci.services.kinesis.model.KinesisShard;@@ -27,7 +28,7 @@ import java.util.concurrent.ExecutorService;import java.util.concurrent.Executors;@ApplicationScoped-public class KinesisEventSourcePoller {+public class KinesisEventSourcePoller implements Resettable {private static final Logger LOG = Logger.getLogger(KinesisEventSourcePoller.class);@@ -77,6 +78,12 @@ public class KinesisEventSourcePoller {timerIds.clear();}+ public void clear() {+ timerIds.values().forEach(vertx::cancelTimer);+ timerIds.clear();+ activePolls.clear();+ }+public void startPolling(EventSourceMapping esm) {if (timerIds.containsKey(esm.getUuid())) return;String uuid = esm.getUuid();diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.javaindex b8ecd1fdca..28fb82a12e 100644--- a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaConcurrencyLimiter.java@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.lambda;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsException;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.lambda.model.LambdaFunction;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;@@ -33,7 +34,7 @@ import java.util.concurrent.atomic.AtomicInteger;* </ul>*/@ApplicationScoped-public class LambdaConcurrencyLimiter {+public class LambdaConcurrencyLimiter implements Resettable {private static final Logger LOG = Logger.getLogger(LambdaConcurrencyLimiter.class);/** Tracks malformed ARNs already logged so the warn fires once per unique input. */@@ -238,6 +239,15 @@ public class LambdaConcurrencyLimiter {}}+ public void clear() {+ synchronized (reservedLock) {+ inflight.clear();+ reservedByRegion.clear();+ regionReservedTotal.clear();+ unreservedByRegion.clear();+ }+ }+public int totalReserved(String region) {return regionTotal(region).get();}diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.javaindex c88af06b4f..8958f6cb05 100644--- a/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaFunctionStore.java@@ -1,5 +1,6 @@package io.github.hectorvent.floci.services.lambda;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.storage.AccountAwareStorageBackend;import io.github.hectorvent.floci.core.storage.StorageBackend;import io.github.hectorvent.floci.core.storage.StorageFactory;@@ -16,7 +17,7 @@ import java.util.concurrent.ConcurrentHashMap;* Wraps the storage backend for Lambda functions with region-aware key logic.*/@ApplicationScoped-public class LambdaFunctionStore {+public class LambdaFunctionStore implements Resettable {private final StorageBackend<String, LambdaFunction> backend;private final ConcurrentHashMap<String, LambdaFunction> urlIdIndex = new ConcurrentHashMap<>();@@ -41,6 +42,10 @@ public class LambdaFunctionStore {all.forEach(this::indexFunction);}+ public void clear() {+ urlIdIndex.clear();+ }+private void indexFunction(LambdaFunction fn) {if (fn.getUrlConfig() != null && fn.getUrlConfig().getFunctionUrl() != null) {String urlId = extractUrlId(fn.getUrlConfig().getFunctionUrl());diff --git a/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java b/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.javaindex 637113e401..894fea7a4b 100644--- a/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java+++ b/src/main/java/io/github/hectorvent/floci/services/lambda/SqsEventSourcePoller.java@@ -4,6 +4,7 @@ import com.fasterxml.jackson.databind.ObjectMapper;import com.fasterxml.jackson.databind.node.ObjectNode;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.services.lambda.model.EventSourceMapping;import io.github.hectorvent.floci.services.lambda.model.InvocationType;@@ -31,7 +32,7 @@ import java.util.concurrent.Executors;* to avoid a circular CDI dependency.*/@ApplicationScoped-public class SqsEventSourcePoller {+public class SqsEventSourcePoller implements Resettable {private static final Logger LOG = Logger.getLogger(SqsEventSourcePoller.class);@@ -89,6 +90,12 @@ public class SqsEventSourcePoller {LOG.info("SqsEventSourcePoller shut down, all timers cancelled");}+ public void clear() {+ timerIds.values().forEach(vertx::cancelTimer);+ timerIds.clear();+ activePolls.clear();+ }+public void startPolling(EventSourceMapping esm) {if (timerIds.containsKey(esm.getUuid())) {return; // already pollingdiff --git a/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java b/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.javaindex e93a139e03..2ee48463ef 100644--- a/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java+++ b/src/main/java/io/github/hectorvent/floci/services/pipes/PipesPoller.java@@ -7,6 +7,7 @@ import com.fasterxml.jackson.databind.node.ObjectNode;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;import io.github.hectorvent.floci.core.common.AwsException;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.dynamodb.DynamoDbStreamService;import io.github.hectorvent.floci.services.kinesis.KinesisService;import io.github.hectorvent.floci.services.pipes.model.DesiredState;@@ -38,7 +39,7 @@ import java.util.concurrent.ExecutorService;import java.util.concurrent.Executors;@ApplicationScoped-public class PipesPoller {+public class PipesPoller implements Resettable {private static final Logger LOG = Logger.getLogger(PipesPoller.class);private static final long POLL_INTERVAL_MS = 1000;@@ -92,6 +93,14 @@ public class PipesPoller {LOG.info("PipesPoller shut down");}+ public void clear() {+ timerIds.values().forEach(vertx::cancelTimer);+ timerIds.clear();+ activePolls.clear();+ kinesisIterators.clear();+ dynamoDbIterators.clear();+ }+public void startPolling(Pipe pipe) {String pipeKey = pipeKey(pipe);if (timerIds.containsKey(pipeKey)) {diff --git a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.javaindex 22335ca458..47dabd2cce 100644--- a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java+++ b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java@@ -26,6 +26,7 @@ import io.github.hectorvent.floci.services.rds.model.DbSubnetGroup;import io.github.hectorvent.floci.services.rds.proxy.RdsProxyManager;import io.github.hectorvent.floci.services.secretsmanager.SecretsManagerService;import io.github.hectorvent.floci.services.secretsmanager.model.Secret;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;import org.jboss.logging.Logger;@@ -48,7 +49,7 @@ import java.util.regex.Pattern;* Starts DB containers and auth proxies on creation.*/@ApplicationScoped-public class RdsService {+public class RdsService implements Resettable {private static final Logger LOG = Logger.getLogger(RdsService.class);private static final ObjectMapper JSON = new ObjectMapper();@@ -143,6 +144,10 @@ public class RdsService {restoreInstances();}+ public void clear() {+ usedPorts.clear();+ }+// ── DB Instances ──────────────────────────────────────────────────────────public DbInstance createDbInstance(String id, String engineParam, String engineVersion,diff --git a/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java b/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.javaindex 927fc16c84..24f015b67b 100644--- a/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java+++ b/src/main/java/io/github/hectorvent/floci/services/rdsdata/RdsDataService.java@@ -8,6 +8,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.services.secretsmanager.SecretsManagerService;import io.github.hectorvent.floci.services.secretsmanager.model.SecretVersion;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.annotation.PostConstruct;import jakarta.annotation.PreDestroy;import jakarta.enterprise.context.ApplicationScoped;@@ -29,7 +30,7 @@ import java.util.concurrent.ScheduledExecutorService;import java.util.concurrent.TimeUnit;@ApplicationScoped-public class RdsDataService {+public class RdsDataService implements Resettable {private static final Logger LOG = Logger.getLogger(RdsDataService.class);@@ -88,6 +89,18 @@ public class RdsDataService {});}+ public void clear() {+ transactions.forEach((id, tx) -> {+ synchronized (tx) {+ if (transactions.remove(id, tx)) {+ rollbackQuietly(tx.connection);+ closeQuietly(tx.connection);+ }+ }+ });+ transactions.clear();+ }+public ObjectNode executeStatement(JsonNode request, String region) {rejectUnsupportedOptions(request);diff --git a/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java b/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.javaindex c4f47eb491..a7599ecb7a 100644--- a/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java+++ b/src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingService.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.services.resourcegroupstagging;import io.github.hectorvent.floci.services.resourcegroupstagging.model.ResourceTagMapping;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.enterprise.context.ApplicationScoped;import java.nio.charset.StandardCharsets;@@ -9,7 +10,7 @@ import java.util.concurrent.ConcurrentHashMap;import java.util.stream.Collectors;@ApplicationScoped-public class ResourceGroupsTaggingService {+public class ResourceGroupsTaggingService implements Resettable {// region::arn → ResourceTagMappingprivate final Map<String, ResourceTagMapping> store = new ConcurrentHashMap<>();@@ -44,6 +45,10 @@ public class ResourceGroupsTaggingService {}}+ public void clear() {+ store.clear();+ }+// ─── GetResources ──────────────────────────────────────────────────────────public record TagFilter(String key, List<String> values) {}diff --git a/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java b/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.javaindex 0ed35e2b70..fb5e5d24c0 100644--- a/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java+++ b/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java@@ -7,6 +7,7 @@ import io.github.hectorvent.floci.core.common.AwsNamespaces;import io.github.hectorvent.floci.core.common.RegionResolver;import io.github.hectorvent.floci.core.common.XmlBuilder;import io.github.hectorvent.floci.core.common.XmlParser;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.storage.StorageBackend;import io.github.hectorvent.floci.core.storage.StorageFactory;import io.github.hectorvent.floci.services.lambda.LambdaService;@@ -40,7 +41,7 @@ import java.util.*;import java.util.concurrent.ConcurrentHashMap;@ApplicationScoped-public class S3Service {+public class S3Service implements Resettable {private String ownerId() { return regionResolver != null ? regionResolver.getAccountId() : "000000000000"; }private static final String DEFAULT_OWNER_DISPLAY_NAME = "floci";private static final String ALL_USERS_GROUP_URI = "http://acs.amazonaws.com/groups/global/AllUsers";@@ -159,6 +160,12 @@ public class S3Service {}}+ public void clear() {+ memoryDataStore.clear();+ memoryMultipartStore.clear();+ multipartUploads.clear();+ }+public Bucket createBucket(String bucketName, String region) {var existing = bucketStore.get(bucketName);if (existing.isPresent()) {diff --git a/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java b/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.javaindex bb276a7101..7f6734670c 100644--- a/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java+++ b/src/main/java/io/github/hectorvent/floci/services/scheduler/ScheduleDispatcher.java@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.scheduler;import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.services.scheduler.SchedulerExpressionParser.Kind;import io.github.hectorvent.floci.services.scheduler.model.Schedule;import io.quarkus.runtime.ShutdownEvent;@@ -40,7 +41,7 @@ import java.util.concurrent.TimeUnit;* </ul>*/@ApplicationScoped-public class ScheduleDispatcher {+public class ScheduleDispatcher implements Resettable {private static final Logger LOG = Logger.getLogger(ScheduleDispatcher.class);@@ -81,6 +82,11 @@ public class ScheduleDispatcher {executor.shutdownNow();}+ public void clear() {+ lastFireByArn.clear();+ firedOnceByArn.clear();+ }+void tickSafely() {try {tick(Instant.now());diff --git a/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java b/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.javaindex 62f1c94fa1..fdb1ff1043 100644--- a/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java+++ b/src/main/java/io/github/hectorvent/floci/services/sns/SnsService.java@@ -4,6 +4,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.core.common.RegionResolver;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.storage.StorageBackend;import io.github.hectorvent.floci.core.storage.StorageFactory;import io.github.hectorvent.floci.services.lambda.LambdaService;@@ -50,7 +51,7 @@ import java.util.concurrent.ConcurrentHashMap;import java.util.concurrent.ConcurrentLinkedDeque;@ApplicationScoped-public class SnsService {+public class SnsService implements Resettable {private static final Logger LOG = Logger.getLogger(SnsService.class);private static final Duration FIFO_DEDUP_WINDOW = Duration.ofMinutes(5);@@ -159,6 +160,11 @@ public class SnsService {this.httpClient = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(5)).build();}+ public void clear() {+ pushCapture.clear();+ fifoDeduplicationCache.clear();+ }+public Topic createTopic(String name, Map<String, String> attributes,Map<String, String> tags, String region) {if (name == null || name.isBlank()) {diff --git a/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java b/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.javaindex 489df886fe..ff0ff5327c 100644--- a/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java+++ b/src/main/java/io/github/hectorvent/floci/services/sqs/SqsService.java@@ -4,6 +4,7 @@ import io.github.hectorvent.floci.config.EmulatorConfig;import io.github.hectorvent.floci.core.common.AwsArnUtils;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.core.common.RegionResolver;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.storage.AccountAwareStorageBackend;import io.github.hectorvent.floci.core.storage.StorageBackend;import io.github.hectorvent.floci.core.storage.StorageFactory;@@ -26,7 +27,7 @@ import java.util.concurrent.ConcurrentHashMap;import java.util.concurrent.atomic.AtomicLong;@ApplicationScoped-public class SqsService {+public class SqsService implements Resettable {private static final Logger LOG = Logger.getLogger(SqsService.class);private static final int DEDUP_WINDOW_SECONDS = 300; // 5 minutes@@ -128,6 +129,17 @@ public class SqsService {loadPersistedDedup();}+ public void clear() {+ messagesByQueue.values().forEach(GuardedMessageQueue::close);+ messagesByQueue.clear();+ queueLocks.clear();+ redrivePolicyCache.clear();+ deduplicationCache.clear();+ moveTaskCancellation.values().forEach(flag -> flag.set(true));+ moveTaskCancellation.clear();+ moveTasksByHandle.clear();+ }+private void loadPersistedMessages() {if (messageStore == null) {return;diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.javaindex 37d648f345..f43abc68e7 100644--- a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmCommandService.java@@ -7,6 +7,7 @@ import com.fasterxml.jackson.databind.node.ArrayNode;import com.fasterxml.jackson.databind.node.ObjectNode;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.core.common.RegionResolver;+import io.github.hectorvent.floci.core.common.Resettable;import io.github.hectorvent.floci.core.storage.StorageBackend;import io.github.hectorvent.floci.core.storage.StorageFactory;import io.github.hectorvent.floci.services.ssm.model.Command;@@ -37,7 +38,7 @@ import java.util.concurrent.Executors;* - GetMessages / AcknowledgeMessage / SendReply / FailMessage / DeleteMessage (ec2messages, agent side)*/@ApplicationScoped-public class SsmCommandService {+public class SsmCommandService implements Resettable {private static final Logger LOG = Logger.getLogger(SsmCommandService.class);private static final int MIN_TIMEOUT_SECONDS = 30;@@ -76,6 +77,11 @@ public class SsmCommandService {});}+ public void clear() {+ messageQueues.clear();+ messageIndex.clear();+ }+// ── Agent registration ──────────────────────────────────────────────────public void updateInstanceInformation(JsonNode request, String region) {diff --git a/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java b/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.javaindex d3034a3008..13c6845738 100644--- a/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java+++ b/src/main/java/io/github/hectorvent/floci/services/stepfunctions/StepFunctionsService.java@@ -12,6 +12,7 @@ import io.github.hectorvent.floci.services.stepfunctions.model.ActivityTask;import io.github.hectorvent.floci.services.stepfunctions.model.Execution;import io.github.hectorvent.floci.services.stepfunctions.model.HistoryEvent;import io.github.hectorvent.floci.services.stepfunctions.model.StateMachine;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;import org.jboss.logging.Logger;@@ -29,7 +30,7 @@ import java.util.regex.Matcher;import java.util.regex.Pattern;@ApplicationScoped-public class StepFunctionsService {+public class StepFunctionsService implements Resettable {private static final Logger LOG = Logger.getLogger(StepFunctionsService.class);@@ -62,6 +63,13 @@ public class StepFunctionsService {this.objectMapper = objectMapper;}+ public void clear() {+ historyCache.clear();+ activityQueues.clear();+ pendingTaskTokens.values().forEach(f -> f.completeExceptionally(new RuntimeException("StepFunctionsService cleared")));+ pendingTaskTokens.clear();+ }+// ──────────────────────────── State Machines ────────────────────────────public StateMachine createStateMachine(String name, String definition, String roleArn, String type, String region, Map<String, String> tags) {diff --git a/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java b/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.javaindex 1f1841e83d..e01571746e 100644--- a/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java+++ b/src/main/java/io/github/hectorvent/floci/services/textract/TextractService.java@@ -3,6 +3,7 @@ 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.AwsException;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;import jakarta.ws.rs.core.Response;@@ -17,7 +18,7 @@ import java.util.concurrent.ConcurrentHashMap;* @see <a href="https://docs.aws.amazon.com/textract/latest/dg/API_Operations.html">Textract API Reference</a>*/@ApplicationScoped-public class TextractService {+public class TextractService implements Resettable {static final String MODEL_VERSION = "1.0";private final ObjectMapper objectMapper;/** In-memory async job store: jobId to jobType ("TEXT_DETECTION" or "DOCUMENT_ANALYSIS"). */@@ -26,6 +27,9 @@ public class TextractService {public TextractService(ObjectMapper objectMapper) {this.objectMapper = objectMapper;}+ public void clear() {+ asyncJobs.clear();+ }/*** DetectDocumentText — returns a stub PAGE + LINE + WORD block hierarchy.* Response shape: https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.htmldiff --git a/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java b/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.javaindex fe9793fcc5..6269b09988 100644--- a/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java+++ b/src/main/java/io/github/hectorvent/floci/services/transcribe/TranscribeService.java@@ -7,6 +7,7 @@ import io.github.hectorvent.floci.core.storage.StorageFactory;import io.github.hectorvent.floci.services.transcribe.model.TranscriptionJob;import io.github.hectorvent.floci.services.transcribe.model.TranscriptionJobSummary;import io.github.hectorvent.floci.services.transcribe.model.VocabularyInfo;+import io.github.hectorvent.floci.core.common.Resettable;import jakarta.annotation.PostConstruct;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;@@ -24,7 +25,7 @@ import java.util.concurrent.ConcurrentHashMap;* @see <a href="https://docs.aws.amazon.com/transcribe/latest/APIReference/Welcome.html">Transcribe API</a>*/@ApplicationScoped-public class TranscribeService {+public class TranscribeService implements Resettable {private final StorageFactory storageFactory;@@ -46,6 +47,11 @@ public class TranscribeService {"transcribe-vocabularies.json", new TypeReference<Map<String, VocabularyInfo>>() {}));}+ public void clear() {+ transcriptionJobs.clear();+ vocabularies.clear();+ }+public TranscriptionJob startTranscriptionJob(String jobName, String mediaFileUri,String languageCode, String mediaFormat) {requireNonBlank(jobName, "TranscriptionJobName");diff --git a/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.javaindex 3ef273dbf9..367e7340f8 100644--- a/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java+++ b/src/test/java/io/github/hectorvent/floci/lifecycle/EmulatorInfoControllerIntegrationTest.java@@ -1,8 +1,10 @@package io.github.hectorvent.floci.lifecycle;-import com.fasterxml.jackson.databind.JsonNode;-import com.fasterxml.jackson.databind.ObjectMapper;+import io.github.hectorvent.floci.testing.RestAssuredJsonUtils;import io.quarkus.test.junit.QuarkusTest;+import com.fasterxml.jackson.databind.ObjectMapper;+import com.fasterxml.jackson.databind.JsonNode;+import org.junit.jupiter.api.BeforeAll;import org.junit.jupiter.params.ParameterizedTest;import org.junit.jupiter.params.provider.ValueSource;import org.junit.jupiter.api.Test;@@ -18,6 +20,11 @@ class EmulatorInfoControllerIntegrationTest {private static final ObjectMapper MAPPER = new ObjectMapper();+ @BeforeAll+ static void configureRestAssured() {+ RestAssuredJsonUtils.configureAwsContentTypes();+ }+// Core services that must always be present and running.// New services can be added to Floci without updating this list —// the test verifies all known services are present, not an exact set.@@ -97,4 +104,71 @@ class EmulatorInfoControllerIntegrationTest {void config_returns200OnBothPaths(String path) {given().when().get(path).then().statusCode(200).contentType("application/json");}++ @ParameterizedTest+ @ValueSource(strings = {"/_floci/state/reset", "/_localstack/state/reset", "/_floci/state/nuke", "/_localstack/state/nuke"})+ void stateReset_returnsOkOnAllPaths(String path) {+ given()+ .when().post(path)+ .then()+ .statusCode(200)+ .contentType("application/json")+ .body("status", equalTo("OK"));+ }++ @Test+ void stateReset_clearsDatabaseState() {+ // 1. Put SSM parameter+ given()+ .header("X-Amz-Target", "AmazonSSM.PutParameter")+ .contentType("application/x-amz-json-1.1")+ .body("""+ {+ "Name": "/test/parameter/to/be/reset",+ "Value": "should-be-gone",+ "Type": "String"+ }+ """)+ .when()+ .post("/")+ .then()+ .statusCode(200);++ // 2. Verify parameter exists+ given()+ .header("X-Amz-Target", "AmazonSSM.GetParameter")+ .contentType("application/x-amz-json-1.1")+ .body("""+ {+ "Name": "/test/parameter/to/be/reset"+ }+ """)+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("Parameter.Value", equalTo("should-be-gone"));++ // 3. Trigger state reset+ given()+ .when().post("/_floci/state/reset")+ .then()+ .statusCode(200)+ .body("status", equalTo("OK"));++ // 4. Verify parameter is deleted and no longer exists+ given()+ .header("X-Amz-Target", "AmazonSSM.GetParameter")+ .contentType("application/x-amz-json-1.1")+ .body("""+ {+ "Name": "/test/parameter/to/be/reset"+ }+ """)+ .when()+ .post("/")+ .then()+ .statusCode(400)+ .body("__type", equalTo("ParameterNotFound"));+ }}