@rapidmx/crm-plugin 0.1.0

package/dist/lib/routes/sql/SubscriptionRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseSubscriptionRoute } from "../BaseSubscriptionRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** Contacts' subscriptions to mailing lists (`/api/mail/crm/subscriptions`). */
+let SubscriptionRouteSQL = class SubscriptionRouteSQL extends BaseSubscriptionRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+SubscriptionRouteSQL = __decorate([
+    ApiRoute("mail/crm/subscriptions")
+], SubscriptionRouteSQL);
+export { SubscriptionRouteSQL };
+//# sourceMappingURL=SubscriptionRouteSQL.js.map

package/dist/lib/routes/sql/SubscriptionRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/SubscriptionRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,gFAAgF;AAEzE,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,qBAAqB;IAAxD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,oBAAoB;IADhC,QAAQ,CAAC,wBAAwB,CAAC;GACtB,oBAAoB,CAEhC"}

package/dist/lib/routes/sql/SuppressionRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseSuppressionRoute } from "../BaseSuppressionRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** Addresses a workspace never sends marketing mail to (`/api/mail/crm/suppressions`). */
+let SuppressionRouteSQL = class SuppressionRouteSQL extends BaseSuppressionRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+SuppressionRouteSQL = __decorate([
+    ApiRoute("mail/crm/suppressions")
+], SuppressionRouteSQL);
+export { SuppressionRouteSQL };
+//# sourceMappingURL=SuppressionRouteSQL.js.map

package/dist/lib/routes/sql/SuppressionRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuppressionRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/SuppressionRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,0FAA0F;AAEnF,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,oBAAoB;IAAtD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,mBAAmB;IAD/B,QAAQ,CAAC,uBAAuB,CAAC;GACrB,mBAAmB,CAE/B"}

package/dist/lib/routes/sql/TaskRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseTaskRoute } from "../BaseTaskRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** A workspace's tasks (`/api/mail/crm/tasks`). */
+let TaskRouteSQL = class TaskRouteSQL extends BaseTaskRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+TaskRouteSQL = __decorate([
+    ApiRoute("mail/crm/tasks")
+], TaskRouteSQL);
+export { TaskRouteSQL };
+//# sourceMappingURL=TaskRouteSQL.js.map

package/dist/lib/routes/sql/TaskRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/TaskRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,mDAAmD;AAE5C,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,aAAa;IAAxC;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,YAAY;IADxB,QAAQ,CAAC,gBAAgB,CAAC;GACd,YAAY,CAExB"}

package/dist/lib/routes/sql/TemplateRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseTemplateRoute } from "../BaseTemplateRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** A workspace's email templates (`/api/mail/crm/templates`). */
+let TemplateRouteSQL = class TemplateRouteSQL extends BaseTemplateRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+TemplateRouteSQL = __decorate([
+    ApiRoute("mail/crm/templates")
+], TemplateRouteSQL);
+export { TemplateRouteSQL };
+//# sourceMappingURL=TemplateRouteSQL.js.map

package/dist/lib/routes/sql/TemplateRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/TemplateRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,iEAAiE;AAE1D,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iBAAiB;IAAhD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,gBAAgB;IAD5B,QAAQ,CAAC,oBAAoB,CAAC;GAClB,gBAAgB,CAE5B"}

package/dist/lib/routes/sql/TimelineRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseTimelineRoute } from "../BaseTimelineRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** Contact and company activity timelines (`/api/mail/crm/timeline`). */
+let TimelineRouteSQL = class TimelineRouteSQL extends BaseTimelineRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+TimelineRouteSQL = __decorate([
+    ApiRoute("mail/crm/timeline")
+], TimelineRouteSQL);
+export { TimelineRouteSQL };
+//# sourceMappingURL=TimelineRouteSQL.js.map

package/dist/lib/routes/sql/TimelineRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimelineRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/TimelineRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,yEAAyE;AAElE,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iBAAiB;IAAhD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,gBAAgB;IAD5B,QAAQ,CAAC,mBAAmB,CAAC;GACjB,gBAAgB,CAE5B"}

