Add Mongoose + Document DB Playground

[hossain-rayhan]

Add Mongoose + DocumentDB playground

First playground for documentdb-playground: a quick, hands-on guide for testing DocumentDB with Mongoose, the most popular MongoDB ODM for Node.js. Everything runs locally against a DocumentDB container in Docker — no Kubernetes, no cloud, no image builds.

What's included

• Express + Mongoose REST API (playgrounds/mongoose/app/) — /books CRUD, /health, and a /stats/genres aggregation endpoint.
• Standalone CRUD/compatibility test suite (app/mongoose-crud-test.js) — exercises connect, schema/index creation, insert, query, update, aggregation, unique-index enforcement, and delete, printing a pass/fail summary.
• Local-only helper scripts (scripts/):
  • run-test.sh — start DocumentDB (if needed) and run the compatibility suite end-to-end (agent/CI-friendly).
  • run-app.sh — start DocumentDB (if needed) and serve the demo API on :3000.
  • start-documentdb.sh / stop-documentdb.sh — manage the local documentdb-local container.
  • lib.sh — shared container lifecycle, readiness wait, and connection-string builder.
• Docs — playground README (setup, config reference, compatibility notes, troubleshooting) and an updated root README that indexes playgrounds and leaves room for future ones (PyMongo, Beanie, k8s/cloud, etc.).

How DocumentDB runs locally

Uses the official image, bound to loopback:

docker run -dt -p 127.0.0.1:10260:10260 --name documentdb-local \
  ghcr.io/documentdb/documentdb/documentdb-local:latest \
  --username docdbadmin --password '<password>'

Notes / design decisions

• Port is bound to 127.0.0.1 — keeps the DB off external interfaces and works around a Docker Desktop/WSL2 quirk where the IPv4 loopback mapping was otherwise unreachable.
• Default username is docdbadmin (the gateway rejects the reserved name documentdb).
• Mongoose connects with directConnection: true, tls: true, tlsAllowInvalidCertificates: true, and strips replicaSet=rs0 automatically.
• run-app.sh and run-test.sh are independent and can run concurrently (app uses DB mongoose_demo, tests use mongoose_test) — no port-forward to clobber.

Testing

Verified end-to-end against documentdb-local:latest:

• Test suite: Passed: 13, Failed: 0, Known issues: 0 (the older findById _id "pruned relation" bug is resolved in the current image).
• API smoke test: /health, POST/GET /books, and /stats/genres all working.
• Confirmed the app and test suite run simultaneously without interference.

[Copilot]

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

[patty-chow]

Current DocumentDB implements native $vectorSearch

[hossain-rayhan]

Thanks. Added new tests for vecotrSearch and updated README.

[patty-chow]

left one comment on the readme, otherwise LGTM