esm-common-modules

AI-assisted development

Repository-specific AI guidance lives in AGENTS.md. Detailed architecture, security, testing, database, specifications, prompts and project knowledge are under .ai/; reusable Claude skills and permissions are under .claude/. Treat executable code and tests as authoritative when documentation becomes stale.

Current architecture snapshot

Published @moderta/api-contracts contracts, validation, canonical domain data, and configurable data-source library. src/index.ts is the public package surface and re-exports common domain contracts, configuration, data sources, mock/default data, validation, response contracts, logger, and shared types.

Consumers request canonical data through a provider. createDataSource maps declarative static/http/s3 configuration to an adapter; remote failures return cloned seed data, and remote sources are cached. Package-root exports define the compatibility boundary used by APIs and frontends.

For implementation rules and the complete source-derived map, read AGENTS.md and the architecture instructions.