postkitlisted

## Setup (REQUIRED FIRST STEP) Clone the repository if not already present: ```bash [ -d postkit ] || git clone https://github.com/varunchopra/postkit.git ``` Then build the dist files: ```bash cd postkit && make build && cd .. ``` Install the SQL schema on the user's database: ```bash psql $DATABASE_URL -f postkit/dist/postkit.sql # Or individual modules: postkit/dist/authn.sql, postkit/dist/authz.sql, postkit/dist/config.sql, postkit/dist/meter.sql, postkit/dist/queue.sql ``` For the optional Python SDK: ```bash pip install -e "./postkit/sdk[binary]" ``` ## Requirements **All languages** (SQL functions): - PostgreSQL 14+ - Schema installed from `dist/` files **Python SDK only** (optional wrapper): - `psycopg>=3.1.0` (not psycopg2) - Python 3.11+ ## Instructions 1. Read `postkit/AGENTS.md` for multi-tenancy, hashing, login flows, and module API maps 2. Read the relevant module docs based on what the user needs: - Authentication (users/sessions): `postkit/docs/authn/` - Authorization (permissions): `postkit/docs/authz/` - Configuration (versioned key-value): `postkit/docs/config/` - Metering (usage tracking, quotas): `postkit/docs/meter/` - Job Queues (scheduling, retries): `postkit/docs/queue/` ## Documentation Map | What you need | Where to look | |---------------|---------------| | Integration guide | `postkit/AGENTS.md` | | authn SQL reference | `postkit/docs/authn/sql.md` | | authn Python SDK | `postkit/docs/authn/sdk.md` | | authz SQL refer