Discord bot and integration experiments

TypeScript • Discord integrations • PostgreSQL • Docker

This repository contains a snapshot of a Warden Discord bot and companion PostgreSQL database configuration. It is publicly readable for inspection and learning, but it is not a ready-to-deploy, maintained product.

Caution

Historical snapshot — unverified and not security-audited. Do not deploy directly to a production Discord server or expose its database to the internet without auditing the source, dependencies, permissions, environment configuration, and infrastructure first.

Repository map

Path	Contents
Warden/	TypeScript bot source using Seyfert, Discord commands/events, PostgreSQL connection, and Docker build files
Warden DB/	PostgreSQL 14 Docker Compose configuration and starter schema
docs/ARCHITECTURE.md	Data flow, components, and known assumptions
docs/SETUP_REVIEW.md	Safe environment setup and issues to resolve before running
docs/PROJECT_STATUS.md	Verification status and improvement roadmap
SECURITY.md	Responsible vulnerability reporting and security risks

What the code demonstrates

• A Discord bot written in TypeScript, using the Seyfert framework.
• Bot commands and events, including account-linking and counting-related functionality.
• PostgreSQL persistence for linking requests, linked accounts, and player records.
• Periodic cleanup of expired requests and application shutdown handling.
• Container configuration for the bot and database, with several limitations documented below.

Known gaps

• No confirmed compatibility matrix for supported Discord API, Node, TypeScript, Seyfert, or PostgreSQL versions.
• The checked-in bot Dockerfile and Compose need review: the Compose file references Dockerfile (different case) and expects an external Docker network called proxy.
• There is no committed lockfile in the bot folder. Builds may not be reproducible.
• The current database Compose configuration publishes PostgreSQL port 5432 on the host, which may expose it beyond the intended boundary depending on your environment.
• The bot includes fallback database credentials in code. Configure strong environment values and remove insecure fallbacks before deployment.
• Warden/readme.md references the upstream ZSMP-Public/Warden repository. The ownership and licensing provenance of the snapshot have not been independently established. Do not assume this repository is the original project or that redistribution rights have been verified.

For full details, read Setup & security review.

Development

For the historical setup notes, refer to bot setup and database setup. Those documents may contain outdated commands and should be read alongside the review guide.

Because dependencies have not been installed or built as part of this documentation pass, no compilation, bot login, or database integration result is claimed.

Contributing

Please read CONTRIBUTING.md. Good contributions include clarifying provenance, replacing insecure defaults, making Docker setup reproducible, writing tests, and documenting supported versions.

Maintainer / contact

Repository: St0rmM4st3r/Discord · Development portfolio: Crystal Developments

License and provenance

No open-source license is currently declared for this snapshot. Public visibility alone does not grant reuse rights. Before publishing a reusable distribution or accepting substantial code contributions, determine the upstream authorship and applicable permissions.