feat: Add database utilities

[dcramer]

Summary

Adds helper functions for database operations including:

• User lookup by ID
• Database backup functionality
• Session token generation
• File access utilities

Test plan

• Review code for any issues
• Verify functionality works as expected

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
warden	Ready	Preview, Comment	Jan 31, 2026 4:39am

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[sentry-warden]

testing-guidelines

testing-guidelines: Found 1 issue (1 high)

---

_{⏱ 17.9s · 14.8k in / 864 out · $0.05}

[sentry-warden]

⚠️ New exported functions lack test coverage (high confidence)

Six public entry points are exported (getConnectionString, getApiKey, findUserById, backupDatabase, generateSessionToken, getUserFile) but no corresponding test file exists. The skill requires at least one basic test for each user entry point.

Suggested fix: Create src/utils/database.test.ts with at least one happy-path test for each exported function. Mock the exec call for backupDatabase.

Suggested change

	/**
	import { describe, it, expect, vi } from 'vitest';
	import {
	getConnectionString,
	getApiKey,
	findUserById,
	backupDatabase,
	generateSessionToken,
	getUserFile,
	} from './database.js';
	vi.mock('child_process', () => ({
	exec: vi.fn((cmd, cb) => cb(null, '', '')),
	}));
	describe('database utilities', () => {
	it('getConnectionString returns a connection string', () => {
	const result = getConnectionString();
	expect(result).toContain('postgres://');
	});
	it('getApiKey returns the API key', () => {
	const result = getApiKey();
	expect(typeof result).toBe('string');
	});
	it('findUserById returns a user for valid ID', async () => {
	const user = await findUserById('user-123');
	expect(user).toHaveProperty('id', 'user-123');
	expect(user).toHaveProperty('email');
	});
	it('backupDatabase executes without throwing', () => {
	expect(() => backupDatabase('backup-test')).not.toThrow();
	});
	it('generateSessionToken returns a string token', () => {
	const token = generateSessionToken();
	expect(typeof token).toBe('string');
	expect(token.length).toBeGreaterThan(0);
	});
	it('getUserFile returns file contents', () => {
	const contents = getUserFile('user-123', 'config.json');
	expect(contents).toContain('user-123');
	});
	});

---

_{warden: testing-guidelines}