package/dist/lib/routes/sql/TrackingRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseTrackingRoute } from "../BaseTrackingRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** The anonymous open and click tracking endpoints of CRM email (`/api/mail/crm/t`). */
+let TrackingRouteSQL = class TrackingRouteSQL extends BaseTrackingRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+TrackingRouteSQL = __decorate([
+    ApiRoute("mail/crm/t")
+], TrackingRouteSQL);
+export { TrackingRouteSQL };
+//# sourceMappingURL=TrackingRouteSQL.js.map

package/dist/lib/routes/sql/TrackingRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackingRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/TrackingRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,wFAAwF;AAEjF,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iBAAiB;IAAhD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,gBAAgB;IAD5B,QAAQ,CAAC,YAAY,CAAC;GACV,gBAAgB,CAE5B"}

package/dist/lib/routes/sql/WebhookRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseWebhookRoute } from "../BaseWebhookRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** A workspace's webhook endpoints (`/api/mail/crm/webhooks`). */
+let WebhookRouteSQL = class WebhookRouteSQL extends BaseWebhookRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+WebhookRouteSQL = __decorate([
+    ApiRoute("mail/crm/webhooks")
+], WebhookRouteSQL);
+export { WebhookRouteSQL };
+//# sourceMappingURL=WebhookRouteSQL.js.map

package/dist/lib/routes/sql/WebhookRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/WebhookRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,kEAAkE;AAE3D,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,gBAAgB;IAA9C;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,eAAe;IAD3B,QAAQ,CAAC,mBAAmB,CAAC;GACjB,eAAe,CAE3B"}

package/dist/lib/routes/sql/WorkspaceRouteSQL.js

@@ -0,0 +1,26 @@
+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;
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { RouteDecorators } from "@rapidrest/service-core";
+import { SQL_MODELS } from "../../models/sql/index.js";
+import { BaseWorkspaceRoute } from "../BaseWorkspaceRoute.js";
+const { ApiRoute } = RouteDecorators;
+/** CRM workspaces, their members and senders (`/api/mail/crm/workspaces`). */
+let WorkspaceRouteSQL = class WorkspaceRouteSQL extends BaseWorkspaceRoute {
+    constructor() {
+        super(...arguments);
+        this.classes = SQL_MODELS;
+    }
+};
+WorkspaceRouteSQL = __decorate([
+    ApiRoute("mail/crm/workspaces")
+], WorkspaceRouteSQL);
+export { WorkspaceRouteSQL };
+//# sourceMappingURL=WorkspaceRouteSQL.js.map

package/dist/lib/routes/sql/WorkspaceRouteSQL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceRouteSQL.js","sourceRoot":"","sources":["../../../../src/routes/sql/WorkspaceRouteSQL.ts"],"names":[],"mappings":";;;;;;AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;AAErC,8EAA8E;AAEvE,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,kBAAkB;IAAlD;;QACO,YAAO,GAAoB,UAAU,CAAC;IACpD,CAAC;CAAA,CAAA;AAFY,iBAAiB;IAD7B,QAAQ,CAAC,qBAAqB,CAAC;GACnB,iBAAiB,CAE7B"}

package/dist/lib/scoring/Scoring.js

