Record Class PasswordResetTokenRecord

java.lang.Object
java.lang.Record
com.svenruppert.jsentinel.accountlifecycle.PasswordResetTokenRecord
Record Components:
tokenHash - non-blank token hash
tenant - tenant scope; null becomes TenantId.DEFAULT
subjectId - subject whose password the token resets
createdAt - when the token was issued
expiresAt - absolute expiry, strictly after createdAt
consumedAt - instant the token was consumed, or empty when still pending; if present must be strictly after createdAt
@ExperimentalJSentinelApi public record PasswordResetTokenRecord(String tokenHash, TenantId tenant, SubjectId subjectId, Instant createdAt, Instant expiresAt, Optional<Instant> consumedAt) extends Record
Persistent representation of a single password-reset token.

Single-use: once consumedAt is set the token must not be honoured again. Stores only the hash of the token; the plain value is delivered to the user (e.g. as a reset-link query parameter) and never persisted.

  • Constructor Details

    • PasswordResetTokenRecord

      public PasswordResetTokenRecord(String tokenHash, TenantId tenant, SubjectId subjectId, Instant createdAt, Instant expiresAt, Optional<Instant> consumedAt)
      Validates the record components and normalises null tenant / null consumedAt.
      Parameters:
      tokenHash - non-blank token hash
      tenant - tenant scope; null becomes DEFAULT
      subjectId - non-null subject
      createdAt - non-null creation instant
      expiresAt - non-null expiry, strictly after createdAt
      consumedAt - null becomes empty Optional

  • Method Details

    • withConsumedAt

      public PasswordResetTokenRecord withConsumedAt(Instant at)
      Returns a copy with consumedAt() set to at — the canonical way to mark a token consumed.
      Parameters:
      at - instant the token was consumed; must not be null
      Returns:
      new record with consumedAt = Optional.of(at)

    • isConsumed

      public boolean isConsumed()
      Returns whether the token has been consumed.
      Returns:
      true when consumedAt is present

    • isExpired

      public boolean isExpired(Instant now)
      Returns true when the token is past its expiry at the supplied instant.
      Parameters:
      now - reference instant; non-null
      Returns:
      whether the token is expired

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • tokenHash

      public String tokenHash()
      Returns the value of the tokenHash record component.
      Returns:
      the value of the tokenHash record component

    • tenant

      public TenantId tenant()
      Returns the value of the tenant record component.
      Returns:
      the value of the tenant record component

    • subjectId

      public SubjectId subjectId()
      Returns the value of the subjectId record component.
      Returns:
      the value of the subjectId record component

    • createdAt

      public Instant createdAt()
      Returns the value of the createdAt record component.
      Returns:
      the value of the createdAt record component

    • expiresAt

      public Instant expiresAt()
      Returns the value of the expiresAt record component.
      Returns:
      the value of the expiresAt record component

    • consumedAt

      public Optional<Instant> consumedAt()
      Returns the value of the consumedAt record component.
      Returns:
      the value of the consumedAt record component