import sql from "../services/sql.js"; import NoteSet from "../services/search/note_set.js"; import NotFoundError from "../errors/not_found_error.js"; import BOption from "./entities/boption.js"; import BNote from "./entities/bnote.js"; import BEtapiToken from "./entities/betapi_token.js"; import BAttribute from "./entities/battribute.js"; import BBranch from "./entities/bbranch.js"; import BRevision from "./entities/brevision.js"; import BAttachment from "./entities/battachment.js"; import { AttachmentRow, BlobRow, RevisionRow } from './entities/rows.js'; import BBlob from "./entities/bblob.js"; import BRecentNote from "./entities/brecent_note.js"; import AbstractBeccaEntity from "./entities/abstract_becca_entity.js"; interface AttachmentOpts { includeContentLength?: boolean; } /** * Becca is a backend cache of all notes, branches, and attributes. * There's a similar frontend cache Froca, and share cache Shaca. */ export default class Becca { loaded!: boolean; notes!: Record; branches!: Record; childParentToBranch!: Record; attributes!: Record; /** Points from attribute type-name to list of attributes */ attributeIndex!: Record; options!: Record; etapiTokens!: Record; allNoteSetCache: NoteSet | null; constructor() { this.reset(); this.allNoteSetCache = null; } reset() { this.notes = {}; this.branches = {}; this.childParentToBranch = {}; this.attributes = {}; this.attributeIndex = {}; this.options = {}; this.etapiTokens = {}; this.dirtyNoteSetCache(); this.loaded = false; } getRoot() { return this.getNote('root'); } findAttributes(type: string, name: string): BAttribute[] { name = name.trim().toLowerCase(); if (name.startsWith('#') || name.startsWith('~')) { name = name.substr(1); } return this.attributeIndex[`${type}-${name}`] || []; } findAttributesWithPrefix(type: string, name: string): BAttribute[] { const resArr: BAttribute[][] = []; const key = `${type}-${name}`; for (const idx in this.attributeIndex) { if (idx.startsWith(key)) { resArr.push(this.attributeIndex[idx]); } } return resArr.flat(); } decryptProtectedNotes() { for (const note of Object.values(this.notes)) { note.decrypt(); } } addNote(noteId: string, note: BNote) { this.notes[noteId] = note; this.dirtyNoteSetCache(); } getNote(noteId: string): BNote | null { return this.notes[noteId]; } getNoteOrThrow(noteId: string): BNote { const note = this.notes[noteId]; if (!note) { throw new NotFoundError(`Note '${noteId}' doesn't exist.`); } return note; } getNotes(noteIds: string[], ignoreMissing: boolean = false): BNote[] { const filteredNotes: BNote[] = []; for (const noteId of noteIds) { const note = this.notes[noteId]; if (!note) { if (ignoreMissing) { continue; } throw new Error(`Note '${noteId}' was not found in becca.`); } filteredNotes.push(note); } return filteredNotes; } getBranch(branchId: string): BBranch | null { return this.branches[branchId]; } getBranchOrThrow(branchId: string): BBranch { const branch = this.getBranch(branchId); if (!branch) { throw new NotFoundError(`Branch '${branchId}' was not found in becca.`); } return branch; } getAttribute(attributeId: string): BAttribute | null { return this.attributes[attributeId]; } getAttributeOrThrow(attributeId: string): BAttribute { const attribute = this.getAttribute(attributeId); if (!attribute) { throw new NotFoundError(`Attribute '${attributeId}' does not exist.`); } return attribute; } getBranchFromChildAndParent(childNoteId: string, parentNoteId: string): BBranch | null { return this.childParentToBranch[`${childNoteId}-${parentNoteId}`]; } getRevision(revisionId: string): BRevision | null { const row = sql.getRow("SELECT * FROM revisions WHERE revisionId = ?", [revisionId]); return row ? new BRevision(row) : null; } getRevisionOrThrow(revisionId: string): BRevision { const revision = this.getRevision(revisionId); if (!revision) { throw new NotFoundError(`Revision '${revisionId}' has not been found.`); } return revision; } getAttachment(attachmentId: string, opts: AttachmentOpts = {}): BAttachment | null { opts.includeContentLength = !!opts.includeContentLength; const query = opts.includeContentLength ? `SELECT attachments.*, LENGTH(blobs.content) AS contentLength FROM attachments JOIN blobs USING (blobId) WHERE attachmentId = ? AND isDeleted = 0` : `SELECT * FROM attachments WHERE attachmentId = ? AND isDeleted = 0`; return sql.getRows(query, [attachmentId]) .map(row => new BAttachment(row))[0]; } getAttachmentOrThrow(attachmentId: string, opts: AttachmentOpts = {}): BAttachment { const attachment = this.getAttachment(attachmentId, opts); if (!attachment) { throw new NotFoundError(`Attachment '${attachmentId}' has not been found.`); } return attachment; } getAttachments(attachmentIds: string[]): BAttachment[] { return sql.getManyRows("SELECT * FROM attachments WHERE attachmentId IN (???) AND isDeleted = 0", attachmentIds) .map(row => new BAttachment(row)); } getBlob(entity: { blobId?: string }): BBlob | null { if (!entity.blobId) { return null; } const row = sql.getRow("SELECT *, LENGTH(content) AS contentLength FROM blobs WHERE blobId = ?", [entity.blobId]); return row ? new BBlob(row) : null; } getOption(name: string): BOption | null { return this.options[name]; } getEtapiTokens(): BEtapiToken[] { return Object.values(this.etapiTokens); } getEtapiToken(etapiTokenId: string): BEtapiToken | null { return this.etapiTokens[etapiTokenId]; } getEntity>(entityName: string, entityId: string): AbstractBeccaEntity | null { if (!entityName || !entityId) { return null; } if (entityName === 'revisions') { return this.getRevision(entityId); } else if (entityName === 'attachments') { return this.getAttachment(entityId); } const camelCaseEntityName = entityName.toLowerCase().replace(/(_[a-z])/g, group => group .toUpperCase() .replace('_', '') ); if (!(camelCaseEntityName in this)) { throw new Error(`Unknown entity name '${camelCaseEntityName}' (original argument '${entityName}')`); } return (this as any)[camelCaseEntityName][entityId]; } getRecentNotesFromQuery(query: string, params: string[] = []): BRecentNote[] { const rows = sql.getRows(query, params); return rows.map(row => new BRecentNote(row)); } getRevisionsFromQuery(query: string, params: string[] = []): BRevision[] { const rows = sql.getRows(query, params); return rows.map(row => new BRevision(row)); } /** Should be called when the set of all non-skeleton notes changes (added/removed) */ dirtyNoteSetCache() { this.allNoteSetCache = null; } getAllNoteSet() { // caching this since it takes 10s of milliseconds to fill this initial NoteSet for many notes if (!this.allNoteSetCache) { const allNotes = []; for (const noteId in this.notes) { const note = this.notes[noteId]; // in the process of loading data sometimes we create "skeleton" note instances which are expected to be filled later // in case of inconsistent data this might not work and search will then crash on these if (note.type !== undefined) { allNotes.push(note); } } this.allNoteSetCache = new NoteSet(allNotes); } return this.allNoteSetCache; } } /** * This interface contains the data that is shared across all the objects of a given derived class of {@link AbstractBeccaEntity}. * For example, all BAttributes will share their content, but all BBranches will have another set of this data. */ export interface ConstructorData> { primaryKeyName: string; entityName: string; hashedProperties: (keyof T)[]; } export interface NotePojo { noteId: string; title?: string; isProtected?: boolean; type: string; mime: string; blobId?: string; isDeleted: boolean; dateCreated?: string; dateModified?: string; utcDateCreated: string; utcDateModified?: string; }