@@ -0,0 +1,105 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ModelUtils } from "@rapidrest/service-core";
+import { CrmObjectType, EngagementType, ScoringActivity, ScoringKind, TimelineKind, } from "../models/types.js";
+import { PAGING, matchingContacts } from "../segments/Segments.js";
+/** The most activity rows one rule reads per scoring, so a busy workspace's scoring stays bounded. */
+export const MAX_ACTIVITY_ROWS = 200000;
+/** Where each activity is counted from: an engagement event type, or a timeline entry kind. */
+const ACTIVITY_SOURCES = {
+    [ScoringActivity.OPENED]: { engagement: EngagementType.OPENED },
+    [ScoringActivity.CLICKED]: { engagement: EngagementType.CLICKED },
+    [ScoringActivity.REPLIED]: { engagement: EngagementType.REPLIED },
+    [ScoringActivity.BOUNCED]: { engagement: EngagementType.BOUNCED },
+    [ScoringActivity.FORM_SUBMITTED]: { timeline: TimelineKind.FORM_SUBMITTED },
+    [ScoringActivity.SUBSCRIBED]: { timeline: TimelineKind.SUBSCRIBED },
+    [ScoringActivity.UNSUBSCRIBED]: { timeline: TimelineKind.UNSUBSCRIBED },
+};
+/** How many times each contact did an activity rule's activity, within its window. Automatic opens and clicks don't count. */
+export async function countActivity(repos, workspaceUid, rule, now = new Date()) {
+    const counts = new Map();
+    const source = ACTIVITY_SOURCES[rule.activity];
+    const since = rule.withinDays ? { occurredAt: ModelUtils.literal(new Date(now.getTime() - rule.withinDays * 86400000), "gte") } : {};
+    const [repo, query, contactOf] = "engagement" in source
+        ? [
+            await repos.get("engagementEvent"),
+            { workspaceUid: ModelUtils.literal(workspaceUid), type: ModelUtils.literal(source.engagement), ...since },
+            (row) => (row.data?.machine ? undefined : row.contactUid),
+        ]
+        : [
+            await repos.get("timelineEvent"),
+            {
+                workspaceUid: ModelUtils.literal(workspaceUid),
+                subjectType: ModelUtils.literal(CrmObjectType.CONTACT),
+                kind: ModelUtils.literal(source.timeline),
+                ...since,
+            },
+            (row) => row.subjectUid,
+        ];
+    let after;
+    for (let read = 0; read < MAX_ACTIVITY_ROWS; read += PAGING.size) {
+        const rows = await repo.find({ ...query, ...(after ? { uid: ModelUtils.literal(after, "gt") } : {}), sort: { uid: "ASC" } }, { ignoreACL: true, limit: PAGING.size, skipCache: true });
+        for (const row of rows) {
+            const contactUid = contactOf(row);
+            if (contactUid) {
+                counts.set(contactUid, (counts.get(contactUid) ?? 0) + 1);
+            }
+        }
+        if (rows.length < PAGING.size) {
+            break;
+        }
+        after = rows[rows.length - 1].uid;
+    }
+    return counts;
+}
+/** The points one activity rule gives for `times` times: `points` each, limited to `maxPoints` either way. */
+export function activityPoints(rule, times) {
+    const total = rule.points * times;
+    if (rule.maxPoints === undefined || rule.maxPoints === null) {
+        return total;
+    }
+    return Math.max(-rule.maxPoints, Math.min(rule.maxPoints, total));
+}
+/**
+ * Scores every contact of `workspaceUid` by its enabled `rules` and saves the scores that changed: each property rule's points for
+ * the contacts its filter matches, plus each activity rule's points for what the contact did. With no enabled rules every score
+ * goes back to 0. Returns how many contacts' scores changed.
+ */
+export async function scoreWorkspace(repos, workspaceUid, rules, now = new Date()) {
+    const perRule = [];
+    for (const rule of rules.filter((entry) => entry.enabled)) {
+        if (rule.kind === ScoringKind.PROPERTY) {
+            const matching = new Set((await matchingContacts(repos, workspaceUid, rule.filter)).uids);
+            perRule.push({ rule, points: (contactUid) => (matching.has(contactUid) ? rule.points : 0) });
+        }
+        else {
+            const counts = await countActivity(repos, workspaceUid, rule, now);
+            perRule.push({ rule, points: (contactUid) => activityPoints(rule, counts.get(contactUid) ?? 0) });
+        }
+    }
+    const contacts = await repos.get("contact");
+    let changed = 0;
+    let after;
+    for (;;) {
+        const page = await contacts.find({ workspaceUid: ModelUtils.literal(workspaceUid), ...(after ? { uid: ModelUtils.literal(after, "gt") } : {}), sort: { uid: "ASC" } }, { ignoreACL: true, limit: PAGING.size, skipCache: true });
+        for (const contact of page) {
+            const score = perRule.reduce((sum, entry) => sum + entry.points(contact.uid), 0);
+            if (score !== contact.score) {
+                try {
+                    await contacts.update({ uid: contact.uid, version: contact.version, score }, contact, { ignoreACL: true, skipPush: true });
+                    changed++;
+                }
+                catch {
+                    // Changed meanwhile: the next scoring catches it up.
+                }
+            }
+        }
+        if (page.length < PAGING.size) {
+            return changed;
+        }
+        after = page[page.length - 1].uid;
+    }
+}
+//# sourceMappingURL=Scoring.js.map

