Module @esposter/azure-functions - v2.31.1

@esposter/azure-functions

Serverless Azure Functions backend for Esposter. Handles asynchronous workloads triggered by Azure EventGrid events — push notifications, webhook delivery, and friend request notifications.

📖 Documentation
⚖️ License

📖 Documentation

We highly recommend you take a look at the documentation to level up.

Architecture

Functions are triggered by Azure EventGrid events published by the main app — they are never called directly via HTTP from the client. Each function handles one async concern:

Function	Trigger	Description
`processPushNotification`	EventGrid	Sends web-push notifications to offline users when a new message is created
`processWebhook`	EventGrid	Delivers outgoing webhook payloads to registered endpoints
`pushWebhook`	EventGrid	Pushes webhook events to Azure WebPubSub for fan-out delivery
`processFriendRequestNotification`	EventGrid	Notifies users of incoming friend requests

Flow

App (createMessage) → Azure EventGrid → processPushNotification
                                      → processWebhook
                                      → pushWebhook

Dependencies

@azure/functions — Azure Functions runtime
@azure/eventgrid — EventGrid event parsing
@azure/web-pubsub — WebPubSub real-time delivery
@esposter/db + @esposter/db-schema — database access
web-push — RFC 8030 web-push delivery

Commands

Run from packages/azure-functions/:

pnpm build        # compile to dist/
pnpm test         # vitest watch mode (coverage is run from the repo root)
pnpm lint:fix     # auto-fix lint
pnpm typecheck    # type check

⚖️ License

This project is licensed under the Apache-2.0 license.

Interfaces

WebhookEventGridData

Variables

Functions

assertCanCreateMessage
getCreateMessageNotificationPayload
getQueueClient
getTableClient
getWebhookCreateMessageInput
getWebPubSubServiceClient
sendFriendRequestNotification
sendPushNotification
sendReminderNotification