Skip to content

Latest commit

 

History

History
 
 

lib

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
hooks
hooks
 
 
integration
integration
 
 
utils
utils
 
 
README.md
README.md
 
 
api-errors.test.ts
api-errors.test.ts
 
 
api-errors.ts
api-errors.ts
 
 
api-schemas.ts
api-schemas.ts
 
 
auth.test.ts
auth.test.ts
 
 
auth.ts
auth.ts
 
 
base64.test.ts
base64.test.ts
 
 
base64.ts
base64.ts
 
 
binary.test.ts
binary.test.ts
 
 
binary.ts
binary.ts
 
 
codemirror-utils.ts
codemirror-utils.ts
 
 
config.test.ts
config.test.ts
 
 
config.ts
config.ts
 
 
constants.test.ts
constants.test.ts
 
 
constants.ts
constants.ts
 
 
copy-to-clipboard.test.ts
copy-to-clipboard.test.ts
 
 
copy-to-clipboard.ts
copy-to-clipboard.ts
 
 
crypto-utils.test.ts
crypto-utils.test.ts
 
 
crypto-utils.ts
crypto-utils.ts
 
 
crypto.test.ts
crypto.test.ts
 
 
crypto.ts
crypto.ts
 
 
design-tokens.ts
design-tokens.ts
 
 
edge-runtime.test.ts
edge-runtime.test.ts
 
 
environment.test.ts
environment.test.ts
 
 
environment.ts
environment.ts
 
 
errors.test.ts
errors.test.ts
 
 
errors.ts
errors.ts
 
 
feature-flags.ts
feature-flags.ts
 
 
id.test.ts
id.test.ts
 
 
id.ts
id.ts
 
 
index.ts
index.ts
 
 
language-detection.test.ts
language-detection.test.ts
 
 
language-detection.ts
language-detection.ts
 
 
logger.test.ts
logger.test.ts
 
 
logger.ts
logger.ts
 
 
security.ts
security.ts
 
 
storage-operations.test.ts
storage-operations.test.ts
 
 
storage-operations.ts
storage-operations.ts
 
 
storage.test.ts
storage.test.ts
 
 
storage.ts
storage.ts
 
 
turnstile.test.ts
turnstile.test.ts
 
 
turnstile.ts
turnstile.ts
 
 
utils.test.ts
utils.test.ts
 
 
utils.ts
utils.ts
 
 
validation.test.ts
validation.test.ts
 
 
validation.ts
validation.ts
 
 

README.md

Lib Directory

This directory contains utility functions, business logic, and service modules.

Structure

lib/
├── config.ts        # Configuration management
├── constants.ts     # Application constants and limits
├── feature-flags.ts # Feature flag system
├── utils.ts         # General utility functions (cn, etc.)
├── config.test.ts   # Configuration tests
├── constants.test.ts # Constants tests
└── [future modules will be added here]

Implemented Modules

Configuration (config.ts)

  • Type-safe access to Cloudflare environment variables
  • Feature flags based on available services
  • Environment detection (development/production)
  • Application URL helpers

Constants (constants.ts)

  • File size limits (500KB/file, 5MB/gist, 20 files)
  • Expiry durations for gists
  • HTTP status codes
  • Validation helpers for files, PINs, and expiry options
  • Binary format constants
  • Cache control headers

Feature Flags (feature-flags.ts)

  • Advanced feature flag system with gradual rollout
  • Percentage-based feature rollouts
  • User-specific feature targeting
  • Runtime feature toggling without deployments

Planned Modules (to be implemented)

Core Modules

  • crypto.ts - Encryption/decryption utilities using Web Crypto API
  • storage.ts - Cloudflare R2 storage client wrapper
  • binary.ts - Binary format encoding/decoding for file storage
  • auth.ts - PIN hashing and validation

Utilities

  • logger.ts - Structured logging utility
  • errors.ts - Custom error classes and handling
  • validation.ts - Input validation helpers

Conventions

  • All modules must be edge runtime compatible (no Node.js APIs)
  • Use Web Crypto API for cryptographic operations
  • Export functions and constants as named exports
  • Write pure functions where possible
  • Include comprehensive error handling
  • Add JSDoc comments for public APIs

Edge Runtime Compatibility

All code in this directory must work in Cloudflare Workers:

  • No fs, path, or other Node.js modules
  • Use Web APIs (fetch, crypto, etc.)
  • Keep bundle sizes small
  • Consider CPU time limits (50ms)
  • Handle streaming for large data