Pranor Standard Library

Reusable .pnr modules for common service patterns. Import what you need:

import { ok, notFound } from "stdlib/response.pnr"
import { requireAuth, bearerToken } from "stdlib/auth.pnr"

Module Index

Categories

Security

• auth.pnr — Token extraction, bearer/basic auth, auth guards
• crypto.pnr — Password hashing, HMAC signing, token generation
• jwt.pnr — JWT encode/decode/expiry (lightweight; use pranor add github.com/golang-jwt/jwt/v5 for production)

HTTP

• response.pnr — Standard HTTP response builders (ok, notFound, etc.)
• pagination.pnr — Page offset calculation, response envelope
• middleware.pnr — CORS headers, request ID generation, preflight detection
• http_client.pnr — JSON GET/POST wrappers, status code helpers

Utilities

• datetime.pnr — Timestamps, expiry checks, duration formatting
• strings_util.pnr — Slugify, truncate, capitalize, pattern matching
• collections.pnr — Array utilities (unique, flatten, chunk, first/last)

Config & Environment

• env.pnr — Required env vars, defaults, type coercion (int/bool)

Resilience

• retry.pnr — Exponential backoff calculation

Messaging

• events.pnr — In-process event bus (emit/on pattern)

Testing

• testing_helpers.pnr — Expressive assertions for test blocks

Operations

• health.pnr — Custom health check builders
• graceful.pnr — Shutdown state, connection draining, drain detection

Scheduling

• scheduler.pnr — Dynamic runtime scheduling beyond every/cron

Integration

• webhook.pnr — Outgoing webhook payloads, signature verification, retry records
• cors.pnr — CORS header generation, origin checking, preflight responses

Concurrency

• semaphore.pnr — Named semaphores with slot tracking and utilization metrics

Processing

• batch.pnr — Accumulate-and-flush batch pattern with size tracking
• job.pnr — Background job lifecycle (pending → running → completed/failed)

Reliability

• idempotency.pnr — Idempotency key pattern for deduplication
• dlq.pnr — Dead letter queue for failed message tracking

Multi-tenancy

• tenant.pnr — Tenant extraction from requests, scoped config/cache/DB keys

Compliance

• audit.pnr — Structured audit trail (actions, access, auth, denied events)

Usage Example

import { requireAuth, bearerToken } from "stdlib/auth.pnr"
import { ok, badRequest } from "stdlib/response.pnr"
import { required, isEmail } from "stdlib/validation.pnr"
import { envOrDefault } from "stdlib/env.pnr"

server envOrDefault("PORT", "8080")

route "POST" "/api/users" (req) {
    let authErr = requireAuth(req)
    if authErr != nil {
        return authErr
    }

    let errors = validate(req.body, {
        "email": "required,email",
        "name": "required"
    })
    if errors != nil {
        return badRequest(errors)
    }

    return ok({ "created": true })
}

Contributing

Add new modules as stdlib/<name>.pnr. Export functions with export fn. Follow existing patterns:

• Pure functions where possible
• No side effects unless explicitly documented
• Use interface{} params (no type annotations) for maximum flexibility