@mj-biz-apps/common-activity-sync 0.0.0 → 5.37.0

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @mj-biz-apps/common-activity-sync
+ *
+ * Contracts for the Activity Sync Engine: the provider plugin base class, the qualification
+ * cascade, and the in-process extension contract downstream apps implement to enrich an Activity
+ * inside its own write transaction.
+ *
+ * Design: plans/activity-sync-engine.md
+ */
+export * from './types.js';
+export * from './watermark.js';
+export * from './qualification.js';
+export * from './participants.js';
+export * from './run.js';
+export * from './BaseActivitySyncProvider.js';
+export * from './BaseActivitySyncExtension.js';
+export * from './entity-names.js';
+export * from './identity.js';
+export * from './writer.js';
+export * from './manual-log.js';
+export * from './stages.js';
+export * from './ActivitySyncEngine.js';
+export * from './action-result.js';
+export * from './extensions.js';
+export * from './providers/FixtureActivitySyncProvider.js';
+export * from './providers/MSGraphActivitySyncProvider.js';
+export * from './providers/MSGraphCalendarSyncProvider.js';
+export * from './providers/GraphMessageMapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * @mj-biz-apps/common-activity-sync
+ *
+ * Contracts for the Activity Sync Engine: the provider plugin base class, the qualification
+ * cascade, and the in-process extension contract downstream apps implement to enrich an Activity
+ * inside its own write transaction.
+ *
+ * Design: plans/activity-sync-engine.md
+ */
+export * from './types.js';
+export * from './watermark.js';
+export * from './qualification.js';
+export * from './participants.js';
+export * from './run.js';
+export * from './BaseActivitySyncProvider.js';
+export * from './BaseActivitySyncExtension.js';
+export * from './entity-names.js';
+export * from './identity.js';
+export * from './writer.js';
+export * from './manual-log.js';
+export * from './stages.js';
+export * from './ActivitySyncEngine.js';
+export * from './action-result.js';
+export * from './extensions.js';
+export * from './providers/FixtureActivitySyncProvider.js';
+export * from './providers/MSGraphActivitySyncProvider.js';
+export * from './providers/MSGraphCalendarSyncProvider.js';
+export * from './providers/GraphMessageMapper.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,17 @@
+export type ViewLoad<T> = {
+    Failed: true;
+    Issue: string;
+} | {
+    Failed: false;
+    Rows: T[];
+};
+export declare function FromRunView<T>(success: boolean, results: readonly T[] | null | undefined, what: string): ViewLoad<T>;
+/** Global exclusions plus those bound to the connection's rule sets. */
+export declare function ExclusionsExtraFilter(setIds: readonly string[]): string;
+/**
+ * Bound rule-set ids on success. Empty ids fall through to the deprecated
+ * connection-owned rules. A failed binding read must not take that fallthrough —
+ * that would load the wrong rules.
+ */
+export declare function RulesExtraFilter(setIds: readonly string[], connectionID: string): string;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC;AAEzF,wBAAgB,WAAW,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EACxC,IAAI,EAAE,MAAM,GACb,QAAQ,CAAC,CAAC,CAAC,CAGb;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKxF"}

package/dist/load.js

