replit-sdk-patterns

# Replit SDK Patterns ## Overview Production-ready patterns for Replit's built-in services: Key-Value Database (`@replit/database` / `replit.db`), Object Storage (`@replit/object-storage`), PostgreSQL (`DATABASE_URL`), and Auth headers. Covers singleton clients, error handling, and type-safe wrappers. ## Prerequisites - `.replit` and `replit.nix` configured (see `replit-install-auth`) - Familiarity with async/await patterns - Understanding of Replit's service model ## Instructions ### Step 1: Database Client Singleton (Node.js) ```typescript // src/db/kv.ts — Replit Key-Value Database wrapper import Database from '@replit/database'; let instance: Database | null = null; export function getKV(): Database { if (!instance) { instance = new Database(); } return instance; } // Type-safe KV operations export async function kvGet<T>(key: string): Promise<T | null> { const value = await getKV().get(key); return value as T | null; } export async function kvSet<T>(key: string, value: T): Promise<void> { await getKV().set(key, value); } export async function kvList(prefix = ''): Promise<string[]> { return getKV().list(prefix); } export async function kvDelete(key: string): Promise<void> { await getKV().delete(key); } // Limits: 50 MiB total, 5,000 keys, 1 KB/key, 5 MiB/value ``` ### Step 2: Object Storage Wrapper ```typescript // src/storage/objects.ts — Replit App Storage (Object Storage) import { Client } from '@replit/object-storage'; let storage: Cli...