Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ This document provides AI agents with essential context for working on the Exten
## Project Overview

**ExtendDB** is an open source DynamoDB-compatible runtime with pluggable storage, released under the Apache 2.0
License. ExtendDB is a clean-room implementation of the DynamoDB wire protocol, written in Rust and initially developed
by AWS engineers. It is not a fork of DynamoDB and contains no DynamoDB source code. ExtendDB speaks the DynamoDB wire
License. ExtendDB is a clean-room implementation of the DynamoDB wire protocol, written in Rust and maintained
by AWS. It is not a fork of DynamoDB and contains no DynamoDB source code. ExtendDB speaks the DynamoDB wire
protocol: any AWS SDK, CLI, or tool that works with DynamoDB works with ExtendDB, unchanged.

- **Language:** Rust (edition 2024, MSRV 1.88+)
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# ExtendDB

> **ExtendDB is an independent open source project managed by Amazon Web Services. It is not Amazon DynamoDB and does
> not contain any DynamoDB source code.** "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room
> implementation that speaks the DynamoDB wire protocol. Behavioral differences from the real service are documented
> in [Differences from DynamoDB](docs/differences-from-dynamodb.md).
> **ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB
> source code. It is not an AWS service.** "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is
> a clean-room implementation that speaks the DynamoDB wire protocol. Behavioral differences from the real service are
> documented in [Differences from DynamoDB](docs/differences-from-dynamodb.md).

A DynamoDB-compatible API adapter, ExtendDB speaks the DynamoDB wire protocol — any AWS SDK, CLI, or tool that works
with DynamoDB works with ExtendDB, unchanged.
Expand Down
8 changes: 4 additions & 4 deletions crates/bin/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# ExtendDB

> **ExtendDB is an independent open source project managed by Amazon Web Services. It is not Amazon DynamoDB and does
> not contain any DynamoDB source code.** "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room
> implementation that speaks the DynamoDB wire protocol. Behavioral differences from the real service are documented
> in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).
> **ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB
> source code. It is not an AWS service.** "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is
> a clean-room implementation that speaks the DynamoDB wire protocol. Behavioral differences from the real service are
> documented in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).