@@ -0,0 +1,29 @@
+/**
+ * RunView results. A failed read is not an empty list — those two look the same
+ * and only one may advance a watermark or decide an exclusion.
+ */
+import { RequireUUID, UuidInList } from './sql.js';
+export function FromRunView(success, results, what) {
+    if (!success)
+        return { Failed: true, Issue: `${what} lookup failed.` };
+    return { Failed: false, Rows: [...(results ?? [])] };
+}
+/** Global exclusions plus those bound to the connection's rule sets. */
+export function ExclusionsExtraFilter(setIds) {
+    const global = 'ActivitySyncRuleSetID IS NULL';
+    if (setIds.length === 0)
+        return global;
+    return `(${global} OR ActivitySyncRuleSetID IN (${UuidInList(setIds, 'ActivitySyncRuleSetID')}))`;
+}
+/**
+ * Bound rule-set ids on success. Empty ids fall through to the deprecated
+ * connection-owned rules. A failed binding read must not take that fallthrough —
+ * that would load the wrong rules.
+ */
+export function RulesExtraFilter(setIds, connectionID) {
+    if (setIds.length > 0) {
+        return `ActivitySyncRuleSetID IN (${UuidInList(setIds, 'ActivitySyncRuleSetID')})`;
+    }
+    return `ActivitySyncConnectionID = '${RequireUUID(connectionID, 'ActivitySyncConnectionID')}'`;
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAInD,MAAM,UAAU,WAAW,CACvB,OAAgB,EAChB,OAAwC,EACxC,IAAY;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,MAAyB;IAC3D,MAAM,MAAM,GAAG,+BAA+B,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,IAAI,MAAM,iCAAiC,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,IAAI,CAAC;AACtG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,YAAoB;IAC5E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,6BAA6B,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC;IACvF,CAAC;IACD,OAAO,+BAA+B,WAAW,CAAC,YAAY,EAAE,0BAA0B,CAAC,GAAG,CAAC;AACnG,CAAC"}

package/dist/manual-log.d.ts

@@ -0,0 +1,33 @@
+import type { ActivityLinkRole } from './types.js';
+import type { WriteManualActivityInput } from './writer.js';
+/** The SourceSystem stamped on idempotent declarative writes when a binding sets EventKey alone. */
+export declare const LOG_ACTIVITY_DEFAULT_SOURCE_SYSTEM = "EntityAction";
+/**
+ * Declarative "link the activity to whatever this record points at": read `Field` from
+ * `RecordData` and, when it holds a value, link that record with `Role`. This is what makes
+ * timeline population configuration — a binding on any entity can route the activity to the
+ * People / Organizations rows the record references, with no code in the consuming app.
+ */
+export interface LogActivityLinkFieldSpec {
+    Field: string;
+    EntityName: string;
+    Role: ActivityLinkRole;
+}
+export interface LogActivityParseResult {
+    Input: WriteManualActivityInput | null;
+    Errors: string[];
+}
+/**
+ * Parse the flat parameter set of `Common.LogActivity` into a `WriteManualActivityInput`.
+ *
+ * Conveniences for declarative bindings:
+ * - `EntityName` + `RecordID` (or `RecordData.ID`) become a leading `Regarding` link — the record
+ *   the activity is about.
+ * - `LinkFields` routes the activity to records the subject points at (see the type's doc).
+ * - `EventKey` makes a binding idempotent per record: with `EntityName` and a record id present,
+ *   `ExternalID` becomes `EntityName|RecordID|EventKey` and `SourceSystem` defaults to
+ *   'EntityAction', so a durable retry cannot double-log. Use it for one-per-record events
+ *   (AfterCreate); leave it off when every firing should log (a status that changes repeatedly).
+ */
+export declare function ParseLogActivityParams(values: Record<string, unknown>): LogActivityParseResult;
+//# sourceMappingURL=manual-log.d.ts.map

package/dist/manual-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-log.d.ts","sourceRoot":"","sources":["../src/manual-log.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAA2C,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,KAAK,EAKR,wBAAwB,EAC3B,MAAM,aAAa,CAAC;AAErB,oGAAoG;AACpG,eAAO,MAAM,kCAAkC,iBAAiB,CAAC;AAOjE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAiJD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB,CAgE9F"}

package/dist/manual-log.js

@@ -0,0 +1,230 @@
+/**
+ * Parameter parsing for `Common.LogActivity` — the declarative entry point to the unified timeline.
+ *
+ * Everything here takes PLAIN, SERIALIZABLE values, because the action's inputs may cross a queue,
+ * a durable task or an agent boundary before they arrive. That is why an Entity Action binding must
+ * feed `RecordData` with ValueType `'Entity Object Data'` and never `'Entity Object'`: a
+ * `BaseEntity` serializes to `{}` (its fields are getters, not enumerable own properties) —
+ * silently, with no error (plans/mj-entity-action-workflow-adoption.md §3.3).
+ *
+ * Pure functions, no I/O — the `Common.LogActivity` action in `@mj-biz-apps/common-server` is a
+ * thin shell over `ParseLogActivityParams` + `ActivityWriter.WriteManual`.
+ */
+import { ACTIVITY_IDENTITY_KINDS, ACTIVITY_LINK_ROLES } from './types.js';
+/** The SourceSystem stamped on idempotent declarative writes when a binding sets EventKey alone. */
+export const LOG_ACTIVITY_DEFAULT_SOURCE_SYSTEM = 'EntityAction';
+const DIRECTIONS = ['Inbound', 'Outbound', 'Internal'];
+const STATUSES = ['Logged', 'Scheduled', 'Completed', 'Cancelled', 'Failed'];
+const VISIBILITIES = ['Internal', 'Private'];
+const SOURCES = ['Manual', 'System'];
+class ParamReader {
+    constructor(values) {
+        this.byName = new Map();
+        this.errors = [];
+        for (const [name, value] of Object.entries(values)) {
+            this.byName.set(name.toLowerCase(), value);
+        }
+    }
+    raw(name) {
+        const value = this.byName.get(name.toLowerCase());
+        return value === null || value === undefined || value === '' ? undefined : value;
+    }
+    string(name) {
+        const value = this.raw(name);
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== 'string') {
+            this.errors.push(`${name} must be a string.`);
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    date(name) {
+        const value = this.raw(name);
+        if (value === undefined)
+            return undefined;
+        const parsed = value instanceof Date ? value : typeof value === 'string' ? new Date(value) : undefined;
+        if (!parsed || Number.isNaN(parsed.getTime())) {
+            this.errors.push(`${name} must be a date or an ISO date string.`);
+            return undefined;
+        }
+        return parsed;
+    }
+    oneOf(name, allowed) {
+        const value = this.string(name);
+        if (value === undefined)
+            return undefined;
+        const match = allowed.find((candidate) => candidate.toLowerCase() === value.toLowerCase());
+        if (!match) {
+            this.errors.push(`${name} must be one of: ${allowed.join(', ')}.`);
+            return undefined;
+        }
+        return match;
+    }
+    /** An object param that may arrive as a real object or as a JSON string. */
+    object(name) {
+        const value = this.raw(name);
+        if (value === undefined)
+            return undefined;
+        if (typeof value === 'object')
+            return value;
+        if (typeof value === 'string') {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                this.errors.push(`${name} must be an object or valid JSON.`);
+                return undefined;
+            }
+        }
+        this.errors.push(`${name} must be an object or valid JSON.`);
+        return undefined;
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function parseLinkSpecs(reader) {
+    const value = reader.object('Links');
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        reader.errors.push('Links must be an array of link specs.');
+        return [];
+    }
+    const links = [];
+    for (const [index, item] of value.entries()) {
+        const link = parseOneLinkSpec(item, index, reader.errors);
+        if (link)
+            links.push(link);
+    }
+    return links;
+}
+function parseOneLinkSpec(item, index, errors) {
+    if (!isRecord(item)) {
+        errors.push(`Links[${index}] must be an object.`);
+        return null;
+    }
+    const role = item.Role;
+    if (typeof role !== 'string' || !ACTIVITY_LINK_ROLES.includes(role)) {
+        errors.push(`Links[${index}].Role must be one of: ${ACTIVITY_LINK_ROLES.join(', ')}.`);
+        return null;
+    }
+    const kind = item.IdentityKind;
+    if (kind !== undefined && (typeof kind !== 'string' || !ACTIVITY_IDENTITY_KINDS.includes(kind))) {
+        errors.push(`Links[${index}].IdentityKind must be one of: ${ACTIVITY_IDENTITY_KINDS.join(', ')}.`);
+        return null;
+    }
+    return {
+        Role: role,
+        EntityName: typeof item.EntityName === 'string' ? item.EntityName : undefined,
+        RecordID: typeof item.RecordID === 'string' ? item.RecordID : undefined,
+        IdentityKind: kind,
+        IdentityValue: typeof item.IdentityValue === 'string' ? item.IdentityValue : undefined,
+    };
+}
+function parseLinkFields(reader, recordData) {
+    const value = reader.object('LinkFields');
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        reader.errors.push('LinkFields must be an array of { Field, EntityName, Role } specs.');
+        return [];
+    }
+    if (!recordData) {
+        reader.errors.push('LinkFields requires RecordData to read the fields from.');
+        return [];
+    }
+    const links = [];
+    for (const [index, item] of value.entries()) {
+        if (!isRecord(item) || typeof item.Field !== 'string' || typeof item.EntityName !== 'string') {
+            reader.errors.push(`LinkFields[${index}] must carry Field, EntityName and Role.`);
+            continue;
+        }
+        const role = item.Role;
+        if (typeof role !== 'string' || !ACTIVITY_LINK_ROLES.includes(role)) {
+            reader.errors.push(`LinkFields[${index}].Role must be one of: ${ACTIVITY_LINK_ROLES.join(', ')}.`);
+            continue;
+        }
+        const target = recordData[item.Field];
+        if (typeof target === 'string' && target.trim().length > 0) {
+            links.push({ Role: role, EntityName: item.EntityName, RecordID: target });
+        }
+        // A null / absent FK is not an error — the record simply does not point at anything.
+    }
+    return links;
+}
+/**
+ * Parse the flat parameter set of `Common.LogActivity` into a `WriteManualActivityInput`.
+ *
+ * Conveniences for declarative bindings:
+ * - `EntityName` + `RecordID` (or `RecordData.ID`) become a leading `Regarding` link — the record
+ *   the activity is about.
+ * - `LinkFields` routes the activity to records the subject points at (see the type's doc).
+ * - `EventKey` makes a binding idempotent per record: with `EntityName` and a record id present,
+ *   `ExternalID` becomes `EntityName|RecordID|EventKey` and `SourceSystem` defaults to
+ *   'EntityAction', so a durable retry cannot double-log. Use it for one-per-record events
+ *   (AfterCreate); leave it off when every firing should log (a status that changes repeatedly).
+ */
+export function ParseLogActivityParams(values) {
+    const reader = new ParamReader(values);
+    const typeCode = reader.string('TypeCode');
+    const title = reader.string('Title');
+    const startedAt = reader.date('StartedAt') ?? new Date();
+    const endedAt = reader.date('EndedAt');
+    const detailsValue = reader.object('Details');
+    if (detailsValue !== undefined && !isRecord(detailsValue)) {
+        reader.errors.push('Details must be a JSON object.');
+    }
+    const recordDataValue = reader.object('RecordData');
+    if (recordDataValue !== undefined && !isRecord(recordDataValue)) {
+        reader.errors.push('RecordData must be a JSON object (Entity Object Data).');
+    }
+    const recordData = isRecord(recordDataValue) ? recordDataValue : undefined;
+    const entityName = reader.string('EntityName');
+    const recordID = reader.string('RecordID') ?? (typeof recordData?.ID === 'string' ? recordData.ID : undefined);
+    const links = [];
+    if (entityName && recordID) {
+        links.push({ Role: 'Regarding', EntityName: entityName, RecordID: recordID });
+    }
+    else if ((entityName && !recordID) || (!entityName && recordID)) {
+        reader.errors.push('EntityName and RecordID (or RecordData.ID) must be provided together.');
+    }
+    links.push(...parseLinkFields(reader, recordData));
+    links.push(...parseLinkSpecs(reader));
+    let sourceSystem = reader.string('SourceSystem');
+    let externalID = reader.string('ExternalID');
+    const eventKey = reader.string('EventKey');
+    if (eventKey && !externalID) {
+        if (entityName && recordID) {
+            sourceSystem = sourceSystem ?? LOG_ACTIVITY_DEFAULT_SOURCE_SYSTEM;
+            externalID = `${entityName}|${recordID}|${eventKey}`;
+        }
+        else {
+            reader.errors.push('EventKey requires EntityName and a record id to derive an idempotency key.');
+        }
+    }
+    const input = {
+        TypeCode: typeCode ?? '',
+        Title: title ?? '',
+        StartedAt: startedAt,
+        EndedAt: endedAt ?? null,
+        Description: reader.string('Description') ?? null,
+        Direction: reader.oneOf('Direction', DIRECTIONS),
+        Status: reader.oneOf('Status', STATUSES),
+        Visibility: reader.oneOf('Visibility', VISIBILITIES),
+        Source: reader.oneOf('Source', SOURCES),
+        Location: reader.string('Location') ?? null,
+        Details: isRecord(detailsValue) ? detailsValue : null,
+        SourceSystem: sourceSystem ?? null,
+        ExternalID: externalID ?? null,
+        Links: links,
+    };
+    if (!typeCode)
+        reader.errors.push('TypeCode is required.');
+    if (!title)
+        reader.errors.push('Title is required.');
+    return reader.errors.length > 0 ? { Input: null, Errors: reader.errors } : { Input: input, Errors: [] };
+}
+//# sourceMappingURL=manual-log.js.map

package/dist/manual-log.js.map

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

package/dist/participants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Internal vs external participants — the Outlook-rules control.
+ *
+ * "Internal" is not a property of a message. It is a property of the DEPLOYMENT, which is why the
+ * domain list lives on `ActivitySyncRuleSet.InternalDomains` and is passed in here rather than
+ * inferred. A rule that says "exclude internal-only chatter" is meaningless until someone has said
+ * which domains are ours.
+ *
+ * @module @mj-biz-apps/common-activity-sync
+ */
+import type { ItemParticipant } from './types.js';
+/**
+ * Which participants must be present for a rule to apply.
+ *
+ * Mirrors `CK_ActivitySyncRule_ParticipantScope`. `Mixed` exists because it is the case an
+ * all-or-nothing rule gets wrong: a thread with three colleagues and one customer on it is neither
+ * internal chatter nor an external conversation, and which of those it counts as is a decision a
+ * deployment should make explicitly.
+ */
+export type ParticipantScope = 'Any' | 'AllInternal' | 'AllExternal' | 'HasExternal' | 'HasInternal' | 'Mixed';
+/** How a message's participants break down against the deployment's own domains. */
+export interface ParticipantComposition {
+    Internal: number;
+    External: number;
+    /** Addresses with no parseable domain. Never counted as internal — see below. */
+    Unknown: number;
+}
+/**
+ * Split participants into internal and external by domain.
+ *
+ * **An unclassifiable address is never treated as internal.** A malformed or domain-less address is
+ * counted separately and, for every predicate below, sides with `External`. The alternative —
+ * assuming an unparseable party is one of us — would let a single bad address turn a mixed thread
+ * into "internal only", and an internal-only *exclusion* rule would then silently drop a real
+ * customer conversation. Erring the other way costs an extra captured message, which is recoverable;
+ * a silent drop is not.
+ */
+export declare function ClassifyParticipants(participants: readonly ItemParticipant[], internalDomains: readonly string[]): ParticipantComposition;
+/** The domain part of an address, lower-cased, or null when there isn't one. */
+export declare function DomainOf(address: string): string | null;
+/**
+ * Whether a composition satisfies a rule's required scope.
+ *
+ * `Unknown` sides with external throughout, per the reasoning on {@link ClassifyParticipants}.
+ */
+export declare function MatchesParticipantScope(scope: ParticipantScope, c: ParticipantComposition): boolean;
+//# sourceMappingURL=participants.d.ts.map

package/dist/participants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participants.d.ts","sourceRoot":"","sources":["../src/participants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACtB,KAAK,GACL,aAAa,GACb,aAAa,GACb,aAAa,GACb,aAAa,GACb,OAAO,CAAC;AAEd,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,SAAS,eAAe,EAAE,EACxC,eAAe,EAAE,SAAS,MAAM,EAAE,GACnC,sBAAsB,CAexB;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAgBnG"}

package/dist/participants.js

@@ -0,0 +1,59 @@
+/**
+ * Split participants into internal and external by domain.
+ *
+ * **An unclassifiable address is never treated as internal.** A malformed or domain-less address is
+ * counted separately and, for every predicate below, sides with `External`. The alternative —
+ * assuming an unparseable party is one of us — would let a single bad address turn a mixed thread
+ * into "internal only", and an internal-only *exclusion* rule would then silently drop a real
+ * customer conversation. Erring the other way costs an extra captured message, which is recoverable;
+ * a silent drop is not.
+ */
+export function ClassifyParticipants(participants, internalDomains) {
+    const domains = new Set(internalDomains.map((d) => d.trim().toLowerCase().replace(/^@/, '')));
+    const composition = { Internal: 0, External: 0, Unknown: 0 };
+    for (const participant of participants) {
+        const domain = DomainOf(participant.Address);
+        if (domain === null) {
+            composition.Unknown++;
+        }
+        else if (domains.has(domain)) {
+            composition.Internal++;
+        }
+        else {
+            composition.External++;
+        }
+    }
+    return composition;
+}
+/** The domain part of an address, lower-cased, or null when there isn't one. */
+export function DomainOf(address) {
+    const at = address.lastIndexOf('@');
+    if (at < 0 || at === address.length - 1) {
+        return null;
+    }
+    const domain = address.slice(at + 1).trim().toLowerCase();
+    return domain.length > 0 ? domain : null;
+}
+/**
+ * Whether a composition satisfies a rule's required scope.
+ *
+ * `Unknown` sides with external throughout, per the reasoning on {@link ClassifyParticipants}.
+ */
+export function MatchesParticipantScope(scope, c) {
+    const external = c.External + c.Unknown;
+    switch (scope) {
+        case 'Any':
+            return true;
+        case 'AllInternal':
+            return c.Internal > 0 && external === 0;
+        case 'AllExternal':
+            return external > 0 && c.Internal === 0;
+        case 'HasExternal':
+            return external > 0;
+        case 'HasInternal':
+            return c.Internal > 0;
+        case 'Mixed':
+            return c.Internal > 0 && external > 0;
+    }
+}
+//# sourceMappingURL=participants.js.map

package/dist/participants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"participants.js","sourceRoot":"","sources":["../src/participants.ts"],"names":[],"mappings":"AAoCA;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAChC,YAAwC,EACxC,eAAkC;IAElC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAA2B,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAErF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,WAAW,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACJ,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,OAAe;IACpC,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAuB,EAAE,CAAyB;IACtF,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC;IACxC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,KAAK;YACN,OAAO,IAAI,CAAC;QAChB,KAAK,aAAa;YACd,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAC5C,KAAK,aAAa;YACd,OAAO,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC5C,KAAK,aAAa;YACd,OAAO,QAAQ,GAAG,CAAC,CAAC;QACxB,KAAK,aAAa;YACd,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC1B,KAAK,OAAO;YACR,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC"}

