docs: update readme

chore: session timoeouts up
feature: started to look at doing something around durations for some
forgotten reason, but don't want to just abandon this now 🤷
This commit is contained in:
Andy Burke 2025-07-08 18:10:09 -07:00
parent 0a85a7e05f
commit 51acbef35f
3 changed files with 113 additions and 6 deletions

View file

@ -14,11 +14,24 @@ feature discussions.
- [X] refactor login/sessions/totp
- [X] chat rooms
- [X] chat messages
- [ ] gif support
- [ ] inline image support
- [ ] media uploads
- [ ] local upload support (keep it simple for small instances)
- [ ] S3 support (then self-host with your friends: https://garagehq.deuxfleurs.fr/)
- [ ] chat message processing
- [ ] auto-link urls
- [ ] use this regex?: `(?:(?<protocol>[a-zA-Z]+):\/\/)?(?:(?<auth>(?<username>\S.+)\:(?<password>.+))\@)?(?<host>(?<hostname>[-a-zA-Z0-9\.]{2,256}\.(?<tld>[-a-zA-Z0-9]{2,256}))(?:\:(?<port>[0-9]{1,6}))?)\b(?<path>[-a-zA-Z0-9@:%_{}\[\]<>\(\)\+.~#&//=]*)(?:\?(?<query>[a-zA-Z0-9!$%&<>()*+,-\.\/\:\;\=\?\@_~]+))?(?:#(?<hash>[a-zA-Z0-9!$&'()*+,-\.\/\:\;\=\?\@_~]+))?`
- [ ] preview cards for links
- [ ] embedded video for
- [ ] youtube
- [ ] vimeo
- [ ] tiktok
- [ ] embedded audio or audio cards for:
- [ ] tidal
- [ ] spotify
- [ ] youtube (any way to differentiate for yt music?)
- [ ] punycode urls before url extraction? (see: https://stackoverflow.com/a/26618995)
- [ ] gif support
- [ ] start/stop gif control
- [ ] hide control
- [ ] inline image support
- [ ] hide control
- [ ] try to select immediate sibling messages from the same user and hide mulitple avatars
- [X] user profile page
- [X] logout button
@ -41,6 +54,9 @@ feature discussions.
- [X] smart forms
- [X] use the api for forms so requests will be authenticated
- [X] support multiple methods
- [ ] media uploads
- [ ] local upload support (keep it simple for small instances)
- [ ] S3 support (then self-host with your friends: https://garagehq.deuxfleurs.fr/)
## Getting Started Developing

View file

@ -10,7 +10,7 @@ import { get_session, get_user, PRECHECK_TABLE, require_user, SESSION_ID_TOKEN,
import * as bcrypt from 'jsr:@da/bcrypt';
import { verifyTotp } from '../../../utils/totp.ts';
const DEFAULT_SESSION_TIME: number = 60 * 60 * 1_000; // 1 Hour
const DEFAULT_SESSION_TIME: number = 28 * (24 * (60 * (60 * 1_000))); // 28 days
export const PRECHECKS: PRECHECK_TABLE = {};

91
utils/duration.ts Normal file
View file

@ -0,0 +1,91 @@
enum TimeUnit {
// Plancks = (-5.39 * Math.pow( 10, -44 )), // The amount of time light takes to travel one Planck length.
// quectoseconds = Math.pow( 10, -30), // One nonillionth of a second.
// rontoseconds = Math.pow( 10, -27 ), // One octillionth of a second.
// yoctoseconds = Math.pow( 10, -24 ), // One septillionth of a second.
// zeptoseconds = Math.pow( 10, -21 ), // One sextillionth of a second. Time measurement scale of the NIST and JILA strontium atomic clock. Smallest fragment of time currently measurable is 247 zeptoseconds.[3]
// attoseconds = Math.pow( 10, -18 ), // One quintillionth of a second.
// femtoseconds = Math.pow( 10, -15 ), // One quadrillionth of a second.
// svedbergs = Math.pow( 10, -13 ), // 100 femtoseconds, time unit used for sedimentation rates (usually of proteins).
picoseconds = Math.pow(10, -12), // One trillionth of a second.
nanoseconds = Math.pow(10, -9), // One billionth of a second. Time for molecules to fluoresce.
shakes = Math.pow(10, -8), // 10 nanoseconds, also a casual term for a short period of time.
microseconds = Math.pow(10, -6), // One millionth of a second. Symbol is μs
milliseconds = Math.pow(10, -3), // One thousandth of a second. Shortest time unit used on stopwatches.
centiseconds = Math.pow(10, -2), // One hundredth of a second.
deciseconds = Math.pow(10, -1), // One tenth of a second.
seconds = 1, // SI base unit for time.
decasecond = 10, // Ten seconds (one sixth of a minute)
minutes = 60, // 60 seconds
hectoseconds = 100, // 100 seconds
millidays = 86.4, // 1/1000 d (0.001 d) 1.44 minutes, or 86.4 seconds. Also marketed as a ".beat" by the Swatch corporation.
centidays = 864, // 0.01 d (1% of a day) 14.4 minutes, or 864 seconds. One-hundredth of a day is 1cd (centiday), also called "kè" in traditional Chinese timekeeping. The unit was also proposed by Lagrange and endorsed by Rey-Pailhade[5] in the 19th century, named "centijours" (from French centi- 'hundred' and jour 'day').
kiloseconds = 1000, // About 17 minutes.
hours = 60 * 60, // 60 minutes (60 * 60 seconds)
decidays = 144 * 60, // 0.1 d (10% of a day) 2.4 hours, or 144 minutes. One-tenth of a day is 1dd (deciday), also called "gēng" in traditional Chinese timekeeping.
days = 24 * 60 * 60, // 24 h Longest unit used on stopwatches and countdowns. The SI day is exactly 86400 seconds.
weeks = 7 * 24 * 60 * 60, // 7 d Historically sometimes also called "sennight".
decaday = 10 * 24 * 60 * 60, // 10 d (1 Dd) 10 days. A period of time analogous to the concept of "week", used by different societies around the world: the ancient Egyptian calendar, the ancient Chinese calendar, and also the French Republican calendar (in which it was called a décade).
megaseconds = Math.pow(10, 6), // About 11.6 days.
fortnights = 14 * 24 * 60 * 60, // 2 weeks 14 days
hectodays = 100 * 24 * 60 * 60, // 100 d (1 hd) 100 days, roughly equivalent to 1/4 of a year (91.25 days). In Chinese tradition "bǎi rì" (百日) is the hundredth day after one's birth, also called Baby's 100 Days Celebration.
semesters = 18 * 7 * 24 * 60 * 60, // 18 weeks A division of the academic year.[6] Literally "six months", also used in this sense.
lunaryears = 354.37 * 24 * 60 * 60, // 354.37 d
years = 365 * 24 * 60 * 60, // 12 mo
decades = 10 * 365 * 24 * 60 * 60, // 10 yr
gigaseconds = Math.pow(10, 9), // About 31.7 years.
jubilees = 50 * 365 * 24 * 60 * 60, // 50 yr
centuries = 100 * 365 * 24 * 60 * 60, // 100 yr
millennium = 1000 * 365 * 24 * 60 * 60, // 1000 yr Also called "kiloannum".
teraseconds = Math.pow(10, 12), // About 31,709 years.
petaseconds = Math.pow(10, 15) // About 31709791 years.
// exaseconds = Math.pow( 10, 18 ), // About 31709791983 years. Approximately 2.3 times the current age of the universe.
// zettasecond = Math.pow( 10, 21 ), // About 31709791983764 years.
}
const UNIT_ABBREVIATIONS: Record<string, TimeUnit> = {
'ps': TimeUnit.picoseconds,
'ns': TimeUnit.nanoseconds,
'us': TimeUnit.microseconds,
'ms': TimeUnit.milliseconds,
's': TimeUnit.seconds,
'm': TimeUnit.minutes,
'h': TimeUnit.hours,
'd': TimeUnit.days,
'w': TimeUnit.weeks,
'y': TimeUnit.years
};
export class Duration {
constructor(private length: number = 0, private start: number | undefined = undefined) {}
public static between(start: Date, end: Date, unit: TimeUnit = TimeUnit.milliseconds) {
const ms_between: number = end.valueOf() - start.valueOf();
const factor: number = unit / TimeUnit.milliseconds;
return factor * ms_between;
}
public static of(spec: string | number, unit?: TimeUnit): Duration {
if (unit) {
return new Duration(Number(spec) * unit);
}
let length_in_ms = 0;
for (const match of `${spec}`.matchAll(/(?<len>([0-9]*[.])?[0-9]+)\W*(?<unit>\w+)\W/g)) {
const { len, unit_name } = match.groups ?? {};
if (typeof len !== 'string' || typeof unit_name !== 'string') {
throw new Error(`Could not parse duraction spec: ${spec}`);
}
const time_unit: TimeUnit | undefined = UNIT_ABBREVIATIONS[unit_name] ?? TimeUnit[unit_name as keyof typeof TimeUnit];
if (!time_unit) {
throw new Error(`Could not determine a time unit for: ${unit_name}`);
}
length_in_ms += Number(len) * time_unit;
}
return new Duration(length_in_ms);
}
}