hyper-spatial-index

Novel Spatial Index for P2P: - Uses a simple but effective quadtree-inspired grid persisted in Hyperbee - Supports insert, range query, nearest neighbor - Integrates with Hyperswarm for peer location announcements

Category: Indexes & search

Composes with: hyper-p2p-semantic-vector-index, hyper-p2p-intent-router

Protocol: hyper-spatial-index/v1

When to use

Geo-fenced queries, nearest-neighbor search in apps and demos.

When not to use

Distributed spatial sharding (use intent-router + app-specific partitioning).

Quick start

const { SpatialIndex } = require('hyper-spatial-index')
const topic = process.argv[2] // 64-char hex or string
const mod = new SpatialIndex({ topic, enableBackgroundTimers: false })
await mod.ready()   // joins swarm when topic set
// ... application logic ...
await mod.close()

Docs

docs/api.md — constructor, methods, events, errors
docs/architecture.md — wire types, state, composition
../_shared/PRODUCTION.md — production checklist
../_shared/DOC_STANDARDS.md — documentation standards
Integration: ../../real_tests/integration/ — spatial-index-two-node.js

Test

npm install && npm test