package/dist/providers/FixtureActivitySyncProvider.d.ts

@@ -0,0 +1,21 @@
+import { BaseActivitySyncProvider } from '../BaseActivitySyncProvider.js';
+import type { ActivitySourceKind, ActivitySourceQuery, NormalizedItem, RawBatch } from '../types.js';
+export declare class FixtureActivitySyncProvider extends BaseActivitySyncProvider {
+    private readonly items;
+    private readonly issues;
+    readonly Kind: ActivitySourceKind;
+    readonly ProviderTypeCode = "Generic";
+    readonly IsLive = false;
+    readonly Calls: ActivitySourceQuery[];
+    fetchedAt: Date;
+    constructor(items?: NormalizedItem[], kind?: ActivitySourceKind, issues?: string[]);
+    /**
+     * The instant a CALENDAR fixture reports as its watermark. Injectable so a
+     * check can assert an exact value instead of racing the clock. Messages
+     * still use max(StartedAt) via Kind.
+     */
+    protected Now(): Date;
+    protected FetchRaw(query: ActivitySourceQuery): Promise<RawBatch>;
+    protected Normalize(raw: RawBatch): NormalizedItem[];
+}
+//# sourceMappingURL=FixtureActivitySyncProvider.d.ts.map

package/dist/providers/FixtureActivitySyncProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixtureActivitySyncProvider.d.ts","sourceRoot":"","sources":["../../src/providers/FixtureActivitySyncProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErG,qBACa,2BAA4B,SAAQ,wBAAwB;IAQjE,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAT3B,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IACzC,SAAgB,gBAAgB,aAAa;IAC7C,SAAgB,MAAM,SAAS;IAC/B,SAAgB,KAAK,EAAE,mBAAmB,EAAE,CAAM;IAC3C,SAAS,EAAE,IAAI,CAAc;gBAGf,KAAK,GAAE,cAAc,EAAO,EAC7C,IAAI,GAAE,kBAA8B,EACnB,MAAM,GAAE,MAAM,EAAO;IAM1C;;;;OAIG;cACgB,GAAG,IAAI,IAAI;cAId,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAavE,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,cAAc,EAAE;CAGvD"}

