import { Fyo } from 'fyo'; import { Converter } from 'fyo/core/converter'; import { DocValue, DocValueMap } from 'fyo/core/types'; import { Verb } from 'fyo/telemetry/types'; import { DEFAULT_USER } from 'fyo/utils/consts'; import { ConflictError, MandatoryError, NotFoundError } from 'fyo/utils/errors'; import Observable from 'fyo/utils/observable'; import { Money } from 'pesa'; import { Field, FieldTypeEnum, OptionField, RawValue, Schema, TargetField, } from 'schemas/types'; import { getIsNullOrUndef, getMapFromList, getRandomString } from 'utils'; import { markRaw } from 'vue'; import { isPesa } from '../utils/index'; import { areDocValuesEqual, getMissingMandatoryMessage, getPreDefaultValues, setChildDocIdx, shouldApplyFormula, } from './helpers'; import { setName } from './naming'; import { Action, ChangeArg, CurrenciesMap, DefaultMap, EmptyMessageMap, FiltersMap, FormulaMap, FormulaReturn, HiddenMap, ListsMap, ListViewSettings, ReadOnlyMap, RequiredMap, TreeViewSettings, ValidationMap, } from './types'; import { validateOptions, validateRequired } from './validationFunction'; export class Doc extends Observable { name?: string; schema: Readonly; fyo: Fyo; fieldMap: Record; /** * Fields below are used by child docs to maintain * reference w.r.t their parent doc. */ idx?: number; parentdoc?: Doc; parentFieldname?: string; parentSchemaName?: string; _links?: Record; _dirty: boolean = true; _notInserted: boolean = true; _syncing = false; constructor(schema: Schema, data: DocValueMap, fyo: Fyo) { super(); this.fyo = markRaw(fyo); this.schema = schema; this.fieldMap = getMapFromList(schema.fields, 'fieldname'); if (this.schema.isSingle) { this.name = this.schemaName; } this._setDefaults(); this._setValuesWithoutChecks(data); } get schemaName(): string { return this.schema.name; } get notInserted(): boolean { return this._notInserted; } get inserted(): boolean { return !this._notInserted; } get tableFields(): TargetField[] { return this.schema.fields.filter( (f) => f.fieldtype === FieldTypeEnum.Table ) as TargetField[]; } get dirty() { return this._dirty; } get quickEditFields() { let fieldnames = this.schema.quickEditFields; if (fieldnames === undefined) { fieldnames = []; } if (fieldnames.length === 0 && this.fieldMap['name']) { fieldnames = ['name']; } return fieldnames.map((f) => this.fieldMap[f]); } get isSubmitted() { return !!this.submitted && !this.cancelled; } get isCancelled() { return !!this.submitted && !!this.cancelled; } get syncing() { return this._syncing; } _setValuesWithoutChecks(data: DocValueMap) { for (const field of this.schema.fields) { const fieldname = field.fieldname; const value = data[field.fieldname]; if (Array.isArray(value)) { for (const row of value) { this.push(fieldname, row); } } else if (value !== undefined) { this[fieldname] = Converter.toDocValue( value as RawValue, field, this.fyo ); } else { this[fieldname] = this[fieldname] ?? null; } if (field.fieldtype === FieldTypeEnum.Table && !this[fieldname]) { this[fieldname] = []; } } } _setDirty(value: boolean) { this._dirty = value; if (this.schema.isChild && this.parentdoc) { this.parentdoc._dirty = value; } } // set value and trigger change async set( fieldname: string | DocValueMap, value?: DocValue | Doc[] | DocValueMap[] ): Promise { if (typeof fieldname === 'object') { return await this.setMultiple(fieldname as DocValueMap); } if (!this._canSet(fieldname, value)) { return false; } this._setDirty(true); if (typeof value === 'string') { value = value.trim(); } if (Array.isArray(value)) { for (const row of value) { this.push(fieldname, row); } } else { const field = this.fieldMap[fieldname]; await this._validateField(field, value); this[fieldname] = value; } // always run applyChange from the parentdoc if (this.schema.isChild && this.parentdoc) { await this._applyChange(fieldname); await this.parentdoc._applyChange(this.parentFieldname as string); } else { await this._applyChange(fieldname); } return true; } async setMultiple(docValueMap: DocValueMap): Promise { let hasSet = false; for (const fieldname in docValueMap) { const isSet = await this.set( fieldname, docValueMap[fieldname] as DocValue | Doc[] ); hasSet ||= isSet; } return hasSet; } _canSet( fieldname: string, value?: DocValue | Doc[] | DocValueMap[] ): boolean { if (fieldname === 'numberSeries' && !this.notInserted) { return false; } if (value === undefined) { return false; } if (this.fieldMap[fieldname] === undefined) { return false; } const currentValue = this.get(fieldname); if (currentValue === undefined) { return true; } return !areDocValuesEqual(currentValue as DocValue, value as DocValue); } async _applyChange(fieldname: string): Promise { await this._applyFormula(fieldname); await this.trigger('change', { doc: this, changed: fieldname, }); return true; } _setDefaults() { for (const field of this.schema.fields) { let defaultValue: DocValue | Doc[] = getPreDefaultValues( field.fieldtype, this.fyo ); const defaultFunction = this.fyo.models[this.schemaName]?.defaults?.[field.fieldname]; if (defaultFunction !== undefined) { defaultValue = defaultFunction(); } else if (field.default !== undefined) { defaultValue = field.default; } if (field.fieldtype === FieldTypeEnum.Currency && !isPesa(defaultValue)) { defaultValue = this.fyo.pesa!(defaultValue as string | number); } this[field.fieldname] = defaultValue; } } async remove(fieldname: string, idx: number) { const childDocs = ((this[fieldname] ?? []) as Doc[]).filter( (row, i) => row.idx !== idx || i !== idx ); setChildDocIdx(childDocs); this[fieldname] = childDocs; this._setDirty(true); return await this._applyChange(fieldname); } async append(fieldname: string, docValueMap: DocValueMap = {}) { this.push(fieldname, docValueMap); this._setDirty(true); return await this._applyChange(fieldname); } push(fieldname: string, docValueMap: Doc | DocValueMap = {}) { const childDocs = [ (this[fieldname] ?? []) as Doc[], this._getChildDoc(docValueMap, fieldname), ].flat(); setChildDocIdx(childDocs); this[fieldname] = childDocs; } _getChildDoc(docValueMap: Doc | DocValueMap, fieldname: string): Doc { if (!this.name) { this.name = getRandomString(); } docValueMap.name ??= getRandomString(); // Child Meta Fields docValueMap.parent ??= this.name; docValueMap.parentSchemaName ??= this.schemaName; docValueMap.parentFieldname ??= fieldname; if (docValueMap instanceof Doc) { docValueMap.parentdoc ??= this; return docValueMap; } const childSchemaName = (this.fieldMap[fieldname] as TargetField).target; const childDoc = this.fyo.doc.getNewDoc( childSchemaName, docValueMap, false ); childDoc.parentdoc = this; return childDoc; } async _validateSync() { this._validateMandatory(); await this._validateFields(); } _validateMandatory() { const checkForMandatory: Doc[] = [this]; const tableFields = this.schema.fields.filter( (f) => f.fieldtype === FieldTypeEnum.Table ) as TargetField[]; for (const field of tableFields) { const childDocs = this.get(field.fieldname) as Doc[]; if (!childDocs) { continue; } checkForMandatory.push(...childDocs); } const missingMandatoryMessage = checkForMandatory .map((doc) => getMissingMandatoryMessage(doc)) .filter(Boolean); if (missingMandatoryMessage.length > 0) { const fields = missingMandatoryMessage.join('\n'); const message = this.fyo.t`Value missing for ${fields}`; throw new MandatoryError(message); } } async _validateFields() { const fields = this.schema.fields; for (const field of fields) { if (field.fieldtype === FieldTypeEnum.Table) { continue; } const value = this.get(field.fieldname) as DocValue; await this._validateField(field, value); } } async _validateField(field: Field, value: DocValue) { if ( field.fieldtype === FieldTypeEnum.Select || field.fieldtype === FieldTypeEnum.AutoComplete ) { validateOptions(field as OptionField, value as string, this); } validateRequired(field, value, this); if (getIsNullOrUndef(value)) { return; } const validator = this.validations[field.fieldname]; if (validator === undefined) { return; } await validator(value); } getValidDict( filterMeta: boolean = false, filterComputed: boolean = false ): DocValueMap { let fields = this.schema.fields; if (filterMeta) { fields = this.schema.fields.filter((f) => !f.meta); } if (filterComputed) { fields = this.schema.fields.filter((f) => !f.computed); } const data: DocValueMap = {}; for (const field of fields) { let value = this[field.fieldname] as DocValue | DocValueMap[]; if (Array.isArray(value)) { value = value.map((doc) => (doc as Doc).getValidDict(filterMeta, filterComputed) ); } if (isPesa(value)) { value = (value as Money).copy(); } if (value === null && this.schema.isSingle) { continue; } data[field.fieldname] = value; } return data; } _setBaseMetaValues() { if (this.schema.isSubmittable) { this.submitted = false; this.cancelled = false; } if (!this.createdBy) { this.createdBy = this.fyo.auth.session.user || DEFAULT_USER; } if (!this.created) { this.created = new Date(); } this._updateModifiedMetaValues(); } _updateModifiedMetaValues() { this.modifiedBy = this.fyo.auth.session.user || DEFAULT_USER; this.modified = new Date(); } async load() { if (this.name === undefined) { return; } const data = await this.fyo.db.get(this.schemaName, this.name); if (this.schema.isSingle && !data?.name) { data.name = this.name!; } if (data && data.name) { await this._syncValues(data); await this.loadLinks(); } else { throw new NotFoundError(`Not Found: ${this.schemaName} ${this.name}`); } this._setDirty(false); this._notInserted = false; this.fyo.doc.observer.trigger(`load:${this.schemaName}`, this.name); } async loadLinks() { this._links = {}; const linkFields = this.schema.fields.filter( (f) => f.fieldtype === FieldTypeEnum.Link || f.inline ); for (const f of linkFields) { await this.loadLink(f.fieldname); } } async loadLink(fieldname: string) { this._links ??= {}; const field = this.fieldMap[fieldname] as TargetField; if (field === undefined) { return; } const value = this.get(fieldname); if (getIsNullOrUndef(value) || field.target === undefined) { return; } this._links[fieldname] = await this.fyo.doc.getDoc( field.target, value as string ); } getLink(fieldname: string): Doc | null { const link = this._links?.[fieldname]; if (link === undefined) { return null; } return link; } async _syncValues(data: DocValueMap) { this._clearValues(); this._setValuesWithoutChecks(data); await this._setComputedValuesFromFormulas(); this._dirty = false; this.trigger('change', { doc: this, }); } async _setComputedValuesFromFormulas() { for (const field of this.schema.fields) { await this._setComputedValuesForChildren(field); if (!field.computed) { continue; } const value = await this._getValueFromFormula(field, this); this[field.fieldname] = value ?? null; } } async _setComputedValuesForChildren(field: Field) { if (field.fieldtype !== 'Table') { return; } const childDocs: Doc[] = (this[field.fieldname] as Doc[]) ?? []; for (const doc of childDocs) { await doc._setComputedValuesFromFormulas(); } } _clearValues() { for (const { fieldname } of this.schema.fields) { this[fieldname] = null; } this._dirty = true; this._notInserted = true; } _setChildDocsIdx() { const childFields = this.schema.fields.filter( (f) => f.fieldtype === FieldTypeEnum.Table ) as TargetField[]; for (const field of childFields) { const childDocs = (this.get(field.fieldname) as Doc[]) ?? []; setChildDocIdx(childDocs); } } async _validateDbNotModified() { if (this.notInserted || !this.name || this.schema.isSingle) { return; } const dbValues = await this.fyo.db.get(this.schemaName, this.name); const docModified = (this.modified as Date)?.toISOString(); const dbModified = (dbValues.modified as Date)?.toISOString(); if (dbValues && docModified !== dbModified) { throw new ConflictError( this.fyo .t`${this.schema.label} ${this.name} has been modified after loading` + ` ${dbModified}, ${docModified}` ); } } async _applyFormula(fieldname?: string): Promise { const doc = this; let changed = false; const childDocs = this.tableFields .map((f) => (this.get(f.fieldname) as Doc[]) ?? []) .flat(); // children for (const row of childDocs) { changed ||= (await row?._applyFormula()) ?? false; } // parent or child row const formulaFields = Object.keys(this.formulas).map( (fn) => this.fieldMap[fn] ); changed ||= await this._applyFormulaForFields( formulaFields, doc, fieldname ); return changed; } async _applyFormulaForFields( formulaFields: Field[], doc: Doc, fieldname?: string ) { let changed = false; for (const field of formulaFields) { const shouldApply = shouldApplyFormula(field, doc, fieldname); if (!shouldApply) { continue; } const newVal = await this._getValueFromFormula(field, doc, fieldname); const previousVal = doc.get(field.fieldname); const isSame = areDocValuesEqual(newVal as DocValue, previousVal); if (newVal === undefined || isSame) { continue; } doc[field.fieldname] = newVal; changed = true; } return changed; } async _getValueFromFormula(field: Field, doc: Doc, fieldname?: string) { const { formula } = doc.formulas[field.fieldname] ?? {}; if (formula === undefined) { return; } let value: FormulaReturn; try { value = await formula(fieldname); } catch { return; } if (Array.isArray(value) && field.fieldtype === FieldTypeEnum.Table) { value = value.map((row) => this._getChildDoc(row, field.fieldname)); } return value; } async _preSync() { this._setChildDocsIdx(); await this._applyFormula(); await this._validateSync(); await this.trigger('validate'); } async _insert() { await setName(this, this.fyo); this._setBaseMetaValues(); await this._preSync(); const validDict = this.getValidDict(false, true); const data = await this.fyo.db.insert(this.schemaName, validDict); await this._syncValues(data); this.fyo.telemetry.log(Verb.Created, this.schemaName); return this; } async _update() { await this._validateDbNotModified(); this._updateModifiedMetaValues(); await this._preSync(); const data = this.getValidDict(false, true); await this.fyo.db.update(this.schemaName, data); await this._syncValues(data); return this; } async sync(): Promise { this._syncing = true; await this.trigger('beforeSync'); let doc; if (this.notInserted) { doc = await this._insert(); } else { doc = await this._update(); } this._notInserted = false; await this.trigger('afterSync'); this.fyo.doc.observer.trigger(`sync:${this.schemaName}`, this.name); this._syncing = false; return doc; } async delete() { if (this.schema.isSubmittable && !this.isCancelled) { return; } await this.trigger('beforeDelete'); await this.fyo.db.delete(this.schemaName, this.name!); await this.trigger('afterDelete'); this.fyo.telemetry.log(Verb.Deleted, this.schemaName); this.fyo.doc.observer.trigger(`delete:${this.schemaName}`, this.name); } async submit() { if (!this.schema.isSubmittable || this.submitted || this.cancelled) { return; } await this.trigger('beforeSubmit'); await this.setAndSync('submitted', true); await this.trigger('afterSubmit'); this.fyo.telemetry.log(Verb.Submitted, this.schemaName); this.fyo.doc.observer.trigger(`submit:${this.schemaName}`, this.name); } async cancel() { if (!this.schema.isSubmittable || !this.submitted || this.cancelled) { return; } await this.trigger('beforeCancel'); await this.setAndSync('cancelled', true); await this.trigger('afterCancel'); this.fyo.telemetry.log(Verb.Cancelled, this.schemaName); this.fyo.doc.observer.trigger(`cancel:${this.schemaName}`, this.name); } async rename(newName: string) { if (this.submitted) { return; } const oldName = this.name; await this.trigger('beforeRename', { oldName, newName }); await this.fyo.db.rename(this.schemaName, this.name!, newName); this.name = newName; await this.trigger('afterRename', { oldName, newName }); this.fyo.doc.observer.trigger(`rename:${this.schemaName}`, this.name); } async trigger(event: string, params?: unknown) { if (this[event]) { await (this[event] as Function)(params); } await super.trigger(event, params); } getSum(tablefield: string, childfield: string, convertToFloat = true) { const childDocs = (this.get(tablefield) as Doc[]) ?? []; const sum = childDocs .map((d) => { const value = d.get(childfield) ?? 0; if (!isPesa(value)) { try { return this.fyo.pesa(value as string | number); } catch (err) { ( err as Error ).message += ` value: '${value}' of type: ${typeof value}, fieldname: '${tablefield}', childfield: '${childfield}'`; throw err; } } return value as Money; }) .reduce((a, b) => a.add(b), this.fyo.pesa(0)); if (convertToFloat) { return sum.float; } return sum; } async setAndSync(fieldname: string | DocValueMap, value?: DocValue | Doc[]) { await this.set(fieldname, value); return await this.sync(); } duplicate(): Doc { const updateMap = this.getValidDict(true, true); for (const field in updateMap) { const value = updateMap[field]; if (!Array.isArray(value)) { continue; } for (const row of value) { delete row.name; } } if (this.numberSeries) { delete updateMap.name; } else { updateMap.name = updateMap.name + ' CPY'; } return this.fyo.doc.getNewDoc(this.schemaName, updateMap); } /** * Lifecycle Methods * * Abstractish methods that are called using `this.trigger`. * These are to be overridden if required when subclassing. * * Refrain from running methods that call `this.sync` * in the `beforeLifecycle` methods. * * This may cause the lifecycle function to execute incorrectly. */ async change(ch: ChangeArg) {} async validate() {} async beforeSync() {} async afterSync() {} async beforeSubmit() {} async afterSubmit() {} async beforeRename() {} async afterRename() {} async beforeCancel() {} async afterCancel() {} async beforeDelete() {} async afterDelete() {} formulas: FormulaMap = {}; validations: ValidationMap = {}; required: RequiredMap = {}; hidden: HiddenMap = {}; readOnly: ReadOnlyMap = {}; getCurrencies: CurrenciesMap = {}; static lists: ListsMap = {}; static filters: FiltersMap = {}; static createFilters: FiltersMap = {}; // Used by the *Create* dropdown option static defaults: DefaultMap = {}; static emptyMessages: EmptyMessageMap = {}; static getListViewSettings(fyo: Fyo): ListViewSettings { return {}; } static getTreeSettings(fyo: Fyo): TreeViewSettings | void {} static getActions(fyo: Fyo): Action[] { return []; } }