Skip to content

feat(new-compiler): migrate metadata storage from lockfile to LMDB #1955

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AndreyHirsa merged 8 commits into from
Feb 12, 2026
Merged

feat(new-compiler): migrate metadata storage from lockfile to LMDB #1955

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
a1edc10
feat(new-compiler): migrate metadata storage from lockfile to LMDB
AndreyHirsa Feb 3, 2026
dc7bd46
fix(new-compiler): use correct assertion for sync constructor throw
AndreyHirsa Feb 3, 2026
b2f695f
fix(new-compiler): remove await from sync cleanupExistingMetadata calls
AndreyHirsa Feb 3, 2026
1bfb5ea
refactor(new-compiler): replace MetadataManager class with pure funct…
AndreyHirsa Feb 3, 2026
c82ee97
fix(new-compiler): optimization fixes
AndreyHirsa Feb 4, 2026
0b30991
docs(new-compiler): clarify LMDB connection lifecycle comments
AndreyHirsa Feb 6, 2026
6262f9e
fix(new-compiler): address PR review feedback for LMDB metadata storage
AndreyHirsa Feb 9, 2026
f85f968
Merge branch 'main' into feat/metadata-lmdb-storage
vrcprl Feb 12, 2026
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
9 changes: 9 additions & 0 deletions .changeset/common-teeth-reply.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
"@lingo.dev/compiler": patch
---

- Migrate metadata storage from JSON files to LMDB
- New storage locations: .lingo/metadata-dev/ and .lingo/metadata-build/
- Update compiler docs
- Remove proper-lockfile dependency
- New tests for MetadataManager
5 changes: 3 additions & 2 deletions packages/new-compiler/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -395,9 +395,10 @@ The compiler is organized into several key modules:

#### `src/metadata/` - Translation metadata management

- **`manager.ts`** - CRUD operations for `.lingo/metadata.json`
- Thread-safe metadata file operations with file locking
- **`manager.ts`** - CRUD operations for LMDB metadata database
- Uses LMDB for high-performance key-value storage with built-in concurrency
- Manages translation entries with hash-based identifiers
- Stores metadata in `.lingo/metadata-dev/` (development) or `.lingo/metadata-build/` (production)

#### `src/translators/` - Translation provider abstraction

Expand Down
6 changes: 3 additions & 3 deletions packages/new-compiler/docs/TRANSLATION_ARCHITECTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ metadata management, translation execution, and caching.

## Architectural Principles

1. **Metadata file structure** is only known by:
- Metadata Manager (reads/writes metadata.json)
1. **Metadata storage** is only known by:
- Metadata Manager (reads/writes LMDB database)
- Translation Service (orchestrator that coordinates everything)

2. **Translators are stateless** and work with abstract `TranslatableEntry` types
Expand Down Expand Up @@ -37,7 +37,7 @@ metadata management, translation execution, and caching.
↓
┌──────────────────────────────────────────────────┐
│ MetadataManager │
│ - ONLY component that reads/writes metadata.json│
│ - ONLY component that reads/writes LMDB database│
│ - Provides metadata loading/saving │
│ - Returns TranslationEntry[] │
└────────────────┬─────────────────────────────────┘
Expand Down
3 changes: 1 addition & 2 deletions packages/new-compiler/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,6 @@
"@types/babel__traverse": "7.28.0",
"@types/ini": "4.1.1",
"@types/node": "25.0.3",
"@types/proper-lockfile": "4.1.4",
"@types/react": "19.2.7",
"@types/react-dom": "19.2.3",
"@types/ws": "8.18.1",
Expand Down Expand Up @@ -178,7 +177,7 @@
"lodash": "4.17.21",
"node-machine-id": "1.1.12",
"posthog-node": "5.14.0",
"proper-lockfile": "4.1.2",
"lmdb": "3.2.6",
"ws": "8.18.3"
},
"peerDependencies": {
Expand Down
Loading