package/dist/providers/FixtureActivitySyncProvider.js

@@ -0,0 +1,58 @@
+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);
+};
+/**
+ * A source backed by handed-in items. The substitute the pipeline is proved against.
+ *
+ * Not a mock: it hands over the same NormalizedItem[] a live provider would, so a test
+ * exercises the real cascade, resolver, writer and watermark.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseActivitySyncProvider } from '../BaseActivitySyncProvider.js';
+let FixtureActivitySyncProvider = class FixtureActivitySyncProvider extends BaseActivitySyncProvider {
+    constructor(items = [], kind = 'Message', issues = []) {
+        super();
+        this.items = items;
+        this.issues = issues;
+        this.ProviderTypeCode = 'Generic';
+        this.IsLive = false;
+        this.Calls = [];
+        this.fetchedAt = new Date();
+        this.Kind = kind;
+    }
+    /**
+     * The instant a CALENDAR fixture reports as its watermark. Injectable so a
+     * check can assert an exact value instead of racing the clock. Messages
+     * still use max(StartedAt) via Kind.
+     */
+    Now() {
+        return this.fetchedAt;
+    }
+    async FetchRaw(query) {
+        this.Calls.push(query);
+        const since = query.Since ? query.Since.getTime() : null;
+        const eligible = this.items
+            .filter((item) => since === null || item.StartedAt.getTime() > since)
+            .sort((a, b) => a.StartedAt.getTime() - b.StartedAt.getTime())
+            .slice(0, Math.max(0, query.Limit));
+        return {
+            Payloads: eligible.map((item) => ({ item })),
+            Issues: [...this.issues],
+        };
+    }
+    Normalize(raw) {
+        return raw.Payloads.map((p) => p.item);
+    }
+};
+FixtureActivitySyncProvider = __decorate([
+    RegisterClass(BaseActivitySyncProvider, 'Generic'),
+    __metadata("design:paramtypes", [Array, String, Array])
+], FixtureActivitySyncProvider);
+export { FixtureActivitySyncProvider };
+//# sourceMappingURL=FixtureActivitySyncProvider.js.map

