mirror of
https://github.com/DeBrosOfficial/orama.git
synced 2026-08-06 18:49:27 +00:00
3f2effa216
- feat(storage): server-side per-namespace byte-quota enforcement on upload + pin (bugboard #141). Rejects when (current logical usage + new bytes) × replication-factor would exceed the namespace's configured max_storage_bytes, with a typed STORAGE_QUOTA_EXCEEDED (HTTP 413) error. OPT-IN: a namespace with no namespace_quotas row (all namespaces today) is unlimited, so this ships dark and changes nothing until an operator sets a budget. Checks server-observed input size before Add (no orphan blob); fail-open on a transient quota-lookup error. Known follow-up (documented, deferred while opt-in/unused): concurrent-burst TOCTOU + fail-open hardening before GA. - feat(sdk): HttpClient.uploadFile accepts an external AbortSignal (bugboard #144). A caller abort terminates the in-flight upload at the socket and rejects with SDKError code "ABORTED" — distinct from the internal timeout ("TIMEOUT") and never retried; the retry loop also stops once the signal is aborted. IHttpTransport kept in sync.
Orama Network
A decentralized infrastructure platform combining distributed SQL, IPFS storage, caching, serverless WASM execution, and privacy relay — all managed through a unified API gateway.
Packages
| Package | Language | Description |
|---|---|---|
| core/ | Go | API gateway, distributed node, CLI, and client SDK |
| sdk/ | TypeScript | @debros/orama — JavaScript/TypeScript SDK (npm) |
| website/ | TypeScript | Marketing website and invest portal |
| vault/ | Zig | Distributed secrets vault (Shamir's Secret Sharing) |
| os/ | Go + Buildroot | OramaOS — hardened minimal Linux for network nodes |
Quick Start
# Build the core network binaries
make core-build
# Run tests
make core-test
# Start website dev server
make website-dev
# Build vault
make vault-build
Documentation
| Document | Description |
|---|---|
| Architecture | System architecture and design patterns |
| Deployment Guide | Deploy apps, databases, and domains |
| Dev & Deploy | Building, deploying to VPS, rolling upgrades |
| Security | Security hardening and threat model |
| Monitoring | Cluster health monitoring |
| Client SDK | Go SDK documentation |
| Serverless | WASM serverless functions |
| Common Problems | Troubleshooting known issues |
Contributing
See CONTRIBUTING.md for setup, development, and PR guidelines.