Getting Started with Allow #

import { createAllow } from "allow"

const allow = createAllow({
  secret: process.env.AUTH_SECRET,
  database: {
    type: "postgres",
    connection: process.env.DATABASE_URL,
    migrate: true  // Auto-create tables
  },
  strategies: [
    {
      name: "local",
      type: "local",
      config: {}
    }
  ]
})

type AuthConfig = {
  secret: string              // Required: JWT/session signing secret
  sessionDuration?: number    // Session TTL in ms (default: 86400000)
  database?: {
    type: "sqlite" | "postgres"
    connection: string        // Database URL
    migrate?: boolean         // Auto-run migrations
  }
  strategies: StrategyConfig[]
}

import { authenticate } from "allow"

const result = await authenticate(allow, "local", req)

if (result.success) {
  console.log("User:", result.user)
  console.log("Token:", result.tokens?.access_token)
} else {
  console.log("Error:", result.error)
}

import { createSession, getSession, destroySession } from "allow"

// Create session after login
const session = await createSession(allow, user)

// Get existing session
const session = await getSession(allow, sessionId)

// Logout
await destroySession(allow, sessionId)