package/dist/providers/FixtureActivitySyncProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixtureActivitySyncProvider.js","sourceRoot":"","sources":["../../src/providers/FixtureActivitySyncProvider.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAInE,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,wBAAwB;IAOrE,YACqB,QAA0B,EAAE,EAC7C,OAA2B,SAAS,EACnB,SAAmB,EAAE;QAEtC,KAAK,EAAE,CAAC;QAJS,UAAK,GAAL,KAAK,CAAuB;QAE5B,WAAM,GAAN,MAAM,CAAe;QAR1B,qBAAgB,GAAG,SAAS,CAAC;QAC7B,WAAM,GAAG,KAAK,CAAC;QACf,UAAK,GAA0B,EAAE,CAAC;QAC3C,cAAS,GAAS,IAAI,IAAI,EAAE,CAAC;QAQhC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACgB,GAAG;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,KAA0B;QAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK;aACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC;aACpE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;aAC7D,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,OAAO;YACH,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;SAC3B,CAAC;IACN,CAAC;IAES,SAAS,CAAC,GAAa;QAC7B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAsB,CAAC,CAAC;IAC7D,CAAC;CACJ,CAAA;AAzCY,2BAA2B;IADvC,aAAa,CAAC,wBAAwB,EAAE,SAAS,CAAC;;GACtC,2BAA2B,CAyCvC"}