@memberjunction/record-set-processor 0.0.1 → 5.43.0

package/dist/trackers/GenericProcessRunTracker.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview The default persistence tracker — writes `MJ: Process Runs` (the run header) and
+ * `MJ: Process Run Details` (one row per processed record), and implements the pause/cancel
+ * handshake by re-reading the run row's `CancellationRequested` flag at each checkpoint.
+ * @module @memberjunction/record-set-processor
+ */
+import { BaseEntitySaveQueue, LogError, Metadata } from '@memberjunction/core';
+/** The default tracker, persisting to the generic `MJ: Process Runs` / `MJ: Process Run Details` tables. */
+export class GenericProcessRunTracker {
+    constructor() {
+        /**
+         * Fire-and-forget queue for per-record detail INSERTs. Each detail is its own entity instance (a
+         * distinct key), so detail writes run concurrently without blocking the per-record loop; `CompleteRun`
+         * flushes them before finalizing the run. (Reliable/insert-before-fire mode is a future enhancement —
+         * it needs a per-record start hook on `IProcessRunTracker`.)
+         */
+        this.detailQueue = new BaseEntitySaveQueue();
+    }
+    async BeginRun(meta, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        const run = await md.GetEntityObject('MJ: Process Runs', contextUser);
+        run.NewRecord();
+        run.RecordProcessID = meta.RecordProcessID ?? null;
+        run.ScheduledJobRunID = meta.ScheduledJobRunID ?? null;
+        run.EntityID = meta.EntityID ?? null;
+        run.TriggeredBy = meta.TriggeredBy;
+        run.SourceType = meta.SourceType;
+        run.SourceID = meta.SourceID ?? null;
+        run.SourceFilter = meta.SourceFilter ?? null;
+        run.Status = 'Running';
+        run.StartTime = new Date();
+        run.TotalItemCount = meta.TotalItemCount ?? null;
+        run.ProcessedItems = 0;
+        run.SuccessCount = 0;
+        run.ErrorCount = 0;
+        run.SkippedCount = 0;
+        run.BatchSize = meta.BatchSize ?? null;
+        run.CancellationRequested = false;
+        run.DryRun = meta.DryRun ?? false;
+        run.StartedByUserID = contextUser?.ID ?? null;
+        if (meta.Configuration !== undefined) {
+            run.Configuration = JSON.stringify(meta.Configuration);
+        }
+        const saved = await run.Save();
+        if (!saved) {
+            throw new Error(`GenericProcessRunTracker: failed to create Process Run: ${run.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        return { ProcessRunID: run.ID, run };
+    }
+    async RecordResult(handle, record, result, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        const run = handle.run;
+        const detail = await md.GetEntityObject('MJ: Process Run Details', contextUser);
+        detail.NewRecord();
+        detail.ProcessRunID = run.ID;
+        detail.EntityID = record.EntityID;
+        detail.RecordID = record.RecordID;
+        detail.Status = result.Status;
+        detail.CompletedAt = new Date();
+        detail.StartedAt = result.DurationMs != null ? new Date(Date.now() - result.DurationMs) : null;
+        detail.DurationMs = result.DurationMs ?? null;
+        detail.AttemptCount = result.AttemptCount ?? 1;
+        detail.ResultPayload = result.ResultPayload !== undefined ? JSON.stringify(result.ResultPayload) : null;
+        detail.ErrorMessage = result.ErrorMessage ?? null;
+        detail.ActionExecutionLogID = result.ActionExecutionLogID ?? null;
+        detail.AIAgentRunID = result.AIAgentRunID ?? null;
+        // Fire-and-forget — the detail write must not block the per-record loop, and a failed write must
+        // not abort the run (the queue logs failures; CompleteRun flushes + reports the count).
+        this.detailQueue.Insert(detail);
+    }
+    async Checkpoint(handle, cursor, counts, _contextUser, _provider) {
+        const run = handle.run;
+        run.ProcessedItems = counts.Processed;
+        run.SuccessCount = counts.Success;
+        run.ErrorCount = counts.Error;
+        run.SkippedCount = counts.Skipped;
+        if (cursor.Offset != null) {
+            run.LastProcessedOffset = cursor.Offset;
+        }
+        if (cursor.Key != null) {
+            run.LastProcessedKey = cursor.Key;
+        }
+        const saved = await run.Save();
+        if (!saved) {
+            LogError(`GenericProcessRunTracker: checkpoint save failed for run '${run.ID}': ${run.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            return true; // a transient checkpoint failure should not halt processing
+        }
+        // Re-read to pick up an externally-requested pause/cancel.
+        await run.Load(run.ID);
+        if (run.CancellationRequested) {
+            run.Status = 'Paused';
+            run.EndTime = new Date();
+            await run.Save();
+            return false;
+        }
+        return true;
+    }
+    async CompleteRun(handle, summary, _contextUser, _provider) {
+        // Ensure every fire-and-forget detail write has landed before we finalize the run header.
+        const flush = await this.detailQueue.Flush();
+        if (flush.failures > 0) {
+            LogError(`GenericProcessRunTracker: ${flush.failures} Process Run Detail write(s) failed for run '${handle.run.ID}'`);
+        }
+        const run = handle.run;
+        run.Status = summary.Status;
+        run.EndTime = summary.EndTime ?? new Date();
+        run.ProcessedItems = summary.Processed;
+        run.SuccessCount = summary.Success;
+        run.ErrorCount = summary.Error;
+        run.SkippedCount = summary.Skipped;
+        if (summary.Total != null) {
+            run.TotalItemCount = summary.Total;
+        }
+        if (summary.ErrorMessage) {
+            run.ErrorMessage = summary.ErrorMessage;
+        }
+        const saved = await run.Save();
+        if (!saved) {
+            LogError(`GenericProcessRunTracker: failed to complete run '${run.ID}': ${run.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+    }
+    async LoadResumeCursor(handle, _contextUser, _provider) {
+        const run = handle.run;
+        if (run.LastProcessedKey != null) {
+            return { Key: run.LastProcessedKey };
+        }
+        if (run.LastProcessedOffset != null && run.LastProcessedOffset > 0) {
+            return { Offset: run.LastProcessedOffset };
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=GenericProcessRunTracker.js.map

package/dist/trackers/GenericProcessRunTracker.js.map

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

package/dist/trackers/NoOpTracker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview A tracker that persists nothing — for fire-and-forget single-record work where a
+ * full run record would be overkill.
+ * @module @memberjunction/record-set-processor
+ */
+import { IProcessRunTracker, ProcessCursor, RunHandle } from '@memberjunction/record-set-processor-base';
+/** An {@link IProcessRunTracker} that discards all run/detail tracking. */
+export declare class NoOpTracker implements IProcessRunTracker {
+    BeginRun(): Promise<RunHandle>;
+    RecordResult(): Promise<void>;
+    Checkpoint(): Promise<boolean>;
+    CompleteRun(): Promise<void>;
+    LoadResumeCursor(): Promise<ProcessCursor | undefined>;
+}
+//# sourceMappingURL=NoOpTracker.d.ts.map

package/dist/trackers/NoOpTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpTracker.d.ts","sourceRoot":"","sources":["../../src/trackers/NoOpTracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,SAAS,EACZ,MAAM,2CAA2C,CAAC;AAEnD,2EAA2E;AAC3E,qBAAa,WAAY,YAAW,kBAAkB;IACrC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAG9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAG7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAG9B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAG5B,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;CAGtE"}

package/dist/trackers/NoOpTracker.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview A tracker that persists nothing — for fire-and-forget single-record work where a
+ * full run record would be overkill.
+ * @module @memberjunction/record-set-processor
+ */
+/** An {@link IProcessRunTracker} that discards all run/detail tracking. */
+export class NoOpTracker {
+    async BeginRun() {
+        return {};
+    }
+    async RecordResult() {
+        // intentionally empty
+    }
+    async Checkpoint() {
+        return true;
+    }
+    async CompleteRun() {
+        // intentionally empty
+    }
+    async LoadResumeCursor() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=NoOpTracker.js.map

package/dist/trackers/NoOpTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpTracker.js","sourceRoot":"","sources":["../../src/trackers/NoOpTracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,2EAA2E;AAC3E,MAAM,OAAO,WAAW;IACb,KAAK,CAAC,QAAQ;QACjB,OAAO,EAAE,CAAC;IACd,CAAC;IACM,KAAK,CAAC,YAAY;QACrB,sBAAsB;IAC1B,CAAC;IACM,KAAK,CAAC,UAAU;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACM,KAAK,CAAC,WAAW;QACpB,sBAAsB;IAC1B,CAAC;IACM,KAAK,CAAC,gBAAgB;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ"}

package/dist/writeBack.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Output-mapping write-back — applies a work's structured result back onto the data
+ * model per an `OutputMapping` config: update fields on the processed record and/or create a child
+ * record. Reads from the result use the generic value-mapping resolver (`$` = the result root).
+ * @module @memberjunction/record-set-processor
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { RecordRef } from '@memberjunction/record-set-processor-base';
+/** Declarative description of how a work's structured output is written back. */
+export interface OutputMappingConfig {
+    /** Map of `EntityFieldName -> resultRef` (e.g. `{ "Satisfaction": "$.satisfaction" }`) applied to the processed record. */
+    fields?: Record<string, string>;
+    /** Optional child record to create from the result. */
+    childRecord?: {
+        /** Target child entity name. */
+        entity: string;
+        /** FK field on the child set to the processed record's primary key. */
+        parentField: string;
+        /** Map of `ChildFieldName -> resultRef`. */
+        map: Record<string, string>;
+    };
+}
+/** Outcome of {@link applyOutputMapping}. */
+export interface WriteBackResult {
+    /** True if the processed record's fields were updated. */
+    updatedRecord: boolean;
+    /** ID of the created child record, when a child mapping was applied. */
+    createdChildID?: string;
+}
+/**
+ * Applies an {@link OutputMappingConfig} against a work result. Single-primary-key entities only
+ * (composite keys throw a clear error). Field/child values are resolved from the result via the
+ * shared resolver, so `"$.path"` reads `result.path`.
+ */
+export declare function applyOutputMapping(opts: {
+    outputMapping: OutputMappingConfig;
+    result: unknown;
+    record: RecordRef;
+    contextUser: UserInfo;
+    provider?: IMetadataProvider;
+}): Promise<WriteBackResult>;
+//# sourceMappingURL=writeBack.d.ts.map

package/dist/writeBack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeBack.d.ts","sourceRoot":"","sources":["../src/writeBack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEvG,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAEtE,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAChC,2HAA2H;IAC3H,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uDAAuD;IACvD,WAAW,CAAC,EAAE;QACV,gCAAgC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,uEAAuE;QACvE,WAAW,EAAE,MAAM,CAAC;QACpB,4CAA4C;QAC5C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACL;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC5B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC3C,aAAa,EAAE,mBAAmB,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC,GAAG,OAAO,CAAC,eAAe,CAAC,CA+C3B"}

package/dist/writeBack.js

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Output-mapping write-back — applies a work's structured result back onto the data
+ * model per an `OutputMapping` config: update fields on the processed record and/or create a child
+ * record. Reads from the result use the generic value-mapping resolver (`$` = the result root).
+ * @module @memberjunction/record-set-processor
+ */
+import { CompositeKey, Metadata } from '@memberjunction/core';
+import { resolveMappingRef } from '@memberjunction/global';
+/**
+ * Applies an {@link OutputMappingConfig} against a work result. Single-primary-key entities only
+ * (composite keys throw a clear error). Field/child values are resolved from the result via the
+ * shared resolver, so `"$.path"` reads `result.path`.
+ */
+export async function applyOutputMapping(opts) {
+    const { outputMapping, result, record, contextUser } = opts;
+    const provider = opts.provider ?? Metadata.Provider;
+    const sources = { $: result, record: record.Record ?? {} };
+    const out = { updatedRecord: false };
+    // 1) Update fields on the processed record.
+    if (outputMapping.fields && Object.keys(outputMapping.fields).length > 0) {
+        const entity = provider.EntityByID(record.EntityID);
+        if (!entity) {
+            throw new Error(`applyOutputMapping: entity '${record.EntityID}' not found in metadata`);
+        }
+        if (entity.PrimaryKeys.length !== 1) {
+            throw new Error(`applyOutputMapping: write-back currently supports single-primary-key entities only ('${entity.Name}')`);
+        }
+        const obj = await provider.GetEntityObject(entity.Name, contextUser);
+        const loaded = await obj.InnerLoad(CompositeKey.FromKeyValuePair(entity.FirstPrimaryKey.Name, record.RecordID));
+        if (!loaded) {
+            throw new Error(`applyOutputMapping: record '${record.RecordID}' of '${entity.Name}' not found`);
+        }
+        for (const [field, ref] of Object.entries(outputMapping.fields)) {
+            // Dynamic, config-driven field names — the legitimate use of Set() (no compile-time property).
+            obj.Set(field, resolveMappingRef(ref, sources));
+        }
+        const saved = await obj.Save();
+        if (!saved) {
+            throw new Error(`applyOutputMapping: failed updating '${entity.Name}' record '${record.RecordID}': ${obj.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        out.updatedRecord = true;
+    }
+    // 2) Create a child record.
+    if (outputMapping.childRecord) {
+        const child = await provider.GetEntityObject(outputMapping.childRecord.entity, contextUser);
+        child.NewRecord();
+        child.Set(outputMapping.childRecord.parentField, record.RecordID);
+        for (const [field, ref] of Object.entries(outputMapping.childRecord.map)) {
+            child.Set(field, resolveMappingRef(ref, sources));
+        }
+        const saved = await child.Save();
+        if (!saved) {
+            throw new Error(`applyOutputMapping: failed creating '${outputMapping.childRecord.entity}' child: ${child.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        out.createdChildID = child.FirstPrimaryKey?.Value != null ? String(child.FirstPrimaryKey.Value) : undefined;
+    }
+    return out;
+}
+//# sourceMappingURL=writeBack.js.map

package/dist/writeBack.js.map

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

package/package.json

@@ -1,10 +1,42 @@
 {
   "name": "@memberjunction/record-set-processor",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/record-set-processor",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.43.0",
+  "description": "MemberJunction: Record Set Processor - server engine that batches, rate-limits, resumes, and audits processing of a record set through a pluggable source/processor/tracker pipeline.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/core": "5.43.0",
+    "@memberjunction/global": "5.43.0",
+    "@memberjunction/core-entities": "5.43.0",
+    "@memberjunction/field-rules-transforms": "5.43.0",
+    "@memberjunction/record-set-processor-base": "5.43.0",
+    "@memberjunction/actions": "5.43.0",
+    "@memberjunction/actions-base": "5.43.0",
+    "@memberjunction/ai-agents": "5.43.0",
+    "@memberjunction/aiengine": "5.43.0",
+    "@memberjunction/ai-prompts": "5.43.0",
+    "@memberjunction/ai-core-plus": "5.43.0",
+    "@memberjunction/templates": "5.43.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }