@cocreate/auroradb
v1.5.0
Published
Lightweight, real-time Aurora DB CRUD wrapper and multi-tenant state routing client for the collaborative CoCreate ecosystem.
Maintainers
Readme
Cocreate Aurora DB
A highly efficient, enterprise-grade Amazon Aurora DB cluster database CRUD wrapper and state-routing backend client for the collaborative CoCreate ecosystem. This wrapper maps Aurora's powerful relational database capabilities into CoCreate's unified JSON interface.
Documentation
For a complete guide and working integration examples, refer to the CoCreate Aurora DB Documentation.
Table of Contents
- The Power of the CoCreate Unified Ecosystem
- Why Amazon Aurora?
- Installation
- Unified JSON Payload Examples
- Announcements
- Roadmap
- How to Contribute
- About
The Power of the CoCreate Unified Ecosystem
This is not just another database driver. By wrapping Amazon Aurora into the CoCreate state-routing pipeline, you unlock the full power of a multi-cloud, multi-model data orchestration mesh:
- Unified JSON Interface (MongoDB-like Syntax): You don't need to write raw SQL dialect queries or manage database-specific connection wrappers. CoCreate translates standard NoSQL JSON CRUD operations (such as
object.createorobject.read) transparently into optimized Aurora relational SQL under the hood. - Parallel Multi-Database Writing: Write to many target databases simultaneously with a single API call. You can stream transactional data to MongoDB (for instant operational state), vectorize it into Qdrant (for real-time semantic search), and store it in Amazon Aurora (for enterprise relational query processing) in perfect parallel harmony:
$$\text{Write Command} \xrightarrow{\text{Parallel Mesh}} \begin{cases} \text{MongoDB} & \text{(ACID Transaction Store)} \ \text{Qdrant} & \text{(Semantic Vector Search)} \ \text{Amazon Aurora} & \text{(Relational Cluster Engine)} \end{cases}$$
- Dynamic State-Routing: Isolate multi-tenant environments effortlessly. The routing mesh automatically injects tenant metadata and organization boundaries, ensuring isolated transactional processing within your shared Aurora infrastructure.
Why Amazon Aurora?
Amazon Aurora is a fully managed relational database engine that combines the speed and availability of high-end commercial databases with the simplicity and cost-effectiveness of open-source databases. It is up to five times faster than standard MySQL databases and three times faster than standard PostgreSQL databases.
By routing critical business logic, high-throughput transactions, and complex relational entities straight to Aurora via this wrapper, you leverage its distributed, fault-tolerant, and self-healing storage system while maintaining a zero-friction JSON pipeline.
Installation
NPM Installation
npm i @cocreate/auroradb
Yarn Installation
yarn add @cocreate/auroradb
Unified JSON Payload Examples
Here are the complete, real-world JSON objects representing raw payloads routed through the CoCreate system to Amazon Aurora.
1. Writing a Full Transaction Object (object.create)
When this operational payload is sent, CoCreate registers it, processes the nested JSON fields, and automatically routes it as structured relational records in Aurora.
{
"method": "object.create",
"storage": ["auroradb", "mongodb", "qdrant"], // Array of storages to store in parallel!
"database": "sales_analytics",
"array": "order_events",
"object": {
"_id": "order_77c8f2a9_3b01",
"customer": {
"id": "cust_88301",
"email": "[email protected]",
"region": "North America",
"acquisition_channel": "Google Search"
},
"transaction": {
"payment_method": "Credit Card",
"currency": "USD",
"subtotal": 249.99,
"discount": 15.00,
"tax": 18.80,
"total": 253.79
},
"items": [
{
"product_id": "prod_head_009",
"name": "Wireless Noise-Cancelling Headphones",
"category": "Electronics",
"quantity": 1,
"unit_price": 199.99
},
{
"product_id": "prod_stand_012",
"name": "Aluminum Headphone Stand",
"category": "Accessories",
"quantity": 2,
"unit_price": 25.00
}
],
"shipping": {
"carrier": "FedEx",
"service": "2-Day Air",
"estimated_delivery": "2026-07-20T12:00:00.000Z"
}
},
"organization_id": "org_enterprise_99x",
"user_id": "usr_sales_runner_402",
"timeStamp": "2026-07-18T18:40:43.000Z"
}
2. Reading and Filtering Warehoused Data (object.read)
Querying Aurora uses the exact same MongoDB-style filter syntax. The query below retrieves high-value orders handled by a specific shipping carrier, sorting them by total sale volume.
{
"method": "object.read",
"storage": "auroradb",
"database": "sales_analytics",
"array": "order_events",
"$filter": {
"query": {
"transaction.total": { "$gte": 100.00 },
"shipping.carrier": "FedEx"
},
"sort": [
{ "key": "transaction.total", "direction": "desc" }
],
"limit": 50,
"index": 0
},
"organization_id": "org_enterprise_99x"
}
Announcements
All updates to this library are documented in our CHANGELOG and releases. You may also subscribe to email for releases and breaking changes.
Roadmap
If you are interested in the future direction of this project, please take a look at our open issues and pull requests. We would love to hear your feedback.
How to Contribute
We encourage contribution to our libraries (you might even score some nifty swag), please see our CONTRIBUTING guide for details.
We want this library to be community-driven, and CoCreate led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create issues and pull requests or merely upvote or comment on existing issues or pull requests.
We appreciate your continued support, thank you!
About
CoCreate-auroradb is guided and supported by the CoCreate Developer Experience Team.
Please Email the Developer Experience Team here in case of any queries.
CoCreate-auroradb is maintained and funded by CoCreate. The names and logos for CoCreate are trademarks of CoCreate, LLC.
