@rapidmx/crm-plugin 0.1.0

package/dist/lib/routes/BaseTaggedRecordRoute.js

@@ -0,0 +1,312 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ObjectDecorators } from "@rapidrest/core";
+import { ModelUtils, RouteDecorators } from "@rapidrest/service-core";
+import { compileFilter, filterFields, validateFilter } from "../filters/Filter.js";
+import { CrmObjectType, TimelineKind, WorkspaceAction } from "../models/types.js";
+import { csvLine } from "../util/Csv.js";
+import { TAGS_KEY, deleteValues, propertiesView, readProperties, readValues, writeValues, } from "../util/PropertyValues.js";
+import { MAX_TAGS, badRequest, readTags, requireObject } from "../util/Validation.js";
+import { BaseWorkspaceRecordRoute } from "./BaseWorkspaceRecordRoute.js";
+import { CrmEventType, recordCrmEvent } from "../automation/Events.js";
+const { Config } = ObjectDecorators;
+const { Param, Post, Response, User: AuthUser } = RouteDecorators;
+/** How many records one bulk request may change. */
+export const MAX_BULK = 500;
+/** How many records one export may hold, by default (`mail:crm:export:max_rows`). */
+export const MAX_EXPORT_ROWS = 50000;
+/**
+ * What contacts and companies share on top of `BaseWorkspaceRecordRoute`: tags and custom properties on every write (a request's
+ * `tags` and `properties`, stored as `PropertyValue` rows - `util/PropertyValues.ts`), filtered search (`filter` compiled by
+ * `filters/Filter.ts`, and `q` for a quick text search), bulk actions, CSV export, and an activity timeline entry for every create
+ * and change. Deleting a record deletes its values, notes and timeline, and unlinks the tasks about it.
+ */
+export class BaseTaggedRecordRoute extends BaseWorkspaceRecordRoute {
+    constructor() {
+        super(...arguments);
+        /** How many records one export may hold. */
+        this.maxExportRows = MAX_EXPORT_ROWS;
+        /** How many records an export reads at a time. */
+        this.exportPageSize = 1000;
+    }
+    /**
+     * Creates or updates one record from an imported row (`body` in the shape of a create request, as `CrmImportJob` builds it), with
+     * the same checks and side effects as the API: a row the same as an existing record updates it when `updateExisting` is set -
+     * adding its tags to the record's rather than replacing them - and is skipped otherwise. A bad row throws its 400.
+     */
+    async importRow(workspaceUid, userUid, body, updateExisting) {
+        const context = { workspaceUid, user: { uid: userUid } };
+        const repo = await this.records();
+        const existing = await this.findExisting(workspaceUid, body);
+        if (existing) {
+            if (!updateExisting) {
+                return { outcome: "skipped", uid: existing.uid };
+            }
+            const request = { ...body };
+            if (Array.isArray(body.tags)) {
+                request.tags = [...new Set([...(existing.tags ?? []), ...body.tags])];
+            }
+            const fields = await this.readUpdate(request, existing, context);
+            const updated = await repo.update({ ...fields, uid: existing.uid, version: existing.version }, existing, {
+                ignoreACL: true,
+                skipPush: true,
+            });
+            await this.afterWrite(updated, existing, request, context);
+            return { outcome: "updated", uid: updated.uid };
+        }
+        const fields = await this.readCreate(body, context);
+        const modelClass = this.classes[this.model];
+        const record = await repo.create(new modelClass({ ...fields, workspaceUid }), { ignoreACL: true, skipPush: true });
+        await this.afterWrite(record, undefined, body, context);
+        return { outcome: "created", uid: record.uid };
+    }
+    /** The workspace's custom property definitions for this record type. */
+    async definitions(workspaceUid) {
+        return await (await this.repo("propertyDefinition")).find({ workspaceUid: ModelUtils.literal(workspaceUid), objectType: ModelUtils.literal(this.objectType), sort: { dateCreated: "ASC" } }, { ignoreACL: true, limit: 1000, skipCache: true });
+    }
+    async toViews(records, workspaceUid) {
+        if (records.length === 0) {
+            return [];
+        }
+        const definitions = await this.definitions(workspaceUid);
+        const values = await readValues(await this.repo("propertyValue"), records.map((record) => record.uid));
+        return records.map((record) => ({ ...JSON.parse(JSON.stringify(record)), properties: propertiesView(values.get(record.uid), definitions) }));
+    }
+    /** Checks a write's `properties` before the record is written, so a bad value fails the whole request. */
+    async readPropertyWrites(body, workspaceUid) {
+        return readProperties(body.properties, await this.definitions(workspaceUid), this.objectType);
+    }
+    async afterWrite(record, before, body, context) {
+        const valueRepo = await this.repo("propertyValue");
+        const owner = { workspaceUid: context.workspaceUid, objectType: this.objectType, objectUid: record.uid };
+        if (!before || body.tags !== undefined) {
+            await writeValues(valueRepo, this.classes.propertyValue, owner, TAGS_KEY, record.tags.map((tag) => ({ stringValue: tag })));
+        }
+        const properties = await this.readPropertyWrites(body, context.workspaceUid);
+        for (const [key, values] of properties) {
+            await writeValues(valueRepo, this.classes.propertyValue, owner, key, values);
+        }
+        const changed = before
+            ? [
+                ...Object.keys(body).filter((field) => field !== "version" && field !== "properties" && JSON.stringify(before[field]) !== JSON.stringify(record[field])),
+                ...[...properties.keys()].map((key) => `properties.${key}`),
+            ]
+            : [];
+        if (!before || changed.length > 0) {
+            await this.addTimeline({
+                workspaceUid: context.workspaceUid,
+                subjectType: this.objectType,
+                subjectUid: record.uid,
+                kind: before ? TimelineKind.UPDATED : TimelineKind.CREATED,
+                summary: before ? `Updated ${changed.join(", ")}` : `Created the ${this.noun}`,
+                // An import or a form submission by nobody in particular has no actor.
+                actorUserUid: context.user.uid.toLowerCase() || undefined,
+                data: before ? { fields: changed } : {},
+            });
+            if (this.objectType === CrmObjectType.CONTACT) {
+                await recordCrmEvent(this.repos(), this.classes, {
+                    workspaceUid: context.workspaceUid,
+                    type: before ? CrmEventType.CONTACT_UPDATED : CrmEventType.CONTACT_CREATED,
+                    contactUid: record.uid,
+                    data: before ? { fields: changed } : {},
+                }, this.logger);
+            }
+        }
+    }
+    /**
+     * Changes `existing` as `PUT /:workspaceUid/:uid` with `body` would, on behalf of `actorUid` (empty for nobody in particular) - for
+     * automations, which change records outside any request. Returns the record as saved.
+     */
+    async applyUpdate(workspaceUid, actorUid, existing, body) {
+        const context = { workspaceUid, user: { uid: actorUid } };
+        const fields = await this.readUpdate(body, existing, context);
+        const updated = await (await this.records()).update({ ...fields, uid: existing.uid, version: existing.version }, existing, {
+            ignoreACL: true,
+            skipPush: true,
+        });
+        await this.afterWrite(updated, existing, body, context);
+        return updated;
+    }
+    async afterDelete(record, context) {
+        await this.deleteRelated([record.uid], context.workspaceUid);
+    }
+    /** Deletes what belongs to the records `uids` - their values, notes and timeline - and unlinks the tasks about them. */
+    async deleteRelated(uids, workspaceUid) {
+        await deleteValues(await this.repo("propertyValue"), uids);
+        const scope = { workspaceUid: ModelUtils.literal(workspaceUid), subjectUid: ModelUtils.literal(uids, "in") };
+        await (await this.repo("note")).truncate(scope, { ignoreACL: true, skipPush: true });
+        await (await this.repo("timelineEvent")).truncate(scope, { ignoreACL: true, skipPush: true });
+        const taskRepo = await this.repo("task");
+        for (const task of await taskRepo.find(scope, { ignoreACL: true, limit: 1000, skipCache: true })) {
+            await taskRepo.update({ uid: task.uid, version: task.version, subjectType: null, subjectUid: null }, new this.classes.task(task), {
+                ignoreACL: true,
+                skipPush: true,
+            });
+        }
+    }
+    async searchQuery(body, workspaceUid) {
+        const conditions = [];
+        if (body.filter !== undefined && body.filter !== null) {
+            const fields = filterFields(this.recordFields, await this.definitions(workspaceUid), this.objectType);
+            const filter = validateFilter(body.filter, fields);
+            conditions.push(await compileFilter(filter, fields, {
+                workspaceUid,
+                objectType: this.objectType,
+                valueRepo: await this.repo("propertyValue"),
+                recordRepo: await this.records(),
+            }));
+        }
+        if (body.q !== undefined && body.q !== null && body.q !== "") {
+            if (typeof body.q !== "string" || body.q.length > 256) {
+                throw badRequest("'q' must be text of at most 256 characters.");
+            }
+            const words = body.q.replace(/[*?()]/g, "").trim();
+            if (words.length > 0) {
+                conditions.push({ $or: this.textFields.map((field) => ({ [field]: `like(*${words}*)` })) });
+            }
+        }
+        return conditions.length === 0 ? undefined : conditions.length === 1 ? conditions[0] : { $and: conditions };
+    }
+    /**
+     * Applies one action to up to `MAX_BULK` records: `delete`, `addTags`/`removeTags` (`tags`), or `setOwner` (`ownerUserUid`, a
+     * member, or `null`). Records that aren't the workspace's are skipped. Answers how many were changed.
+     */
+    async bulk(workspaceUid, body, user) {
+        await this.requireAccess(user, workspaceUid, WorkspaceAction.WRITE);
+        const request = requireObject(body);
+        const uids = request.uids;
+        if (!Array.isArray(uids) || uids.length === 0 || uids.length > MAX_BULK || uids.some((uid) => typeof uid !== "string")) {
+            throw badRequest(`'uids' must be a list of 1 to ${MAX_BULK} record uids.`);
+        }
+        const action = request.action;
+        const repo = await this.records();
+        const records = await repo.find({ workspaceUid: ModelUtils.literal(workspaceUid), uid: ModelUtils.literal([...new Set(uids)], "in") }, { ignoreACL: true, limit: MAX_BULK, skipCache: true });
+        const context = { workspaceUid, user: user };
+        const modelClass = this.classes[this.model];
+        switch (action) {
+            case "delete": {
+                for (const record of records) {
+                    await repo.delete(record.uid, { ignoreACL: true, purge: true, skipPush: true });
+                }
+                await this.deleteRelated(records.map((record) => record.uid), workspaceUid);
+                break;
+            }
+            case "addTags":
+            case "removeTags": {
+                const tags = readTags(request);
+                if (!tags || tags.length === 0) {
+                    throw badRequest("'tags' must list at least one tag.");
+                }
+                for (const record of records) {
+                    const current = record.tags;
+                    const next = action === "addTags" ? [...current, ...tags.filter((tag) => !current.includes(tag))] : current.filter((tag) => !tags.includes(tag));
+                    if (next.length > MAX_TAGS) {
+                        throw badRequest(`A record may have at most ${MAX_TAGS} tags.`);
+                    }
+                    if (next.length !== current.length) {
+                        await this.writeBulk(repo, modelClass, record, { tags: next }, context);
+                    }
+                }
+                break;
+            }
+            case "setOwner": {
+                const owner = await this.requireMemberUid(workspaceUid, request.ownerUserUid === null ? null : typeof request.ownerUserUid === "string" ? request.ownerUserUid : undefined, "ownerUserUid");
+                if (owner === undefined) {
+                    throw badRequest("'ownerUserUid' must be a member's user uid, or null.");
+                }
+                for (const record of records) {
+                    await this.writeBulk(repo, modelClass, record, { ownerUserUid: owner }, context);
+                }
+                break;
+            }
+            default:
+                throw badRequest("'action' must be one of: delete, addTags, removeTags, setOwner.");
+        }
+        this.notify(workspaceUid, this.pushType, action === "delete" ? "delete" : "update", { uids: records.map((record) => record.uid) });
+        return { changed: records.length };
+    }
+    /** One record's bulk change, through the same `afterWrite()` a single update runs. */
+    async writeBulk(repo, modelClass, record, fields, context) {
+        const before = new modelClass(record);
+        const updated = await repo.update({ ...fields, uid: record.uid, version: record.version }, before, { ignoreACL: true, skipPush: true });
+        await this.afterWrite(updated, before, fields, context);
+    }
+    /**
+     * The records matching a search (`filter`, `q`, `sort` - as `POST /:workspaceUid/search`) as a CSV file: the record's own fields,
+     * then `tags` (separated by `;`), then one column per custom property. At most `MAX_EXPORT_ROWS` rows.
+     */
+    async export(workspaceUid, body, res, user) {
+        await this.requireAccess(user, workspaceUid, WorkspaceAction.READ);
+        const request = body === undefined ? {} : requireObject(body);
+        const query = { workspaceUid: ModelUtils.literal(workspaceUid), sort: { dateCreated: "ASC" } };
+        const conditions = await this.searchQuery(request, workspaceUid);
+        if (conditions) {
+            query.$and = [conditions];
+        }
+        const definitions = await this.definitions(workspaceUid);
+        const repo = await this.records();
+        const lines = [csvLine(["uid", ...this.exportFields, "tags", ...definitions.map((definition) => `properties.${definition.key}`)])];
+        // `lines` holds the header too: it has more rows than records.
+        for (let page = 0; lines.length - 1 <= this.maxExportRows; page++) {
+            const records = await repo.find(query, { ignoreACL: true, limit: this.exportPageSize, page, skipCache: true });
+            for (const view of await this.toViews(records, workspaceUid)) {
+                const properties = view.properties;
+                lines.push(csvLine([
+                    view.uid,
+                    ...this.exportFields.map((field) => view[field]),
+                    view.tags.join(";"),
+                    ...definitions.map((definition) => {
+                        const value = properties[definition.key];
+                        return Array.isArray(value) ? value.join(";") : value;
+                    }),
+                ]));
+            }
+            if (records.length < this.exportPageSize) {
+                break;
+            }
+        }
+        if (lines.length - 1 > this.maxExportRows) {
+            throw badRequest(`An export may hold at most ${this.maxExportRows} records; narrow it down with a filter.`);
+        }
+        res.setHeader("content-type", "text/csv; charset=utf-8");
+        res.setHeader("content-disposition", `attachment; filename="${this.noun}s.csv"`);
+        res.send(`${lines.join("")}`);
+        return res;
+    }
+}
+__decorate([
+    Config("mail:crm:export:max_rows", MAX_EXPORT_ROWS),
+    __metadata("design:type", Number)
+], BaseTaggedRecordRoute.prototype, "maxExportRows", void 0);
+__decorate([
+    Post("/:workspaceUid/bulk"),
+    __param(0, Param("workspaceUid")),
+    __param(2, AuthUser),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], BaseTaggedRecordRoute.prototype, "bulk", null);
+__decorate([
+    Post("/:workspaceUid/export"),
+    __param(0, Param("workspaceUid")),
+    __param(2, Response),
+    __param(3, AuthUser),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], BaseTaggedRecordRoute.prototype, "export", null);
+//# sourceMappingURL=BaseTaggedRecordRoute.js.map

