Voice Chat Server Package

Server-side handlers for voice call log persistence

Overview

@zooly/voice-chat-srv is a server-side package that provides API handlers for creating and updating voice call logs. It sits between the Next.js API routes and the @zooly/app-db access layer.

This package follows the same pattern as @zooly/app-srv — it receives a cookie header, resolves the user/account, and delegates to database access functions.

Package Details

Package Name: @zooly/voice-chat-srv
Location: packages/voice-chat/srv
Type: Server-side API handler library

Dependencies

@zooly/app-db — Database access layer (createVoiceCallLog, updateVoiceCallLogMessages, getAccountByUserId)
@zooly/types — Shared types (VoiceCallLog, VoiceCallMessage)
@zooly/util — Shared utilities (getVerifiedUserInfo)

Exported Handlers

`createVoiceCallLogHandler`

async function createVoiceCallLogHandler(
  cookieHeader: string,
  agentId: string
): Promise<VoiceCallLog>

Resolves the user from the cookie via getVerifiedUserInfo(cookieHeader)
Looks up the user's account via getAccountByUserId(userInfo.id)
Creates a voice call log record with accountId and agentId
Returns the full VoiceCallLog record (including generated id)

`updateVoiceCallLogHandler`

async function updateVoiceCallLogHandler(
  id: string,
  voiceCallMessages: VoiceCallMessage[]
): Promise<void>

Updates the voiceCallMessages JSON array and updatedAt timestamp for the given log ID.

Database Schema

The voice_call_log table is defined in @zooly/app-db:

Column	Type	Description
`id`	`text` (PK)	Auto-generated nanoid
`account_id`	`text`	Nullable reference to the account
`agent_id`	`text`	ElevenLabs agent ID (required)
`voice_call_messages`	`jsonb`	Array of `VoiceCallMessage` objects
`created_at`	`timestamptz`	Creation timestamp
`updated_at`	`timestamptz`	Last update timestamp

Access Functions (from `@zooly/app-db`)

createVoiceCallLog(accountId, agentId) — Insert a new log
updateVoiceCallLogMessages(id, messages) — Update messages and updatedAt
getVoiceCallLog(id) — Fetch a log by ID

API Routes

The consuming app creates thin route handlers that delegate to these handlers. See App Integration for the zooly-app routes.

Route	Method	Handler
`/api/voice-call-log/create`	POST	`createVoiceCallLogHandler`
`/api/voice-call-log/update`	PUT	`updateVoiceCallLogHandler`

Voice Chat Client Package App Integration

On This Page

Overview Package Details Dependencies Exported Handlers [object Object][object Object]Database Schema Access Functions (from ,[object Object],)API Routes