ExtendDB is a DynamoDB-compatible API server. Any AWS SDK, CLI or tool that works with DynamoDB works with ExtendDB.
This crate builds the `extenddb` binary.
Expand Down
2 changes: 1 addition & 1 deletion crates/server/src/console/pages/docs_page.rs
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ pub async fn docs_page(State(state): State<Arc<ConsoleState>>) -> Response {
let mut content = String::with_capacity(4096);
content.push_str(r#"<h1>Documentation</h1>
<div class="card card-warning">
<p style="margin:0;font-size:0.9rem"><strong>extenddb is not Amazon DynamoDB.</strong> It is an independent, clean-room implementation that speaks the DynamoDB wire protocol. It is not affiliated with, endorsed by, or sponsored by Amazon Web Services. &ldquo;DynamoDB&rdquo; is a trademark of Amazon.com, Inc.</p>
<p style="margin:0;font-size:0.9rem"><strong>ExtendDB is not Amazon DynamoDB.</strong> It is a clean-room implementation that speaks the DynamoDB wire protocol. ExtendDB is an open source project maintained by AWS. It is not an AWS service. &ldquo;DynamoDB&rdquo; is a trademark of Amazon.com, Inc. or its affiliates.</p>
</div>"#);

let categories = [
Expand Down
4 changes: 2 additions & 2 deletions crates/storage-sqlite/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,8 +62,8 @@ built with that feature needs no path configured.

## Developer mode

A build-time profile that makes ExtendDB a drop-in replacement for DynamoDB
Local: plain HTTP on loopback, open authorization, and a seeded credential — with
A build-time profile that builds ExtendDB dev, a drop-in replacement for
DynamoDB Local: plain HTTP on loopback, open authorization, and a seeded credential — with
real SigV4 verification still in force. It is enabled by the `dev-mode` feature
and, by a compile-time guard, **can never be built with the Postgres backend**.

Expand Down
1 change: 0 additions & 1 deletion devtools/approved-licenses.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@

#
# Amazon pre-approved open source licenses (SPDX identifiers)
# Source: https://policy.a2z.com/docs/82475/publication#0ac159cb-89be-3e40-bc20-f67d4b2dbad0
# Last reviewed: 2026-04-20
#
# Lines starting with # are comments. Blank lines are ignored.
Expand Down
10 changes: 5 additions & 5 deletions docker/dockerhub-overview-cassandra.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,11 +113,11 @@ The same images and their signatures are mirrored by digest to

## Note

ExtendDB is an independent open source project managed by Amazon Web
Services. It is not Amazon DynamoDB and does not contain any DynamoDB source
code. "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room
implementation that speaks the DynamoDB wire protocol; behavioral differences
from the service are documented in
ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB
and does not contain any DynamoDB source code. It is not an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a
clean-room implementation that speaks the DynamoDB wire protocol; behavioral
differences from the service are documented in
[Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).

More at [extenddb.org](https://extenddb.org) and
Expand Down
2 changes: 1 addition & 1 deletion docker/dockerhub-overview-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,6 @@ The routine signer is `release-dev-image.yml`; the break-glass signer `sign-imag

## Note

ExtendDB is an independent open source project managed by Amazon Web Services. It is not Amazon DynamoDB and does not contain any DynamoDB source code. "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).
ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB source code. It is not an AWS service. "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).

More at [extenddb.org](https://extenddb.org) and [github.com/ExtendDB/extenddb](https://github.com/ExtendDB/extenddb). Licensed under Apache-2.0.
10 changes: 5 additions & 5 deletions docker/dockerhub-overview-mongodb.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,11 +106,11 @@ images and their signatures are mirrored by digest to

## Note

ExtendDB is an independent open source project managed by Amazon Web
Services. It is not Amazon DynamoDB and does not contain any DynamoDB source
code. "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room
implementation that speaks the DynamoDB wire protocol; behavioral differences
from the service are documented in
ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB
and does not contain any DynamoDB source code. It is not an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a
clean-room implementation that speaks the DynamoDB wire protocol; behavioral
differences from the service are documented in
[Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).

More at [extenddb.org](https://extenddb.org) and
Expand Down
2 changes: 1 addition & 1 deletion docker/dockerhub-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,6 @@ The signer identity separates tiers: routine backend releases are signed by `rel

## Note

ExtendDB is an independent open source project managed by Amazon Web Services. It is not Amazon DynamoDB and does not contain any DynamoDB source code. "DynamoDB" is a trademark of Amazon.com, Inc. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).
ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB source code. It is not an AWS service. "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in [Differences from DynamoDB](https://github.com/ExtendDB/extenddb/blob/main/docs/differences-from-dynamodb.md).

More at [extenddb.org](https://extenddb.org) and [github.com/ExtendDB/extenddb](https://github.com/ExtendDB/extenddb). Licensed under Apache-2.0.
4 changes: 2 additions & 2 deletions docs/NOTICE.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@

## Notice

**ExtendDB (extenddb) is not Amazon DynamoDB.** This software is an independent, clean-room implementation that provides a DynamoDB-compatible API. It does not contain, derive from, or link to any Amazon DynamoDB source code, libraries, or proprietary components.
**ExtendDB (extenddb) is not Amazon DynamoDB.** This software is a clean-room implementation that provides a DynamoDB-compatible API. It does not contain, derive from, or link to any Amazon DynamoDB source code, libraries, or proprietary components.

"DynamoDB", "Amazon DynamoDB", "AWS", and "Amazon Web Services" are trademarks of Amazon.com, Inc. or its affiliates. This project is not affiliated with, endorsed by, or sponsored by Amazon.com, Inc. or Amazon Web Services.
"DynamoDB", "Amazon DynamoDB", "AWS", and "Amazon Web Services" are trademarks of Amazon.com, Inc. or its affiliates. ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.

**No warranty.** This software is provided "as is" under the Apache License, Version 2.0, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. See [LICENSE](../LICENSE) for the full terms.

Expand Down
6 changes: 3 additions & 3 deletions docs/adr/0000-template.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,6 @@ feedback, dependency constraints, security review. One bullet per reason.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0001-documentation-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,6 @@ Markdown for all documentation.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is a trademark
of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0002-sql-injection-defense.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,6 @@ This is **not** the same as raw string interpolation of user input. The validati
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is a trademark
of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0003-catalog-migration-mechanism.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,6 +153,6 @@ be recreated and reloaded after `init`.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
11 changes: 11 additions & 0 deletions docs/adr/0004-vector-search-exact-scan.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,3 +135,14 @@ now, and gated on a measured need rather than on anticipation.
**Not measured.** Cold cache, concurrency beyond one core, and real embedding
distributions. Cold reads can only be worse; the other two do not change the
layout decision.

---

## License

Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0005-index-build-lifecycle-ownership.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,6 @@ lifecycle, which now means any backend logic that bypasses the shared module.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
8 changes: 5 additions & 3 deletions docs/adr/0006-pgvector-storage-and-scoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,11 +110,13 @@ operators, which costs a per-row unpack of every candidate and gives up any inde
on the column. That trade is worse than the documented asymmetry for an input
class no real embedding produces.

---

## License

Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
11 changes: 11 additions & 0 deletions docs/adr/0010-cassandra-ttl-expiration-queue.md
Original file line number Diff line number Diff line change
Expand Up @@ -164,3 +164,14 @@ Deliberately out of scope for this change, in rough priority order:
* **TTL alongside asynchronously propagated GSIs**, per the table above.
* **Version fence hardening.** The fence now uses the `version` column; remaining follow-up is retiring the `item_data` fallback once no unversioned rows can exist (requires a fleet-wide rewrite pass or an explicit migration), after which the canonical-JSON coupling disappears entirely.
* **Recovery-path test coverage.** The transitions this change introduced — draining a retired generation, retiring a drained bucket registration, an expired worker claim — are reasoned about but not yet covered by tests.

---

## License

Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0011-cassandra-foreign-key-emulation.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,6 @@ Application-layer pre-checks for all child entity creation operations.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0012-cassandra-transaction-atomicity-patterns.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,6 @@ Check-then-batch pattern for operations requiring both duplicate detection and a
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0013-cassandra-keyspace-awareness.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,6 @@ Dynamic keyspace construction with JDBC-style connection strings.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0014-cassandra-upsert-semantics.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,6 @@ Use natural INSERT behavior for operations requiring UPSERT semantics.
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
6 changes: 3 additions & 3 deletions docs/adr/0015-cassandra-account-keyspace-provisioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,6 @@ Create account keyspace during account creation (`ManagementStore::create_accoun
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,6 @@ Cassandra-optimized ordering: `PRIMARY KEY ((pk), sk_*, base_pk, base_sk_*)`
Copyright 2026 ExtendDB contributors. Licensed under the Apache License, Version 2.0.
See [LICENSE](../../LICENSE) for the full text.

This software is provided "as is" without warranty of any kind. ExtendDB is not
affiliated with, endorsed by, or sponsored by Amazon Web Services. "DynamoDB" is
a trademark of Amazon.com, Inc.
This software is provided "as is" without warranty of any kind. ExtendDB is an open
source project maintained by AWS. It is not Amazon DynamoDB or an AWS service.
"DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates.
Loading
Loading