remotestorage-module-places/AGENTS.md

AGENTS.md

Project Overview

This repository contains a remoteStorage data module for managing saved places/POIs (Points of Interest). It is written in TypeScript and compiled to a JavaScript module suitable for use with remotestorage.js.

Tech Stack

• Language: TypeScript (Target ES2020, ESNext modules)
• Core Library: remotestoragejs (Peer dependency)
• Key Utilities:
  • ulid for generating unique IDs
  • latlon-geohash for geohashing logic
• Package Manager: pnpm

Setup & Build

• Install dependencies: pnpm install
• Build project: pnpm run build
  • Cleans dist/ and runs the TypeScript compiler (tsc).
  • Output files (.js and .d.ts) are generated in the dist/ directory.

Code Style & Conventions

• TypeScript: Strict mode is enabled ("strict": true).
• Module System: ESNext modules with bundler resolution.
• Project Structure:
  • src/: Contains all source code. src/places.ts is the main entry point.
  • dist/: specific build artifacts. Do not edit files here directly.

Testing

• Currently, no automated test suite is configured.
• pnpm test will exit with an error.

Contribution Guidelines

• When adding new functionality, ensure proper types are exported in src/types.d.ts or within the module files.
• Follow existing patterns for defining remoteStorage data schemas and method signatures.