# Weavestore - Harjot Singh Rana

Canonical URL: https://www.harjotrana.com/projects/Weavestore

> A TypeScript-based database abstraction layer published on NPM that provides traditional database operations (CRUD) on top of the IPFS/IPNS decentralized storage network. Features hierarchical organization, type-safe API, and Better Auth adapter for decentralized authentication.

## Links

- npm: https://www.npmjs.com/package/weavestore

## Stack

TypeScript, Bun, IPFS, IPNS, Lighthouse

## What I built

- Built a TypeScript DB layer for CRUD on decentralized IPFS/IPNS storage.
- Modeled Database → Schema → Table hierarchy like a classic RDBMS.
- Shipped a type-safe API with full IntelliSense for consumer apps.
- Integrated Lighthouse IPFS/IPNS uploads with retry and failover.
- Supported configurable Snowflake and UUID ID generation strategies.
- Added LRU caching with configurable TTL and size limits.
- Implemented MongoDB-style query operators for filtering records.
- Built a Better Auth adapter for decentralized auth storage.
- Supported soft and hard deletes with Lighthouse plan features.
- Added structured error codes and automatic network retries.
- Shipped batch ops: insertMany, batchGetSchemas, batchGetTables.
- Published on npm with semver and full documentation (v2.2.1).

## Key features

- CRUD on IPFS/IPNS decentralized storage
- Hierarchical Database → Schema → Table model
- Type-safe TypeScript API with IntelliSense
- Lighthouse IPFS and IPNS service support
- Configurable Snowflake or UUID IDs
- Built-in LRU caching with automatic eviction
- MongoDB-style query operators for filters
- Automatic retry and failover for network faults
- Better Auth adapter for decentralized auth
- Soft and hard delete support
- Batch insert and batch read operations
- Built with Bun for runtime performance
- Published on npm (v2.2.1) with full docs
- Path-based access with dot and slash notation

All projects: https://www.harjotrana.com/projects

---

Site guide for agents: https://www.harjotrana.com/llms.txt · Full site as Markdown: https://www.harjotrana.com/llms-full.txt · Sitemap: https://www.harjotrana.com/sitemap.xml · Developer resources: https://www.harjotrana.com/developers