KnearMe Edge Worker Overview

Purpose

apps/knearme-edge is the Cloudflare Worker gateway for abuse-prone and edge-owned API paths.

Primary responsibilities:

• Request validation/challenge/rate-limiting on public write routes.
• Queue-backed async handling for selected endpoints.
• Redirect lookup and redirect-sync cron coordination.
• Optional shields for AI and media ingress routes.

Runtime mode model

Per-route ownership can be:

• proxy
• queue
• edge

Mode defaults are configured in wrangler.toml.

Stack

• Cloudflare Workers runtime.
• TypeScript + Wrangler.
• Durable Objects (RATE_LIMITER).
• KV namespaces (REDIRECTS_KV, IDEMPOTENCY_KV).
• Queues (API_QUEUE + DLQ).

Primary commands

pnpm -C apps/knearme-edge dev
pnpm -C apps/knearme-edge typecheck
pnpm -C apps/knearme-edge test
pnpm -C apps/knearme-edge deploy