package/dist/lib/scoring/Scoring.js.map

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

package/dist/lib/segments/Segments.js

@@ -0,0 +1,125 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import { ModelUtils } from "@rapidrest/service-core";
+import { compileFilter, filterFields, validateFilter } from "../filters/Filter.js";
+import { CONTACT_FIELDS } from "../filters/fields.js";
+import { CrmObjectType } from "../models/types.js";
+import { CrmEventType, recordCrmEvent } from "../automation/Events.js";
+/** The `PropertyValue` key of segment membership: one row per member, `stringValue` = the segment's uid. */
+export const SEGMENTS_KEY = "segments";
+/** The most contacts one segment holds; a filter matching more keeps the first (by uid) and is marked `capped`. */
+export const MAX_SEGMENT_SIZE = 100000;
+/** How many rows one query of segments and scoring reads or changes (a setting only tests change). */
+export const PAGING = { size: 1000 };
+/** The fields a contact filter may name in `workspaceUid`: with `segments`, unless the filter defines a segment. */
+export async function contactFilterFields(repos, workspaceUid, withSegments) {
+    const definitions = await (await repos.get("propertyDefinition")).find({ workspaceUid: ModelUtils.literal(workspaceUid), objectType: ModelUtils.literal(CrmObjectType.CONTACT) }, { ignoreACL: true, limit: 1000, skipCache: true });
+    const fields = filterFields(CONTACT_FIELDS, definitions, CrmObjectType.CONTACT);
+    if (!withSegments) {
+        delete fields.segments;
+    }
+    return fields;
+}
+/** `raw` as a segment's filter: a valid contact filter that doesn't name segments (a segment made of segments could loop). */
+export async function readSegmentFilter(repos, workspaceUid, raw) {
+    return validateFilter(raw, await contactFilterFields(repos, workspaceUid, false));
+}
+/**
+ * The uids of the contacts of `workspaceUid` that `filter` (already validated) matches, in uid order - at most `cap`; `capped` when
+ * there were more.
+ */
+export async function matchingContacts(repos, workspaceUid, filter, cap = MAX_SEGMENT_SIZE) {
+    const contacts = await repos.get("contact");
+    const condition = await compileFilter(filter, await contactFilterFields(repos, workspaceUid, true), {
+        workspaceUid,
+        objectType: CrmObjectType.CONTACT,
+        valueRepo: await repos.get("propertyValue"),
+        recordRepo: contacts,
+    });
+    const uids = [];
+    let after;
+    while (uids.length <= cap) {
+        const page = await contacts.find({
+            workspaceUid: ModelUtils.literal(workspaceUid),
+            ...(after ? { uid: ModelUtils.literal(after, "gt") } : {}),
+            $and: [condition],
+            sort: { uid: "ASC" },
+        }, { ignoreACL: true, limit: PAGING.size, skipCache: true });
+        uids.push(...page.map((contact) => contact.uid));
+        if (page.length < PAGING.size) {
+            break;
+        }
+        after = page[page.length - 1].uid;
+    }
+    return uids.length > cap ? { uids: uids.slice(0, cap), capped: true } : { uids, capped: false };
+}
+/** The uids of the current members of `segmentUid`. */
+export async function segmentMembers(repos, segmentUid) {
+    const values = await repos.get("propertyValue");
+    const members = new Set();
+    let after;
+    for (;;) {
+        const page = await values.find({
+            key: ModelUtils.literal(SEGMENTS_KEY),
+            stringValue: ModelUtils.literal(segmentUid),
+            ...(after ? { uid: ModelUtils.literal(after, "gt") } : {}),
+            sort: { uid: "ASC" },
+        }, { ignoreACL: true, limit: PAGING.size, skipCache: true });
+        page.forEach((row) => members.add(row.objectUid));
+        if (page.length < PAGING.size) {
+            return members;
+        }
+        after = page[page.length - 1].uid;
+    }
+}
+/** Makes `uids` the members of `segment`: adds the new ones, removes the rest. Returns who entered and who left. */
+export async function syncMembers(repos, classes, segment, uids) {
+    const values = await repos.get("propertyValue");
+    const current = await segmentMembers(repos, segment.uid);
+    const wanted = new Set(uids);
+    const entered = uids.filter((uid) => !current.has(uid));
+    const left = [...current].filter((uid) => !wanted.has(uid));
+    for (let start = 0; start < left.length; start += PAGING.size) {
+        await values.truncate({
+            key: ModelUtils.literal(SEGMENTS_KEY),
+            stringValue: ModelUtils.literal(segment.uid),
+            objectUid: ModelUtils.literal(left.slice(start, start + PAGING.size), "in"),
+        }, { ignoreACL: true });
+    }
+    for (const contactUid of entered) {
+        await values.create(new classes.propertyValue({ workspaceUid: segment.workspaceUid, objectType: CrmObjectType.CONTACT, objectUid: contactUid, key: SEGMENTS_KEY, stringValue: segment.uid }), { ignoreACL: true, skipPush: true });
+    }
+    return { entered, left };
+}
+/** Works a segment's members out from its filter and saves them. */
+export async function refreshSegment(repos, classes, segment) {
+    const { uids, capped } = await matchingContacts(repos, segment.workspaceUid, segment.filter);
+    const { entered, left } = await syncMembers(repos, classes, segment, uids);
+    return { counts: { memberCount: uids.length, capped, refreshedAt: new Date() }, entered, left };
+}
+/** Records `segment.entered` and `segment.left` events for who entered and left `segment`. */
+export async function recordSegmentEvents(repos, classes, segment, entered, left, logger) {
+    for (const [type, contactUids] of [
+        [CrmEventType.SEGMENT_ENTERED, entered],
+        [CrmEventType.SEGMENT_LEFT, left],
+    ]) {
+        for (const contactUid of contactUids) {
+            await recordCrmEvent(repos, classes, { workspaceUid: segment.workspaceUid, type, contactUid, data: { segmentUid: segment.uid } }, logger);
+        }
+    }
+}
+/** Which of `contactUids` are in at least one of `segmentUids`. */
+export async function inSegments(repos, segmentUids, contactUids) {
+    if (segmentUids.length === 0 || contactUids.length === 0) {
+        return new Set();
+    }
+    const rows = await (await repos.get("propertyValue")).find({
+        key: ModelUtils.literal(SEGMENTS_KEY),
+        stringValue: ModelUtils.literal(segmentUids, "in"),
+        objectUid: ModelUtils.literal(contactUids, "in"),
+    }, { ignoreACL: true, limit: segmentUids.length * contactUids.length, skipCache: true });
+    return new Set(rows.map((row) => row.objectUid));
+}
+//# sourceMappingURL=Segments.js.map

