# Typescript Inline Scripts

> Guide for running inline TypeScript scripts with Bun. This should be used when the user says "use inline typescript Use when this capability is needed.

- Skill: `tomevault-io/typescript-inline-scripts` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/typescript-inline-scripts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/typescript-inline-scripts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/typescript-inline-scripts

---


## TypeScript Inline Scripts with Bun

### IMPORTANT

- ALWAYS assume Bun runtime with modern TypeScript features
- Imported npm packages will be automatically installed by Bun
- ALWAYS prefer Bun APIs where possible

### Example

```bash
bun run --install=fallback - < <(cat <<'EOF'
import { z } from 'zod'

console.log(z.coerce.number().parse('5'))
EOF
)
```

## Bun APIs Reference

### Core Runtime APIs

- `Bun.spawn()` - Process spawning and management
- `Bun.file()` - File system operations and reading
- `Bun.write()` - File writing operations
- `fetch()` - HTTP requests (Web API standard)
- `Bun.preconnect()` - URL preconnection for performance

### File System

- `Bun.file(path)` - Create file handle for reading/writing
- `await Bun.file(path).text()` - Read file as text
- `await Bun.file(path).json()` - Read file as JSON
- `await Bun.file(path).arrayBuffer()` - Read file as ArrayBuffer
- `await Bun.write(path, data)` - Write data to file

### Shell Commands

```typescript
import { $ } from "bun"
await $`command` // Execute shell commands with template literals
const result = await $`ls -la` // Capture command output
```

### Compression

- `Bun.gzipSync()` - Synchronous gzip compression
- `Bun.gunzipSync()` - Synchronous gzip decompression
- `Bun.inflateSync()` - Synchronous deflate decompression

### SQLite

```typescript
import { Database } from "bun:sqlite"
// Database operations and SQL execution
```

### FFI (Foreign Function Interface)

```typescript
import { dlopen, CString } from "bun:ffi"
// Native library interaction
```

### Utilities

- `Bun.escapeHTML()` - HTML escaping
- `Bun.hash()` - Hashing functions
- `Bun.password.hash()` - Password hashing
- `Bun.password.verify()` - Password verification

### Node.js Compatibility

- Full Node.js API support via `node:` imports
- `import { createRequire } from 'node:module'`
- All standard Node.js modules available

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jahands) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->