@podosoft/podokit-auth

PodoKit's DB-backed auth configuration pipeline — the layer that sits on top of better-auth so OAuth providers, SMTP, and server-enforced policies, including automatic logout, can be managed at runtime (from an admin Settings page) instead of being frozen in environment variables at boot.

It is deliberately free of better-auth and web-framework/ORM imports (only node:crypto and a pg peer), so it can be loaded outside dependency injection and by the @better-auth/cli during migrations.

What's inside

• Envelope-encrypted secrets — encryptSecret / decryptSecret store OAuth client secrets and the SMTP password with AES-256-GCM. The key is derived from BETTER_AUTH_SECRET via HKDF-SHA256 and never lives in the database it protects, so a DB leak alone can't decrypt them.
• The AuthConfig model — the shape of the runtime config (social providers, SMTP, and server policies including provider-independent sign-up approval and a validated session idle timeout), plus envAuthConfig() (the env-only fallback), the supported-provider allowlist, and socialKey helpers.
• A config store — createConfigStore(pool) loads the current config from the auth_config table (with per-field env fallback) and decrypts secrets on read.

Install

npm install @podosoft/podokit-auth

pg is a peer dependency (your app already provides it).

Usage

import { createConfigStore, envAuthConfig } from "@podosoft/podokit-auth";

const store = createConfigStore(pool);      // reads auth_config, env fallback
const config = await store.load();          // AuthConfig (secrets decrypted)
const smtp = await store.smtpConfig();      // resolved SMTP transport config, or null

Set sessionIdleTimeoutMinutes to an integer from 5 through 10080 to build a sliding server-side session lifetime. null keeps better-auth's default seven-day lifetime. Generated applications expose this as Automatic logout under Admin Settings → Authentication and apply changes to existing sessions.

Generated by @podosoft/podokit; most apps consume it through the auth module rather than importing it directly.

License

Apache-2.0