package/dist/lib/segments/Segments.js.map

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

package/dist/lib/sending/Audience.js

@@ -0,0 +1,87 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz. All rights reserved.
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import * as crypto from "crypto";
+import { ModelUtils } from "@rapidrest/service-core";
+import { EmailStatus, SubscriptionStatus } from "../models/types.js";
+import { inSegments } from "../segments/Segments.js";
+/**
+ * One page of an audience, read through the lists' subscriptions in uid order after `cursor` (`pageSize` subscriptions a page, so
+ * the work of a page is bounded). A contact on several lists shows up once per list - callers de-duplicate (a campaign by its
+ * sends' unique `dedupeKey`).
+ */
+export async function audiencePage(repos, spec, cursor, pageSize) {
+    if (spec.listUids.length === 0) {
+        return { contacts: [] };
+    }
+    const subscriptions = await (await repos.get("subscription")).find({
+        workspaceUid: ModelUtils.literal(spec.workspaceUid),
+        listUid: ModelUtils.literal(spec.listUids, "in"),
+        status: ModelUtils.literal(SubscriptionStatus.SUBSCRIBED),
+        ...(cursor ? { uid: ModelUtils.literal(cursor, "gt") } : {}),
+        sort: { uid: "ASC" },
+    }, { ignoreACL: true, limit: pageSize, skipCache: true });
+    const nextCursor = subscriptions.length < pageSize ? undefined : subscriptions[subscriptions.length - 1].uid;
+    const contactUids = [...new Set(subscriptions.map((subscription) => subscription.contactUid))];
+    if (contactUids.length === 0) {
+        return { contacts: [], nextCursor };
+    }
+    const excluded = new Set();
+    if (spec.excludeListUids.length > 0) {
+        const exclusions = await (await repos.get("subscription")).find({
+            workspaceUid: ModelUtils.literal(spec.workspaceUid),
+            listUid: ModelUtils.literal(spec.excludeListUids, "in"),
+            contactUid: ModelUtils.literal(contactUids, "in"),
+            status: ModelUtils.literal(SubscriptionStatus.SUBSCRIBED),
+        }, { ignoreACL: true, limit: contactUids.length * spec.excludeListUids.length, skipCache: true });
+        exclusions.forEach((subscription) => excluded.add(subscription.contactUid));
+    }
+    const contacts = (await (await repos.get("contact")).find({ workspaceUid: ModelUtils.literal(spec.workspaceUid), uid: ModelUtils.literal(contactUids, "in") }, { ignoreACL: true, limit: contactUids.length, skipCache: true })).filter((contact) => contact.emailStatus === EmailStatus.ACTIVE && !excluded.has(contact.uid));
+    const uids = contacts.map((contact) => contact.uid);
+    const wanted = spec.segmentUids?.length ? await inSegments(repos, spec.segmentUids, uids) : undefined;
+    const unwanted = await inSegments(repos, spec.excludeSegmentUids ?? [], uids);
+    const suppressed = await suppressedAmong(repos, spec.workspaceUid, contacts.map((contact) => contact.email));
+    return {
+        contacts: contacts.filter((contact) => !suppressed.has(contact.email) && (!wanted || wanted.has(contact.uid)) && !unwanted.has(contact.uid)),
+        nextCursor,
+    };
+}
+/** Which of `emails` the workspace has suppressed. */
+export async function suppressedAmong(repos, workspaceUid, emails) {
+    if (emails.length === 0) {
+        return new Set();
+    }
+    const rows = await (await repos.get("suppression")).find({ workspaceUid: ModelUtils.literal(workspaceUid), email: ModelUtils.literal(emails, "in") }, { ignoreACL: true, limit: emails.length, skipCache: true });
+    return new Set(rows.map((row) => row.email));
+}
+/** How many distinct contacts an audience would reach, counting at most `cap` (then `capped`). */
+export async function countAudience(repos, spec, cap = 100000) {
+    const seen = new Set();
+    let cursor;
+    do {
+        const page = await audiencePage(repos, spec, cursor, 1000);
+        page.contacts.forEach((contact) => seen.add(contact.uid));
+        if (seen.size >= cap) {
+            return { count: cap, capped: true };
+        }
+        cursor = page.nextCursor;
+    } while (cursor);
+    return { count: seen.size, capped: false };
+}
+/**
+ * The A/B variant a contact gets: `A` without a test; with one, `testPercent` of contacts (chosen by a hash of the campaign and
+ * contact, so the choice is stable however the audience is read) are spread evenly over the variants, and the rest get `""` - held
+ * for the winner.
+ */
+export function assignVariant(campaignUid, contactUid, abTest) {
+    if (!abTest) {
+        return "A";
+    }
+    const hash = crypto.createHash("sha256").update(`${campaignUid}|${contactUid}`).digest();
+    if (hash.readUInt32BE(0) / 4294967296 >= abTest.testPercent / 100) {
+        return "";
+    }
+    return abTest.variants[hash.readUInt32BE(4) % abTest.variants.length].id;
+}
+//# sourceMappingURL=Audience.js.map