@mj-biz-apps/common-server 5.36.0 → 5.37.0

package/dist/custom/log-activity.action.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `Common.LogActivity` — the declarative entry point to the unified timeline.
+ *
+ * The keystone of the Entity Action adoption plan (plans/mj-entity-action-workflow-adoption.md
+ * §3.1): any app binds `AfterCreate` / `AfterUpdate` on any entity to this action and the record's
+ * lifecycle appears on a person's or organization's timeline with no code in the consuming app.
+ *
+ * It WRAPS `ActivityWriter` (§3.2 — one writer, two entry points), never writes its own rows, and
+ * takes only serializable params: bind `RecordData` with ValueType `'Entity Object Data'`, never
+ * `'Entity Object'` (§3.3 — a BaseEntity serializes to `{}` silently).
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+export declare class LogActivityAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private log;
+}
+export declare function LoadLogActivityAction(): void;
+//# sourceMappingURL=log-activity.action.d.ts.map

package/dist/custom/log-activity.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-activity.action.d.ts","sourceRoot":"","sources":["../../src/custom/log-activity.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAerG,qBACa,iBAAkB,SAAQ,UAAU;cAC7B,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAYzE,GAAG;CAsCpB;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/custom/log-activity.action.js

@@ -0,0 +1,87 @@
+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;
+};
+/**
+ * `Common.LogActivity` — the declarative entry point to the unified timeline.
+ *
+ * The keystone of the Entity Action adoption plan (plans/mj-entity-action-workflow-adoption.md
+ * §3.1): any app binds `AfterCreate` / `AfterUpdate` on any entity to this action and the record's
+ * lifecycle appears on a person's or organization's timeline with no code in the consuming app.
+ *
+ * It WRAPS `ActivityWriter` (§3.2 — one writer, two entry points), never writes its own rows, and
+ * takes only serializable params: bind `RecordData` with ValueType `'Entity Object Data'`, never
+ * `'Entity Object'` (§3.3 — a BaseEntity serializes to `{}` silently).
+ */
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { ActivityWriter, ParseLogActivityParams } from '@mj-biz-apps/common-activity-sync';
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+let LogActivityAction = class LogActivityAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            return await this.log(params);
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `LogActivity failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async log(params) {
+        if (!params.ContextUser) {
+            return { Success: false, ResultCode: 'VALIDATION_ERROR', Message: 'ContextUser is required.' };
+        }
+        const values = {};
+        for (const param of params.Params ?? []) {
+            if (param.Name)
+                values[param.Name] = param.Value;
+        }
+        const parsed = ParseLogActivityParams(values);
+        if (!parsed.Input) {
+            return {
+                Success: false,
+                ResultCode: 'VALIDATION_ERROR',
+                Message: `LogActivity input is invalid: ${parsed.Errors.join(' | ')}`,
+            };
+        }
+        const result = await new ActivityWriter().WriteManual(parsed.Input, Metadata.Provider, params.ContextUser);
+        setOutput(params, 'ActivityID', result.ActivityID);
+        setOutput(params, 'AlreadyPresent', result.AlreadyPresent);
+        if (!result.Success) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `The activity could not be written: ${result.Issues.join(' | ')}`,
+            };
+        }
+        return {
+            Success: true,
+            ResultCode: result.AlreadyPresent ? 'ALREADY_PRESENT' : 'SUCCESS',
+            Message: result.AlreadyPresent
+                ? `An activity with this SourceSystem/ExternalID already exists (${result.ActivityID}).`
+                : `Activity ${result.ActivityID} written with ${result.Links.length} link(s).`,
+        };
+    }
+};
+LogActivityAction = __decorate([
+    RegisterClass(BaseAction, 'Common.LogActivity')
+], LogActivityAction);
+export { LogActivityAction };
+export function LoadLogActivityAction() {
+    void LogActivityAction;
+}
+//# sourceMappingURL=log-activity.action.js.map

package/dist/custom/log-activity.action.js.map

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

package/dist/custom/sync-activities.action.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `Common.SyncActivities` — the MJ Action a ScheduledJob fires hourly.
+ *
+ * Downstream apps do not wrap this. They register a BaseActivitySyncExtension
+ * (Sales.DealLinker) which the engine runs inside the write transaction.
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+export declare class SyncActivitiesAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private sync;
+}
+export declare function LoadSyncActivitiesAction(): void;
+//# sourceMappingURL=sync-activities.action.d.ts.map

package/dist/custom/sync-activities.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-activities.action.d.ts","sourceRoot":"","sources":["../../src/custom/sync-activities.action.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA0BrG,qBACa,oBAAqB,SAAQ,UAAU;cAChC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAYzE,IAAI;CAmBrB;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/custom/sync-activities.action.js

@@ -0,0 +1,67 @@
+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;
+};
+/**
+ * `Common.SyncActivities` — the MJ Action a ScheduledJob fires hourly.
+ *
+ * Downstream apps do not wrap this. They register a BaseActivitySyncExtension
+ * (Sales.DealLinker) which the engine runs inside the write transaction.
+ */
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { ActionResultFromFleet, ActivitySyncEngine, TotalsFromFleet, } from '@mj-biz-apps/common-activity-sync';
+const P_LIMIT = 'Limit';
+const DEFAULT_LIMIT = 100;
+function readParam(params, name) {
+    return params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase())?.Value;
+}
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+let SyncActivitiesAction = class SyncActivitiesAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            return await this.sync(params);
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `The activity sync failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async sync(params) {
+        const raw = readParam(params, P_LIMIT);
+        const parsed = raw === null || raw === undefined || raw === '' ? DEFAULT_LIMIT : Number(raw);
+        const limit = Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : DEFAULT_LIMIT;
+        const fleet = await new ActivitySyncEngine().RunConnections({ DryRun: false, TriggerType: 'Scheduled', Limit: limit }, Metadata.Provider, params.ContextUser);
+        const totals = TotalsFromFleet(fleet);
+        setOutput(params, 'ConnectionsAttempted', fleet.ConnectionsAttempted);
+        setOutput(params, 'Fetched', totals.Fetched);
+        setOutput(params, 'Written', totals.Written);
+        setOutput(params, 'Duplicates', totals.Duplicates);
+        setOutput(params, 'Excluded', totals.Excluded);
+        setOutput(params, 'Failed', totals.Failed);
+        setOutput(params, 'Issues', JSON.stringify(fleet.Issues));
+        return ActionResultFromFleet(fleet, totals);
+    }
+};
+SyncActivitiesAction = __decorate([
+    RegisterClass(BaseAction, 'Common.SyncActivities')
+], SyncActivitiesAction);
+export { SyncActivitiesAction };
+export function LoadSyncActivitiesAction() {
+    void SyncActivitiesAction;
+}
+//# sourceMappingURL=sync-activities.action.js.map

package/dist/custom/sync-activities.action.js.map

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