Files
server/src/util/entities/ReadState.ts
2026-02-23 06:53:08 +01:00

94 lines
3.0 KiB
TypeScript

/*
Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
Copyright (C) 2023 Spacebar and Spacebar Contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
import { Column, Entity, Index, JoinColumn, ManyToOne, RelationId } from "typeorm";
import { BaseClass } from "./BaseClass";
import { Channel } from "./Channel";
import { User } from "./User";
import { ReadStateFlags, ReadStateType } from "@spacebar/schemas";
// for read receipts
// notification cursor and public read receipt need to be forwards-only (the former to prevent re-pinging when marked as unread, and the latter to be acceptable as a legal acknowledgement in criminal proceedings), and private read marker needs to be advance-rewind capable
// public read receipt ≥ notification cursor ≥ private fully read marker
@Entity({
name: "read_states",
})
@Index(["channel_id", "user_id"], { unique: true })
export class ReadState extends BaseClass {
@Column()
@RelationId((read_state: ReadState) => read_state.channel)
channel_id: string;
@JoinColumn({ name: "channel_id" })
@ManyToOne(() => Channel, {
onDelete: "CASCADE",
})
channel: Channel;
@Column()
@RelationId((read_state: ReadState) => read_state.user)
user_id: string;
@JoinColumn({ name: "user_id" })
@ManyToOne(() => User, {
onDelete: "CASCADE",
})
user: User;
@Column({ nullable: true })
last_message_id?: string;
@Column({ nullable: true })
last_acked_id?: string;
@Column({ nullable: true })
notifications_cursor: string;
@Column({ default: 0 })
mention_count: number;
@Column({ default: 0 })
badge_count: number;
@Column({ nullable: true })
last_pin_timestamp?: Date;
@Column({ default: ReadStateType.CHANNEL })
read_state_type: ReadStateType;
@Column({ default: 0 })
flags: ReadStateFlags;
toJSON() {
const res = { ...this } as Partial<ReadState>;
if (this.read_state_type === ReadStateType.CHANNEL) {
delete res.badge_count;
delete res.last_acked_id;
} else {
delete res.mention_count; // mutually exclusive with badge_count
delete res.last_message_id; // mutually exclusive with last_acked_id
// these only apply to channels:
delete res.last_pin_timestamp;
delete res.flags;
// delete res.last_viewed; // TODO
}
return res;
}
}