Initial commit: EntglDb Node.js implementation with Sync, Gossip and React Native mobile app

Author: mrdevrobot

.gitignore

@@ -0,0 +1,50 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build outputs
+dist/
+build/
+coverage/
+.nyc_output/
+*.tsbuildinfo
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Environment
+.env
+.env.local
+.DS_Store
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# React Native / Metro
+.metro/
+.watchmanconfig
+
+# Android
+android/local.properties
+android/.gradle/
+android/build/
+android/app/build/
+android/*/build/
+**/*.keystore
+!android/app/debug.keystore
+
+# iOS
+ios/build/
+ios/Pods/
+ios/*.xcworkspace
+ios/*.xcodeproj/project.xcworkspace
+ios/*.xcodeproj/xcuserdata
+ios/.xcode.env.local
+**.orig

.npmrc

@@ -0,0 +1 @@
+node-linker=hoisted

README.md

@@ -0,0 +1,119 @@
+# EntglDb.NodeJs
+
+Pure JavaScript/TypeScript implementation of EntglDb - A peer-to-peer distributed database with offline-first capabilities.
+
+## 🚀 Quick Start
+
+### Run the Interactive Demo
+
+```bash
+# Windows
+run-demo.bat
+
+# macOS/Linux
+./run-demo.sh
+```
+
+### Run Electron Desktop App
+
+```bash
+# Windows
+run-electron.bat
+
+# macOS/Linux
+./run-electron.sh
+```
+
+### Run React Native Mobile App
+
+```bash
+# Windows
+run-react-native.bat
+
+# macOS/Linux
+./run-react-native.sh
+```
+
+Or manually:
+```bash
+cd apps/demo
+pnpm install
+pnpm demo
+```
+
+## 📦 Packages
+
+- **@entgldb/protocol** - Protocol Buffers definitions
+- **@entgldb/core** - Core database engine (HLC, CRDT, Collections)
+- **@entgldb/persistence-sqlite** - SQLite storage adapter
+- **@entgldb/network** - P2P networking (TCP, WebSocket)
+
+## 🎯 Sample Applications
+
+### Electron Desktop App
+```bash
+cd apps/sample-electron
+pnpm install
+pnpm dev
+```
+
+### React Native Mobile App
+```bash
+cd apps/sample-react-native
+pnpm install
+cd ios && pod install && cd ..
+pnpm ios    # or pnpm android
+```
+
+## 🏗️ Development
+
+### Install Dependencies
+```bash
+pnpm install
+```
+
+### Build All Packages
+```bash
+pnpm build
+```
+
+### Run Tests
+```bash
+pnpm test
+```
+
+## 📚 Documentation
+
+See [walkthrough.md](file:///C:/Users/FABLUA/.gemini/antigravity/brain/95865bf1-3161-4920-ac82-d76d69e924cd/walkthrough.md) for comprehensive documentation.
+
+## ✨ Features
+
+- ✅ **Hybrid Logical Clocks (HLC)** for distributed ordering
+- ✅ **Last-Write-Wins (LWW)** conflict resolution
+- ✅ **SQLite** persistence with WAL mode
+- ✅ **P2P Sync** via TCP with Protocol Buffers
+- ✅ **Multi-platform**: Node.js, Electron, React Native
+- ✅ **Type-safe** TypeScript API
+
+## 🔧 Architecture
+
+```
+EntglDb.NodeJs/
+├── packages/
+│   ├── protocol/          # Protobuf definitions
+│   ├── core/             # Database engine
+│   ├── persistence-sqlite/ # SQLite adapter
+│   └── network/          # P2P networking
+└── apps/
+    ├── demo/             # CLI demo
+    ├── sample-electron/  # Desktop app
+    └── sample-react-native/ # Mobile app
+```
+
+## 🔗 Protocol Compatibility
+
+Compatible with EntglDb.NET v0.4.0 - Can sync with .NET nodes!
+
+## 📄 License
+
+MIT