Skip to main content
← back to extensions

Floci Aws

@evrardjp/floci-awsv2026.07.21.1· 4d agoMODELSWORKFLOWS
01README

Floci AWS protocol compatibility models and reproducible S3 lifecycle tests for Swamp.

02Release Notes

2026.07.21.1

Added: Fetch-based Floci health, S3 bucket, and S3 object models with typed persisted observations, conditional object operations, and a bundled S3 lifecycle workflow. Prefix deletion supports bounded fan-out cleanup with explicit truncation reporting.

Added: Local and CI protocol coverage using a pinned Floci container, the real Swamp CLI, and @swamp/s3-datastore rehydration checks. FLOCI_ENDPOINT runs the same suite against an operator-managed deployment without controlling its lifecycle.

Changed: Floci-specific models use direct path-style HTTP rather than the AWS SDK, isolating tests from a Swamp extension-bundling SDK incompatibility.

Upgrade note: This is the initial release. Docker is required only for the deno task e2e protocol suite.

03Models3
@evrardjp/floci-aws/healthv2026.07.21.1floci_health.ts
fn status()
Check Floci through /_localstack/health

Resources

health(infinite)— Latest Floci endpoint health observation
@evrardjp/floci-aws/s3-bucketv2026.07.21.1s3_bucket.ts
fn create()
Create the configured S3 bucket
fn head()
Read current bucket metadata
fn sync()
Synchronize persisted bucket state from S3
fn delete()
Delete the configured empty S3 bucket

Resources

bucket(infinite)— Observed S3 bucket lifecycle state
@evrardjp/floci-aws/s3-objectv2026.07.21.1s3_object.ts
fn put()
Put a UTF-8 object with optional conditional headers
fn head()
Read object metadata with optional conditional headers
fn get()
Get and verify object content without persisting its body
fn list(prefix?: string, maxKeys: number)
List at most 1000 objects in the configured bucket
ArgumentTypeDescription
prefix?string
maxKeysnumber
fn delete(ifMatch?: string)
Delete the object, optionally only when its ETag matches
ArgumentTypeDescription
ifMatch?string
fn deletePrefix(prefix: string, maxObjects: number)
Delete every object beneath a non-empty prefix
ArgumentTypeDescription
prefixstring
maxObjectsnumber

Resources

object(infinite)— S3 object metadata and content digest
objects(30d)— Bounded S3 object listing
deletion(30d)— Summary of a prefix-wide object deletion
04Workflows1
@evrardjp/floci-aws-smoke2d512a55-b81b-4e60-822f-8ef9a6fa56f5

Exercise the Phase 1 S3 lifecycle exclusively through Swamp model methods

s3-lifecycle
1.create-bucket
2.head-bucketfloci-smoke-bucket.head
3.put-object
4.head-objectfloci-smoke-object.head
5.get-objectfloci-smoke-object.get
6.delete-objectfloci-smoke-object.delete
7.delete-bucketfloci-smoke-bucket.delete
05Stats
A
100 / 100
Downloads
0
Archive size
17.4 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/evrardjp/swamp-extensions/tree/main/floci-aws
06Platforms
07Labels
#aws#floci#s3#testing