from fune.auth.validate_registration import validate_registration # auth.validate-registration@^1
Suites · auth
User accounts and authentication
Sign-up and login forms, password policy and hashing, login lockout, signed access tokens, two-factor codes, email verification and reset tokens, account linking and roles.
42 capabilities (13 core, 29 optional) and 13 gaps, in build order. Put each line in the file that calls it, then fune build.
Core coverage: 50%
13 of 26 needs met by verified capabilities. The needs are this suite's 13 core members and its 13 named gaps; a core member counts when a version of it is verified (by the sandbox, or the registry's seed) and not yanked, and a gap never counts. Optional members are not needs.
Baseline: a hand-written app with no suite meets 0 of the same 26. Method fune-coverage/1, computed 2026-11-22T20:48:49.752Z.
1. Sign-up and login forms
Check what people type into the account forms, the same way in the browser and the API.
from fune.auth.validate_login import validate_login # auth.validate-login@^1
from fune.auth.normalise_email import normalise_email # auth.normalise-email@^1
from fune.auth.validate_password_change import validate_password_change # auth.validate-password-change@^1
2. Passwords
Decide what passwords are acceptable and store them safely.
from fune.auth.password_policy import password_policy, check_password # auth.password-policy@^1
from fune.auth.password_hash import hash_password, verify_password, password_needs_rehash # auth.password-hash@^1
from fune.crypto.pbkdf2_sha256 import pbkdf2_sha256 # crypto.pbkdf2-sha256@^1
from fune.crypto.constant_time_equal import constant_time_equal # crypto.constant-time-equal@^1
- breached-passwords Checking passwords against a breach corpus (Have I Been Pwned's range API) is network work; the policy's common-password list is built in.
3. Login protection
Slow down password guessing.
from fune.auth.login_throttle import login_throttle # auth.login-throttle@^1
from fune.http.retry_after import retry_after_seconds # http.retry-after@^1
- ip-rate-limiting Rate limiting by IP address across accounts, with its shared counter store (Redis, a database).
4. Tokens
Issue and check signed tokens for an API or a single-page app.
from fune.auth.access_token import issue_access_token, read_access_token, confirm_access_token # auth.access-token@^1
from fune.auth.bearer_token import parse_bearer_token # auth.bearer-token@^1
from fune.auth.jwt import sign_jwt, verify_jwt, decode_jwt # auth.jwt@^1
from fune.crypto.hmac_sha256 import hmac_sha256 # crypto.hmac-sha256@^1
from fune.crypto.sha256 import sha256 # crypto.sha256@^1
from fune.encoding.base64 import base64_encode, base64_decode, base64_url_encode, base64_url_decode # encoding.base64@^1
from fune.time.countdown import countdown # time.countdown@^1
- sessions Server-side session stores and CSRF tokens are yours; auth.oauth-sign-in signs a stateless session cookie with Secure/HttpOnly/SameSite set.
- asymmetric-jwt RS256/ES256 tokens and JWKS key sets (for third-party identity providers): auth.jwt is HS256 only.
5. Sign-in with an identity provider
Let people sign in with Google, Microsoft, GitHub or any OpenID Connect provider, and keep them signed in.
from fune.auth.account_link import decide_account_link # auth.account-link@^1
- identity-links The table of provider identities linked to accounts, and the unlink page, are yours; auth.account-link decides.
6. Email verification, password reset and magic links
Prove someone owns an address with a single-use link that expires.
from fune.auth.email_token import generate_email_token, hash_email_token, check_email_token, consume_email_token # auth.email-token@^1
- email-token-table The table the hashed tokens live in (token_hash, purpose, subject, expires_at, used_at) is yours.
7. Two-factor sign-in
Ask for a second factor after the password: an authenticator app code, or a recovery code.
from fune.auth.totp import totp_secret, totp_uri, hotp_code, totp_code, verify_totp # auth.totp@^1
from fune.auth.recovery_codes import generate_recovery_codes, normalise_recovery_code, hash_recovery_code, consume_recovery_code # auth.recovery-codes@^1
- passkeys-sms Passkeys/WebAuthn and SMS codes are not in Functional Weave.
8. Roles and permissions
Decide who may do what, and test it.
from fune.auth.rbac import resolve_roles, has_permission, check_access, access_matrix # auth.rbac@^1
- org-membership Organisations, invitations and membership tables are yours to model.
9. Forms in React
Accessible account pages in a React front end (TypeScript only).
10. Contact details from validation-basics
Check and normalise a person's contact details before storing them.
from fune.validation.email import is_email # validation.email@^1
from fune.validation.phone_e164 import validate_phone_e164 # validation.phone-e164@^2
from fune.validation.uk_postcode import validate_uk_postcode # validation.uk-postcode@^2
from fune.text.normalise_name import normalise_name # text.normalise-name@^1
11. Bank details from validation-basics
Check payee and customer bank details before money moves.
from fune.validation.iban import is_iban # validation.iban@^1
from fune.validation.bic import validate_bic # validation.bic@^1
from fune.validation.uk_sort_code_account import validate_uk_sort_code_account # validation.uk-sort-code-account@^3
from fune.validation.uk_modulus_table import parse_uk_modulus_table # validation.uk-modulus-table@^1
12. Identifiers and check digits from validation-basics
Catch mistyped reference numbers by their check digits.
from fune.validation.luhn import is_luhn # validation.luhn@^1
from fune.validation.uk_company_number import validate_uk_company_number # validation.uk-company-number@^2
from fune.validation.lei import validate_lei # validation.lei@^1
from fune.validation.gtin import validate_gtin # validation.gtin@^1
13. Displaying sensitive values from validation-basics
Show stored identifiers without exposing them.
from fune.text.mask import mask # text.mask@^1
Gaps
What this kind of app usually needs that Functional Weave does not have yet: write these yourself, or use a service.
- email-wording The wording of the verification, reset and magic-link emails; email.send sends them.
- user-storage The users table, unique email index, migrations and account deletion.
- address-lookup Turning a postcode into a list of addresses (Royal Mail PAF or a lookup API) is network work and not in caps.
- email-deliverability Whether a mailbox exists (MX lookups, a confirmation email): validation.email checks the syntax only.
- vocalink-data The Vocalink modulus tables themselves: download them from Pay.UK under its terms; caps parses them but does not ship them.