env/dotfiles

0 Fork 0

mirror of https://github.com/prdlk/dotfiles.git synced 2026-11-02 19:32:43 +00:00

Files

T

Prad Nukala 6406208b35 shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents

- 16 cross-shell utilities converted to sh/bash chezmoi executables:
  ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone
  ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj
  (ghg-clone not named ghg: unrelated cargo binary owns that name)
- cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho
  cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files
- fish keeps only shell-state functions; converted ones now hit PATH
- cp-appid ignore gating moved to .local/bin path
- dot_agents/skills: 82 skills materialized from dotstate storage so
  dot_claude skill symlinks resolve on fresh bootstrap; dotstate
  profile/symlinks.json released .agents/skills .bashrc .zshrc

2026-08-10 15:15:06 -04:00

2.8 KiB

Raw Blame History

Hyperdrive

Accelerates database queries from Workers via connection pooling, edge setup, query caching.

Key Features

Connection Pooling: Persistent connections eliminate TCP/TLS/auth handshakes (~7 round-trips)
Edge Setup: Connection negotiation at edge, pooling near origin
Query Caching: Auto-cache non-mutating queries (default 60s TTL)
Support: PostgreSQL, MySQL + compatibles (CockroachDB, Timescale, PlanetScale, Neon, Supabase)

Architecture

Worker → Edge (setup) → Pool (near DB) → Origin
         ↓ cached reads
         Cache

Quick Start

# Create config
npx wrangler hyperdrive create my-db \
  --connection-string="postgres://user:pass@host:5432/db"

# wrangler.jsonc
{
  "compatibility_flags": ["nodejs_compat"],
  "hyperdrive": [{"binding": "HYPERDRIVE", "id": "<ID>"}]
}

import { Client } from "pg";

export default {
  async fetch(req: Request, env: Env): Promise<Response> {
    const client = new Client({
      connectionString: env.HYPERDRIVE.connectionString,
    });
    await client.connect();
    const result = await client.query("SELECT * FROM users WHERE id = $1", [123]);
    await client.end();
    return Response.json(result.rows);
  },
};

When to Use

✅ Global access to single-region DBs, high read ratios, popular queries, connection-heavy loads ❌ Write-heavy, real-time data (<1s), single-region apps close to DB

💡 Pair with Smart Placement for Workers making multiple queries - executes near DB to minimize latency.

Driver Choice

Driver	Use When	Notes
pg (recommended)	General use, TypeScript, ecosystem compatibility	Stable, widely used, works with most ORMs
postgres.js	Advanced features, template literals, streaming	Lighter than pg, `prepare: true` is default
mysql2	MySQL/MariaDB/PlanetScale	MySQL only, less mature support

Reading Order

New to Hyperdrive	Implementing	Troubleshooting
1. README (this)	1. configuration.md	1. gotchas.md
2. configuration.md	2. api.md	2. patterns.md
3. api.md	3. patterns.md	3. api.md

In This Reference

configuration.md - Setup, wrangler config, Smart Placement
api.md - Binding APIs, query patterns, driver usage
patterns.md - Use cases, ORMs, multi-query optimization
gotchas.md - Limits, troubleshooting, connection management

2.8 KiB Raw Blame History