Logo
HARJOT SINGH RANA
© 2025 Harjot Singh Rana
Project

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.

Weavestore

Key Features

Feature 01

Database-like CRUD operations on IPFS/IPNS decentralized storage

Feature 02

Hierarchical structure: Database → Schema → Table organization

Feature 03

Type-safe TypeScript API with full IntelliSense support

Feature 04

Support for Lighthouse IPFS and IPNS services

Feature 05

Configurable ID generation (Snowflake or UUID)

Feature 06

Built-in LRU caching with automatic eviction

Feature 07

MongoDB-style query operators for advanced filtering

Feature 08

Automatic retry and failover for network resilience

Feature 09

Better Auth adapter for decentralized authentication

Feature 010

Soft and hard delete capabilities

Feature 011

Batch operations for bulk inserts and queries

Feature 012

Built with Bun for optimal performance

Feature 013

Published on NPM (v2.2.1) with comprehensive documentation

Feature 014

Path-based access with dot and slash notation

My Contribution

  • 01

    Developed a complete database abstraction layer from scratch for decentralized IPFS/IPNS storage.

  • 02

    Implemented hierarchical database structure (Database → Schema → Table) similar to traditional RDBMS.

  • 03

    Built type-safe TypeScript API with full IntelliSense support for enhanced developer experience.

  • 04

    Integrated Lighthouse for IPFS uploads and IPNS publishing with automatic retry and failover.

  • 05

    Implemented configurable ID generation supporting both Snowflake and UUID strategies.

  • 06

    Built LRU caching system with configurable TTL and size limits for optimal performance.

  • 07

    Developed MongoDB-style query operators ($eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $regex, $or, $and, $not).

  • 08

    Created Better Auth adapter enabling decentralized authentication storage on IPFS/IPNS.

  • 09

    Implemented soft and hard delete capabilities with Lighthouse Annual Plan support.

  • 10

    Built comprehensive error handling with specific error codes and automatic retry mechanisms.

  • 11

    Developed batch operations (insertMany, batchGetSchemas, batchGetTables) for efficient bulk operations.

  • 12

    Published and maintained package on NPM with semantic versioning and comprehensive documentation.

Next Up

More Projects

View all archive