docs: fix SessionConfig struct literal syntax in handler examples

[github-actions]

Summary

Several documentation code examples used invalid Go syntax: they initialized promoted fields from the embedded SessionConfig struct directly in handler struct literals, which the Go compiler rejects. The Go specification requires that struct literal keys be field names declared at the top level of the struct type — promoted fields from an embedded type must be initialized via the embedded type name.

Example of broken syntax (from docs):

h := &handler.AuthHandler{
    Users:             userStore,
    JWT:               jwtMgr,
    CookieName:        "session",   // ❌ promoted field — compiler error
    SecureCookies:     true,        // ❌ promoted field — compiler error
    Sessions:          sessionStore, // ❌ promoted field — compiler error
    RefreshTokenTTL:   ...,         // ❌ promoted field — compiler error
    RefreshCookieName: "refresh",   // ❌ promoted field — compiler error
}

Corrected syntax (consistent with README):

h := &handler.AuthHandler{
    Users: userStore,
    JWT:   jwtMgr,
    SessionConfig: handler.SessionConfig{
        CookieName:        "session",
        SecureCookies:     true,
        Sessions:          sessionStore,
        RefreshTokenTTL:   handler.DefaultRefreshTokenTTL,
        RefreshCookieName: "refresh",
    },
}

Files changed

File	Issue
docs/handler/auth.md	AuthHandler struct literal used promoted SessionConfig fields
docs/handler/magic-links.md	MagicLinkHandler struct literal used promoted SessionConfig fields
docs/handler/passkeys.md	PasskeyHandler struct literal used promoted SessionConfig fields
docs/handler/oauth2.md	OAuth2Handler struct literal used promoted SessionConfig fields
docs/index.md	Quick-start AuthHandler example used promoted SessionConfig fields
docs/tutorial.md	AuthHandler example + maintenance.StartCleanup missing nil logger argument

The docs/tutorial.md fix also corrects a second issue: maintenance.StartCleanup takes (ctx, logger, interval, cleaners...) but the tutorial called (ctx, interval, cleaners...), omitting the required *slog.Logger parameter. The corrected call passes nil (which uses slog.Default() at each log site).

All fixes match the correct syntax already present in README.md.

Generated by Update Docs · 912.3 AIC · ⌖ 13.6 AIC · ⊞ 34.4K · ◷

Add this agentic workflows to your repo

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/update-docs.md@96b9d4c39aa22359c0b38265927eadb31dcf4e2a