package/dist/lib/routes/BaseTaggedRecordRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTaggedRecordRoute.js","sourceRoot":"","sources":["../../../src/routes/BaseTaggedRecordRoute.ts"],"names":[],"mappings":"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"}

package/dist/lib/routes/BaseTaskRoute.js

@@ -0,0 +1,116 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ModelUtils } from "@rapidrest/service-core";
+import { TaskPriority, TaskStatus, TimelineKind } from "../models/types.js";
+import { MAX_LONG_TEXT, badRequest, readDate, readEnum, readText } from "../util/Validation.js";
+import { BaseWorkspaceRecordRoute } from "./BaseWorkspaceRecordRoute.js";
+/**
+ * A workspace's tasks (`/api/mail/crm/tasks`) - see `BaseWorkspaceRecordRoute` for the endpoints. `GET /:workspaceUid` takes `status`,
+ * `assigneeUserUid` and `subjectUid`. A task is assigned to a member (its creator unless it says otherwise) and may be about a
+ * contact or company, whose timeline then shows it being created and done. Marking a task `done` stamps `completedAt`; reopening it
+ * clears it.
+ */
+export class BaseTaskRoute extends BaseWorkspaceRecordRoute {
+    constructor() {
+        super(...arguments);
+        this.model = "task";
+        this.pushType = "CrmTask";
+        this.sortFields = ["dueAt", "priority", "status", "title"];
+    }
+    async readCreate(body, context) {
+        const fields = await this.readFields(body, context);
+        if (!fields.title) {
+            throw badRequest("'title' is required.");
+        }
+        if (body.subjectType !== undefined || body.subjectUid !== undefined) {
+            Object.assign(fields, await this.requireSubject(context.workspaceUid, body.subjectType, body.subjectUid));
+        }
+        fields.assigneeUserUid ?? (fields.assigneeUserUid = context.user.uid.toLowerCase());
+        fields.createdByUserUid = context.user.uid.toLowerCase();
+        if (fields.status === TaskStatus.DONE) {
+            fields.completedAt = new Date();
+        }
+        return fields;
+    }
+    async readUpdate(body, existing, context) {
+        const fields = await this.readFields(body, context);
+        if (fields.title === null) {
+            throw badRequest("'title' is required.");
+        }
+        if (body.subjectType === null || body.subjectUid === null) {
+            fields.subjectType = null;
+            fields.subjectUid = null;
+        }
+        else if (body.subjectType !== undefined || body.subjectUid !== undefined) {
+            Object.assign(fields, await this.requireSubject(context.workspaceUid, body.subjectType ?? existing.subjectType, body.subjectUid ?? existing.subjectUid));
+        }
+        if (fields.status && fields.status !== existing.status) {
+            fields.completedAt = fields.status === TaskStatus.DONE ? new Date() : null;
+        }
+        // A new due date, or a new assignee, gets its own reminder.
+        if (("dueAt" in fields && String(fields.dueAt) !== String(existing.dueAt)) || ("assigneeUserUid" in fields && fields.assigneeUserUid !== existing.assigneeUserUid)) {
+            fields.remindedAt = null;
+        }
+        return fields;
+    }
+    async readFields(body, context) {
+        const fields = {};
+        const title = readText(body, "title");
+        if (title !== undefined) {
+            fields.title = title;
+        }
+        const notes = readText(body, "notes", { max: MAX_LONG_TEXT });
+        if (notes !== undefined) {
+            fields.notes = notes;
+        }
+        const status = readEnum(body, "status", Object.values(TaskStatus));
+        if (status) {
+            fields.status = status;
+        }
+        const priority = readEnum(body, "priority", Object.values(TaskPriority));
+        if (priority) {
+            fields.priority = priority;
+        }
+        const dueAt = readDate(body, "dueAt");
+        if (dueAt !== undefined) {
+            fields.dueAt = dueAt;
+        }
+        if (body.assigneeUserUid !== undefined) {
+            fields.assigneeUserUid = await this.requireMemberUid(context.workspaceUid, readText(body, "assigneeUserUid", { max: 128 }), "assigneeUserUid");
+        }
+        return fields;
+    }
+    async afterWrite(record, before, _body, context) {
+        if (!record.subjectType || !record.subjectUid) {
+            return;
+        }
+        const completed = record.status === TaskStatus.DONE && before?.status !== TaskStatus.DONE;
+        if (!before || completed) {
+            await this.addTimeline({
+                workspaceUid: context.workspaceUid,
+                subjectType: record.subjectType,
+                subjectUid: record.subjectUid,
+                kind: completed ? TimelineKind.TASK_COMPLETED : TimelineKind.TASK_CREATED,
+                summary: `${completed ? "Completed" : "Created"} the task "${record.title}"`,
+                actorUserUid: context.user.uid.toLowerCase(),
+                refUid: record.uid,
+            });
+        }
+    }
+    listQuery(query) {
+        const conditions = {};
+        if (Object.values(TaskStatus).includes(query.status)) {
+            conditions.status = ModelUtils.literal(query.status);
+        }
+        for (const field of ["assigneeUserUid", "subjectUid"]) {
+            const value = query[field];
+            if (typeof value === "string" && value.length > 0 && value.length <= 128) {
+                conditions[field] = ModelUtils.literal(field === "assigneeUserUid" ? value.toLowerCase() : value);
+            }
+        }
+        return conditions;
+    }
+}
+//# sourceMappingURL=BaseTaskRoute.js.map

package/dist/lib/routes/BaseTaskRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTaskRoute.js","sourceRoot":"","sources":["../../../src/routes/BaseTaskRoute.ts"],"names":[],"mappings":"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"}