@memberjunction/record-cloning 0.0.1-seed.1 → 6.2.0-edge.3

package/dist/CloneExecutor.js

@@ -0,0 +1,350 @@
+/**
+ * @file CloneExecutor.ts
+ * Executes deterministic clone plans inside an atomic database transaction.
+ * Materializes graphs, verifies plan hash stability, enforces root.Save() arbitration,
+ * and writes provenance: Record Changes, a Clone Log with one item per planned row, ClonedFrom
+ * Record Links, and a Record Cloned audit entry. Refused and failed runs are logged too.
+ * @see plans/record-cloning/README.md §6, §8, §10, §13.1
+ */
+import { EntitySaveOptions, LogError, Metadata, RunInEntityTransaction, WellKnownUserSource, } from '@memberjunction/core';
+import { GenerateUUID, MaskSensitiveFieldChange, MaskSensitivePlan, } from '@memberjunction/record-cloning-base';
+import { CloneMaterializer } from './CloneMaterializer.js';
+import { ComputeClonePlanHash } from './ClonePlanHash.js';
+import { ToRecordKeyString } from './CloneKeys.js';
+import { CloneAuthorizer } from './CloneAuthorization.js';
+/** Entities the executor writes provenance to. */
+const PROVENANCE_ENTITIES = ['MJ: Record Clone Logs', 'MJ: Record Clone Log Items', 'MJ: Record Links'];
+function toCompositeKey(key, defaultFieldName = 'ID') {
+    if (!key) {
+        return { KeyValuePairs: [{ FieldName: defaultFieldName, Value: '' }] };
+    }
+    if (typeof key === 'object' && 'KeyValuePairs' in key && Array.isArray(key.KeyValuePairs)) {
+        return {
+            KeyValuePairs: key.KeyValuePairs.map((kvp) => ({
+                FieldName: kvp.FieldName,
+                Value: kvp.Value,
+            })),
+        };
+    }
+    // A record-id string: "F|V" or "F|V||F|V" names its columns; a bare value uses the default column.
+    const text = String(key);
+    if (!text.includes('|'))
+        return { KeyValuePairs: [{ FieldName: defaultFieldName, Value: text }] };
+    return {
+        KeyValuePairs: text.split('||').map((pair) => {
+            const at = pair.indexOf('|');
+            return { FieldName: pair.slice(0, at), Value: pair.slice(at + 1) };
+        }),
+    };
+}
+export class CloneExecutor {
+    constructor(options) {
+        this._provider = options?.Provider;
+    }
+    get Provider() {
+        return this._provider ?? Metadata.Provider;
+    }
+    /**
+     * Executes a ClonePlan atomically.
+     */
+    async Execute(plan, contextUser) {
+        const md = this.Provider;
+        // 1. Refuse blocked plan
+        if (plan.Blocked) {
+            const logId = await this.WriteRefusalLog(plan, contextUser, 'Blocked: ' + plan.Warnings.filter((w) => w.Severity === 'Error').map((w) => w.Message).join('; '));
+            return {
+                Success: false,
+                ResultCode: 'BLOCKED',
+                CloneLogID: logId,
+                RootRecordKey: plan.RootTargetKey,
+                RecordsCloned: 0,
+                Warnings: plan.Warnings,
+                ErrorMessage: `Clone plan is blocked due to validation or permission errors: ${plan.Warnings.map((w) => w.Message).join('; ')}`,
+            };
+        }
+        // 2. Verify Plan Hash integrity (§13.1 RC7)
+        const currentHash = ComputeClonePlanHash({
+            Nodes: plan.Nodes,
+            Edges: plan.Edges,
+            Excluded: plan.Excluded,
+        });
+        if (currentHash !== plan.Hash && currentHash !== plan.PlanHash) {
+            const logId = await this.WriteRefusalLog(plan, contextUser, 'PLAN_CHANGED: the plan changed between review and execution.');
+            return {
+                Success: false,
+                ResultCode: 'PLAN_CHANGED',
+                CloneLogID: logId,
+                RootRecordKey: plan.RootTargetKey,
+                RecordsCloned: 0,
+                Warnings: [
+                    ...plan.Warnings,
+                    {
+                        Code: 'PLAN_CHANGED',
+                        Severity: 'Error',
+                        Message: 'Plan hash mismatch: the plan or underlying source entities changed between review and execution.',
+                    },
+                ],
+                ErrorMessage: 'PLAN_CHANGED',
+            };
+        }
+        // A clone is all or nothing (plan §6): refuse rather than run it without a transaction.
+        // Transactions are an IEntityDataProvider capability; the metadata provider is also the data provider.
+        const transProvider = md;
+        if (transProvider.SupportsEntityTransactions !== true || typeof transProvider.BeginEntityTransaction !== 'function') {
+            const message = 'This provider cannot run the clone in a transaction, so it was not started (a partial clone cannot be undone).';
+            const logId = await this.WriteRefusalLog(plan, contextUser, message);
+            return { Success: false, ResultCode: 'EXECUTION_ERROR', CloneLogID: logId, RootRecordKey: plan.RootTargetKey, RecordsCloned: 0, Warnings: plan.Warnings, ErrorMessage: message };
+        }
+        const cloneLogId = GenerateUUID();
+        const startedAt = new Date();
+        const saveOptions = CloneExecutor.saveOptionsFor(plan);
+        const materializer = new CloneMaterializer(md);
+        try {
+            return await RunInEntityTransaction(transProvider, async () => {
+                // 3. Materialize in-memory graph
+                const { RootEntity: rootEntity, StagedEntities: stagedEntities, SidecarEntities: sidecarEntities, PrerequisiteEntities: prerequisiteEntities, DeferredNodeKeys: deferredNodeKeys, } = await materializer.Materialize(plan, contextUser);
+                // 4. Attach CloneContext to all staged entities (§10)
+                for (const [nodeKey, entity] of stagedEntities.entries()) {
+                    const planNode = plan.Nodes.find((n) => (n.NodeKey ?? n.Key) === nodeKey);
+                    entity.SetCloneContext({
+                        CloneLogID: cloneLogId,
+                        SourceEntityName: planNode?.EntityName || entity.EntityInfo.Name,
+                        SourceRecordID: ToRecordKeyString(planNode?.SourceKey),
+                        RootEntityName: plan.RootEntityName || entity.EntityInfo.Name,
+                        RootSourceRecordID: ToRecordKeyString(plan.RootSourceKey),
+                        RootTargetRecordID: ToRecordKeyString(plan.RootTargetKey),
+                        Depth: planNode?.Depth ?? 0,
+                        // A row deferred behind another new row saves as a sidecar, whatever the plan said.
+                        Route: deferredNodeKeys?.has(nodeKey) ? 'Sidecar' : planNode?.Route ?? 'RootSave',
+                        FieldChangeSummary: [],
+                        Reason: plan.Reason,
+                    });
+                }
+                // 4b. Save prerequisites (ForwardFK targets the root needs) deepest first: in a chain
+                // root -> A -> B, B must exist before A can point at it. Stable for equal depths.
+                const depthOf = new Map();
+                for (const [nodeKey, entity] of stagedEntities.entries()) {
+                    depthOf.set(entity, plan.Nodes.find((n) => (n.NodeKey ?? n.Key) === nodeKey)?.Depth ?? 0);
+                }
+                const prereqEntities = [...(prerequisiteEntities ?? [])].sort((a, b) => (depthOf.get(b) ?? 0) - (depthOf.get(a) ?? 0));
+                for (const prereq of prereqEntities) {
+                    const prereqSaved = await prereq.Save(saveOptions);
+                    if (!prereqSaved) {
+                        const errorMsg = prereq.LatestResult?.CompleteMessage ||
+                            `Prerequisite clone save failed for entity '${prereq.EntityInfo.Name}'.`;
+                        throw new Error(errorMsg);
+                    }
+                }
+                // 5. Atomic Save via root.Save()
+                const rootSaved = await rootEntity.Save(saveOptions); // forwarded to every child in the save plan
+                if (!rootSaved) {
+                    const errorMsg = rootEntity.LatestResult?.CompleteMessage ||
+                        `Composite clone save failed for root entity '${plan.RootEntityName}'.`;
+                    throw new Error(errorMsg);
+                }
+                // 6. Save Sidecars in dependency order. They are staged too, so step 4 already gave
+                // each its clone context (with its real source record).
+                for (const sidecar of sidecarEntities) {
+                    const sidecarSaved = await sidecar.Save(saveOptions);
+                    if (!sidecarSaved) {
+                        const errorMsg = sidecar.LatestResult?.CompleteMessage ||
+                            `Sidecar clone save failed for entity '${sidecar.EntityInfo.Name}'.`;
+                        throw new Error(errorMsg);
+                    }
+                }
+                // 7. Write provenance (§10) in the same transaction: a clone with no log or lineage
+                // is not a successful clone, so a provenance failure rolls the clone back.
+                await this.writeSuccessProvenance(plan, cloneLogId, startedAt, stagedEntities, contextUser, rootEntity);
+                // Every created row (root, children, prerequisites, sidecars) is in stagedEntities once.
+                const clonedCount = stagedEntities.size;
+                const rootTargetKey = rootEntity.PrimaryKey?.ToCompactURLSegment?.() ?? rootEntity.PrimaryKey?.ToConcatenatedString?.() ?? plan.RootTargetKey;
+                // Build created records mapping
+                const createdMappings = [];
+                for (const [nodeKey, entity] of stagedEntities.entries()) {
+                    const planNode = plan.Nodes.find((n) => (n.NodeKey ?? n.Key) === nodeKey);
+                    createdMappings.push({
+                        EntityName: entity.EntityInfo.Name,
+                        SourceKey: toCompositeKey(planNode?.SourceKey),
+                        TargetKey: toCompositeKey(entity.PrimaryKey),
+                        Depth: planNode?.Depth ?? 0,
+                    });
+                }
+                return {
+                    Success: true,
+                    ResultCode: 'SUCCESS',
+                    RootRecordKey: rootTargetKey,
+                    Roots: [
+                        {
+                            EntityName: plan.RootEntityName,
+                            SourceKey: toCompositeKey(plan.RootSourceKey),
+                            TargetKey: toCompositeKey(rootEntity.PrimaryKey ?? rootTargetKey),
+                        },
+                    ],
+                    Created: createdMappings,
+                    RecordsCloned: clonedCount,
+                    CloneLogID: cloneLogId,
+                    Warnings: plan.Warnings,
+                };
+            });
+        }
+        catch (e) {
+            const detail = e instanceof Error ? e.message : String(e);
+            // The transaction rolled back, taking any log written inside it; record the failure outside it.
+            const logged = await this.writeLog(plan, contextUser, { ID: cloneLogId, Status: 'Error', StartedAt: startedAt, ErrorMessage: detail });
+            await this.writeAudit(plan, contextUser, false, cloneLogId, null, detail);
+            return {
+                CloneLogID: logged ? cloneLogId : null,
+                Success: false,
+                ResultCode: 'EXECUTION_ERROR',
+                RootRecordKey: plan.RootTargetKey,
+                RecordsCloned: 0,
+                Warnings: plan.Warnings,
+                ErrorMessage: detail,
+            };
+        }
+    }
+    /**
+     * Save options for the clone's own rows, from the plan's effective options: Entity Actions run
+     * by default and AI Actions don't, unless the entity's configuration (or a Fire Hooks holder's
+     * request) says otherwise.
+     */
+    static saveOptionsFor(plan) {
+        const options = new EntitySaveOptions();
+        options.SkipEntityActions = plan.EffectiveOptions?.EntityActions !== 'fire';
+        options.SkipEntityAIActions = plan.EffectiveOptions?.AIActions !== 'fire';
+        return options;
+    }
+    /**
+     * Records a refused run (blocked, or the plan changed since review) as a Cancelled clone log,
+     * so every Execute leaves a trace. Written outside any transaction; never throws.
+     * @returns the log's ID, or null when it could not be written.
+     */
+    async WriteRefusalLog(plan, contextUser, reason) {
+        const id = GenerateUUID();
+        const logged = await this.writeLog(plan, contextUser, { ID: id, Status: 'Cancelled', StartedAt: new Date(), ErrorMessage: reason });
+        await this.writeAudit(plan, contextUser, false, id, null, reason);
+        return logged ? id : null;
+    }
+    /**
+     * The identity provenance rows are saved as. Logs and lineage links are the platform's record
+     * of what happened, not the cloner's own data (the UI role may only read them), so they are
+     * written as the system user when this process has one. `InitiatedByUserID` still names the cloner.
+     */
+    async provenanceUser(contextUser) {
+        return (await WellKnownUserSource.Instance.GetSystemUser(this.Provider)) ?? contextUser;
+    }
+    /** Clone log, one log item per plan node, ClonedFrom links, and the audit entry. Throws if the log or a link can't be saved. */
+    async writeSuccessProvenance(plan, cloneLogId, startedAt, stagedEntities, contextUser, rootEntity) {
+        const md = this.Provider;
+        const missing = PROVENANCE_ENTITIES.filter((name) => !md.EntityByName(name));
+        if (missing.length > 0) {
+            // Only a provider without MJ's own entities (a bare test provider) lands here.
+            LogError(`[RecordCloning] ${missing.join(', ')} not found; clone ${cloneLogId} has no provenance.`);
+            return;
+        }
+        const asUser = await this.provenanceUser(contextUser);
+        const rootTargetId = ToRecordKeyString(rootEntity.PrimaryKey ?? plan.RootTargetKey) || null;
+        const logSaved = await this.writeLog(plan, contextUser, {
+            ID: cloneLogId,
+            Status: 'Complete',
+            StartedAt: startedAt,
+            RootTargetRecordID: rootTargetId,
+            CreatedCount: stagedEntities.size,
+            ResultJSON: JSON.stringify({ Created: stagedEntities.size }),
+        });
+        if (!logSaved)
+            throw new Error(`The clone log could not be saved, so the clone was rolled back.`);
+        // A. Log items: what happened to each planned row, with its (masked) field changes.
+        let sequence = 0;
+        for (const node of plan.Nodes) {
+            const nodeKey = node.NodeKey ?? node.Key;
+            const created = stagedEntities.get(nodeKey);
+            const item = await md.GetEntityObject('MJ: Record Clone Log Items', asUser);
+            item.NewRecord();
+            item.RecordCloneLogID = cloneLogId;
+            item.EntityID = md.EntityByName(node.EntityName)?.ID ?? '';
+            item.SourceRecordID = ToRecordKeyString(node.SourceKey);
+            item.TargetRecordID = created ? ToRecordKeyString(created.PrimaryKey) : null;
+            item.Depth = node.Depth;
+            item.Route = node.Route;
+            item.Status = created ? 'Created' : node.Action === 'Reference' ? 'Referenced' : 'Skipped';
+            item.Sequence = sequence++;
+            item.Reason = node.Reason || null;
+            item.FieldChangesJSON = created ? JSON.stringify((node.FieldChanges ?? []).map(MaskSensitiveFieldChange)) : null;
+            if (!(await item.Save())) {
+                throw new Error(`Clone log item for ${nodeKey} not saved: ${item.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+        // B. Record Links (LinkType = 'ClonedFrom'): Source = the new clone, Target = its original.
+        for (const [nodeKey, entity] of stagedEntities.entries()) {
+            const planNode = plan.Nodes.find((n) => (n.NodeKey ?? n.Key) === nodeKey);
+            if (!planNode)
+                continue;
+            const link = await md.GetEntityObject('MJ: Record Links', asUser);
+            link.NewRecord();
+            link.LinkType = 'ClonedFrom';
+            link.SourceEntityID = entity.EntityInfo.ID;
+            link.SourceRecordID = ToRecordKeyString(entity.PrimaryKey ?? planNode.TargetKey);
+            link.TargetEntityID = entity.EntityInfo.ID;
+            link.TargetRecordID = ToRecordKeyString(planNode.SourceKey);
+            link.Metadata = JSON.stringify({ CloneLogID: cloneLogId, Depth: planNode.Depth ?? 0, RootTargetRecordID: rootTargetId });
+            if (!(await link.Save())) {
+                throw new Error(`Record link for ${nodeKey} not saved: ${link.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+        await this.writeAudit(plan, contextUser, true, cloneLogId, rootTargetId, null);
+    }
+    /**
+     * Saves one clone log header. Returns whether it saved; failures are logged, never thrown, so the
+     * failure and refusal paths can call it after a rollback.
+     */
+    async writeLog(plan, contextUser, fields) {
+        const md = this.Provider;
+        if (!md.EntityByName('MJ: Record Clone Logs'))
+            return false;
+        try {
+            const log = await md.GetEntityObject('MJ: Record Clone Logs', await this.provenanceUser(contextUser));
+            log.NewRecord();
+            log.ID = fields.ID;
+            log.Status = fields.Status;
+            log.StartedAt = fields.StartedAt;
+            log.EndedAt = new Date();
+            log.InitiatedByUserID = contextUser?.ID ?? '';
+            log.RootEntityID = md.EntityByName(plan.RootEntityName ?? '')?.ID ?? '';
+            log.RootSourceRecordID = ToRecordKeyString(plan.RootSourceKey) ?? '';
+            log.RootTargetRecordID = fields.RootTargetRecordID ?? null;
+            log.PlanHash = plan.PlanHash || plan.Hash || '';
+            log.PlanJSON = JSON.stringify(MaskSensitivePlan(plan));
+            log.OptionsJSON = JSON.stringify({ Effective: plan.EffectiveOptions, Overrides: plan.Overrides ?? [] });
+            log.ResultJSON = fields.ResultJSON ?? null;
+            log.ErrorMessage = fields.ErrorMessage ?? null;
+            log.Reason = plan.Reason ?? null;
+            log.CreatedCount = fields.CreatedCount ?? 0;
+            log.ReferencedCount = plan.Nodes.filter((n) => n.Action === 'Reference').length;
+            log.SkippedCount = plan.Excluded?.length ?? 0;
+            if (await log.Save())
+                return true;
+            LogError(`[RecordCloning] Clone log ${fields.ID} not saved: ${log.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        catch (err) {
+            LogError(`[RecordCloning] Clone log ${fields.ID} not saved: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return false;
+    }
+    /** One `Record Cloned` audit entry per Execute, as the cloner. Best effort, like all audit logging. */
+    async writeAudit(plan, contextUser, success, cloneLogId, rootTargetId, error) {
+        const md = this.Provider;
+        if (typeof md.CreateAuditLogRecord !== 'function')
+            return;
+        const entity = md.EntityByName(plan.RootEntityName ?? '');
+        if (!entity)
+            return;
+        // Audited when the entity's clone authorization asks for it (every shipped one does).
+        const authorization = new CloneAuthorizer(md).EntityAuthorization(entity);
+        if (authorization?.UseAuditLog !== true)
+            return;
+        const entityId = entity.ID;
+        await md.CreateAuditLogRecord(contextUser, authorization.Name, 'Record Cloned', success ? 'Success' : 'Failed', JSON.stringify({ CloneLogID: cloneLogId, SourceRecordID: ToRecordKeyString(plan.RootSourceKey), TargetRecordID: rootTargetId, Error: error }), entityId, rootTargetId ?? ToRecordKeyString(plan.RootSourceKey), success ? `Cloned ${plan.RootEntityName} ${ToRecordKeyString(plan.RootSourceKey)}` : `Clone of ${plan.RootEntityName} ${ToRecordKeyString(plan.RootSourceKey)} failed`, null);
+    }
+}
+//# sourceMappingURL=CloneExecutor.js.map

package/dist/CloneExecutor.js.map

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

package/dist/CloneKeys.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file CloneKeys.ts
+ * Primary-key handling for record cloning, for single-column and composite keys alike.
+ *
+ * A clone needs a new primary key for every row it creates. How that key is chosen depends on
+ * the entity's key columns:
+ *
+ * - **mint**: a single UUID column (`uniqueidentifier`, or `uuid` on PostgreSQL) that is not itself
+ *   a foreign key. The planner pre-mints a UUID so child rows can point at the copy before saving.
+ * - **server**: a single auto-increment column. The database assigns it on insert; child rows
+ *   reach it through their collection, which stamps the parent key at save time.
+ * - **derived**: everything else, which is a composite key or a natural key. Each key column keeps
+ *   the source row's value, except a column that is a foreign key to a row in the clone, which
+ *   takes that row's new key. A junction row keyed by (UserID, RoleID) under a cloned user
+ *   becomes (newUserID, RoleID). If no column changes, the copy would collide with its source,
+ *   so the planner blocks that node. Two exceptions: a key column pointing at a cloned row whose
+ *   key the database assigns counts as changed (it is left empty and filled at save), and a single
+ *   UUID key that is also a foreign key (an IS-A subtype) whose parent is not in the clone gets a
+ *   freshly minted UUID, because saving the subtype creates its parent row under that same ID.
+ *
+ * Record-id strings use the compact URL-segment form (`CompositeKey.ToCompactURLSegment`): the
+ * bare value for a single-column key, `Field1|Value1||Field2|Value2` for a composite one.
+ *
+ * @see plans/record-cloning/README.md §3.5
+ */
+import { CompositeKey, EntityInfo, KeyValuePair } from '@memberjunction/core';
+import type { CompositeKeyLike } from '@memberjunction/record-cloning-base';
+/**
+ * Builds a CompositeKey from pairs. Assigns `KeyValuePairs` directly because the constructor
+ * drops every pair when the first value is empty (a column the database fills in at save).
+ */
+export declare function KeyFromPairs(pairs: KeyValuePair[]): CompositeKey;
+/** Whether a column holds UUIDs on any supported database (mirrors `EntityFieldInfo.IsUniqueIdentifier`). */
+export declare function IsUuidColumn(field: {
+    Type?: string;
+} | undefined): boolean;
+/** How a clone gets its primary key. */
+export type CloneKeyStrategy = 'mint' | 'server' | 'derived';
+/** Chooses the key strategy for an entity from its primary key columns. */
+export declare function KeyStrategyFor(entity: EntityInfo): CloneKeyStrategy;
+/** Builds a CompositeKey with every primary key column from any key shape the engine carries. */
+export declare function ToCompositeKey(entity: EntityInfo, key: CompositeKeyLike | CompositeKey | string | null | undefined): CompositeKey;
+/** Record-id string for a key: the bare value for one column, the full segment for several. */
+export declare function ToRecordKeyString(key: CompositeKeyLike | CompositeKey | string | null | undefined): string;
+/**
+ * The name of an entity's only primary key column. Foreign keys in MJ always reference a
+ * single-column key, so code that joins a child to its parent or follows a forward FK can rely
+ * on this; it throws with the entity name if the entity somehow has a composite key.
+ */
+export declare function SingleKeyField(entity: EntityInfo, purpose: string): string;
+/** Result of deriving a clone's key from its source key. */
+export interface DerivedKey {
+    Key: CompositeKey;
+    /** Whether at least one column differs from the source; false means the copy would collide. */
+    Changed: boolean;
+}
+/**
+ * Derives a clone's key: each column keeps the source value unless it is a foreign key to a row
+ * in the clone, in which case it takes that row's new key from `keyMap` (entries of the form
+ * `<Entity Name>::<source value>`, falling back to the bare source value). A column pointing at
+ * a cloned row listed in `serverAssigned` (same entry form) is left null and counts as changed:
+ * the collection writes the parent's database-assigned key into it at save time.
+ */
+export declare function DeriveTargetKey(entity: EntityInfo, sourceKey: CompositeKey, keyMap: Record<string, string>, serverAssigned?: ReadonlySet<string>): DerivedKey;
+//# sourceMappingURL=CloneKeys.d.ts.map

package/dist/CloneKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneKeys.d.ts","sourceRoot":"","sources":["../src/CloneKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,CAIhE;AAED,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,OAAO,CAG1E;AAED,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CASnE;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAKjI;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAW1G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,YAAY,CAAC;IAClB,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,cAAc,GAAE,WAAW,CAAC,MAAM,CAAa,GAChD,UAAU,CAmBZ"}

package/dist/CloneKeys.js

@@ -0,0 +1,118 @@
+/**
+ * @file CloneKeys.ts
+ * Primary-key handling for record cloning, for single-column and composite keys alike.
+ *
+ * A clone needs a new primary key for every row it creates. How that key is chosen depends on
+ * the entity's key columns:
+ *
+ * - **mint**: a single UUID column (`uniqueidentifier`, or `uuid` on PostgreSQL) that is not itself
+ *   a foreign key. The planner pre-mints a UUID so child rows can point at the copy before saving.
+ * - **server**: a single auto-increment column. The database assigns it on insert; child rows
+ *   reach it through their collection, which stamps the parent key at save time.
+ * - **derived**: everything else, which is a composite key or a natural key. Each key column keeps
+ *   the source row's value, except a column that is a foreign key to a row in the clone, which
+ *   takes that row's new key. A junction row keyed by (UserID, RoleID) under a cloned user
+ *   becomes (newUserID, RoleID). If no column changes, the copy would collide with its source,
+ *   so the planner blocks that node. Two exceptions: a key column pointing at a cloned row whose
+ *   key the database assigns counts as changed (it is left empty and filled at save), and a single
+ *   UUID key that is also a foreign key (an IS-A subtype) whose parent is not in the clone gets a
+ *   freshly minted UUID, because saving the subtype creates its parent row under that same ID.
+ *
+ * Record-id strings use the compact URL-segment form (`CompositeKey.ToCompactURLSegment`): the
+ * bare value for a single-column key, `Field1|Value1||Field2|Value2` for a composite one.
+ *
+ * @see plans/record-cloning/README.md §3.5
+ */
+import { CompositeKey, KeyValuePair } from '@memberjunction/core';
+/**
+ * Builds a CompositeKey from pairs. Assigns `KeyValuePairs` directly because the constructor
+ * drops every pair when the first value is empty (a column the database fills in at save).
+ */
+export function KeyFromPairs(pairs) {
+    const key = new CompositeKey();
+    key.KeyValuePairs = pairs;
+    return key;
+}
+/** Whether a column holds UUIDs on any supported database (mirrors `EntityFieldInfo.IsUniqueIdentifier`). */
+export function IsUuidColumn(field) {
+    const t = field?.Type?.trim().toLowerCase();
+    return t === 'uniqueidentifier' || t === 'uuid';
+}
+/** Chooses the key strategy for an entity from its primary key columns. */
+export function KeyStrategyFor(entity) {
+    const keys = entity.PrimaryKeys ?? [];
+    if (keys.length === 1) {
+        // Read the column from Fields by name so partial key descriptors still carry type information.
+        const pk = entity.Fields?.find((f) => f.Name.toLowerCase() === keys[0].Name.toLowerCase()) ?? keys[0];
+        if (pk.AutoIncrement)
+            return 'server';
+        if (IsUuidColumn(pk) && !pk.RelatedEntityID)
+            return 'mint';
+    }
+    return 'derived';
+}
+/** Builds a CompositeKey with every primary key column from any key shape the engine carries. */
+export function ToCompositeKey(entity, key) {
+    if (!key)
+        return new CompositeKey();
+    if (key instanceof CompositeKey)
+        return key;
+    if (typeof key === 'string')
+        return CompositeKey.FromURLSegment(entity, key);
+    return KeyFromPairs((key.KeyValuePairs ?? []).map((p) => new KeyValuePair(p.FieldName, p.Value)));
+}
+/** Record-id string for a key: the bare value for one column, the full segment for several. */
+export function ToRecordKeyString(key) {
+    if (!key)
+        return '';
+    if (typeof key === 'string') {
+        if (!key.includes(CompositeKey.DefaultValueDelimiter))
+            return key;
+        // 'ID|abc' or 'A|1||B|2': normalize to the compact form ('abc', or the full segment when composite).
+        const parsed = new CompositeKey();
+        parsed.SimpleLoadFromURLSegment(key);
+        return parsed.KeyValuePairs.length > 0 ? parsed.ToCompactURLSegment() : key;
+    }
+    const ck = key instanceof CompositeKey ? key : KeyFromPairs((key.KeyValuePairs ?? []).map((p) => new KeyValuePair(p.FieldName, p.Value)));
+    return ck.KeyValuePairs.length > 0 ? ck.ToCompactURLSegment() : '';
+}
+/**
+ * The name of an entity's only primary key column. Foreign keys in MJ always reference a
+ * single-column key, so code that joins a child to its parent or follows a forward FK can rely
+ * on this; it throws with the entity name if the entity somehow has a composite key.
+ */
+export function SingleKeyField(entity, purpose) {
+    const keys = entity.PrimaryKeys ?? [];
+    if (keys.length !== 1) {
+        throw new Error(`${purpose}: '${entity.Name}' has a ${keys.length}-column primary key; foreign keys can only reference a single-column key.`);
+    }
+    return keys[0].Name;
+}
+/**
+ * Derives a clone's key: each column keeps the source value unless it is a foreign key to a row
+ * in the clone, in which case it takes that row's new key from `keyMap` (entries of the form
+ * `<Entity Name>::<source value>`, falling back to the bare source value). A column pointing at
+ * a cloned row listed in `serverAssigned` (same entry form) is left null and counts as changed:
+ * the collection writes the parent's database-assigned key into it at save time.
+ */
+export function DeriveTargetKey(entity, sourceKey, keyMap, serverAssigned = new Set()) {
+    let changed = false;
+    const pairs = sourceKey.KeyValuePairs.map((pair) => {
+        const field = entity.Fields.find((f) => f.Name.toLowerCase() === pair.FieldName.toLowerCase());
+        const sourceValue = pair.Value == null ? '' : String(pair.Value);
+        if (field?.RelatedEntity && sourceValue && serverAssigned.has(`${field.RelatedEntity}::${sourceValue}`)) {
+            changed = true;
+            return new KeyValuePair(pair.FieldName, null);
+        }
+        if (field?.RelatedEntity && sourceValue) {
+            const mapped = keyMap[`${field.RelatedEntity}::${sourceValue}`] ?? keyMap[sourceValue];
+            if (mapped !== undefined && mapped !== sourceValue) {
+                changed = true;
+                return new KeyValuePair(pair.FieldName, mapped);
+            }
+        }
+        return new KeyValuePair(pair.FieldName, pair.Value);
+    });
+    return { Key: KeyFromPairs(pairs), Changed: changed };
+}
+//# sourceMappingURL=CloneKeys.js.map

package/dist/CloneKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneKeys.js","sourceRoot":"","sources":["../src/CloneKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAc,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG9E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAqB;IAC9C,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;IAC/B,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC;IAC1B,OAAO,GAAG,CAAC;AACf,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,KAAoC;IAC7D,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,CAAC,KAAK,kBAAkB,IAAI,CAAC,KAAK,MAAM,CAAC;AACpD,CAAC;AAKD,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,+FAA+F;QAC/F,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACtG,IAAI,EAAE,CAAC,aAAa;YAAE,OAAO,QAAQ,CAAC;QACtC,IAAI,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe;YAAE,OAAO,MAAM,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,GAAgE;IAC/G,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,YAAY,EAAE,CAAC;IACpC,IAAI,GAAG,YAAY,YAAY;QAAE,OAAO,GAAG,CAAC;IAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7E,OAAO,YAAY,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,GAAgE;IAC9F,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,qBAAqB,CAAC;YAAE,OAAO,GAAG,CAAC;QAClE,qGAAqG;QACrG,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAChF,CAAC;IACD,MAAM,EAAE,GAAG,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1I,OAAO,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,OAAe;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,MAAM,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,2EAA2E,CAAC,CAAC;IAClJ,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACxB,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC3B,MAAkB,EAClB,SAAuB,EACvB,MAA8B,EAC9B,iBAAsC,IAAI,GAAG,EAAE;IAE/C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/F,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,KAAK,EAAE,aAAa,IAAI,WAAW,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC,EAAE,CAAC;YACtG,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,KAAK,EAAE,aAAa,IAAI,WAAW,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;YACvF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;QACL,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC"}

package/dist/CloneMaterializer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file CloneMaterializer.ts
+ * Builds the in-memory entity graph for record cloning.
+ * Orchestrates collection routing (declared vs dynamic via DeclareRelatedRecordsDynamic),
+ * builds each row from NewRecord() plus the plan's field values, re-stamps join fields,
+ * and handles polymorphic IS-A child additions.
+ * @see plans/record-cloning/README.md §6, §13.1
+ */
+import { BaseEntity, IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { ClonePlan } from '@memberjunction/record-cloning-base';
+export interface MaterializedGraph {
+    RootEntity: BaseEntity;
+    StagedEntities: Map<string, BaseEntity>;
+    SidecarEntities: BaseEntity[];
+    PrerequisiteEntities?: BaseEntity[];
+    /** Plan nodes saved as sidecars although planned in a collection (they point at another new row). */
+    DeferredNodeKeys?: Set<string>;
+}
+export declare class CloneMaterializer {
+    private _provider?;
+    constructor(provider?: IMetadataProvider);
+    protected get Provider(): IMetadataProvider;
+    /**
+     * Materializes a ClonePlan into memory.
+     */
+    Materialize(plan: ClonePlan, contextUser: UserInfo): Promise<MaterializedGraph>;
+    /**
+     * Create rows with a remapped column, other than the join field to their parent, whose new
+     * value is another new row's key: they must save after that row, not inside the graph save.
+     */
+    private static rowsToDefer;
+    /** New rows by their planned key, lower-cased, for matching a remapped column's value. */
+    private static newRowsByTargetKey;
+    /** Plan nodes a row points at through remapped columns other than `joinField`. */
+    private static remappedTargets;
+    /**
+     * Sidecars in an order where each saves after the sidecars it depends on: its parent, when
+     * the parent is a sidecar too, and the new rows its remapped columns point at. Rows saved in
+     * the graph save come first anyway. Stable: independent sidecars keep their planned order.
+     */
+    private static orderSidecars;
+    /**
+     * Resolves an existing writable collection or declares a dynamic one on the parent entity.
+     */
+    private resolveOrCreateCollection;
+    /**
+     * Writes the plan's field values in pipeline order, so later stages (reset, rename, remap,
+     * prompt) win over the copied value. Fields the plan excludes are never set.
+     */
+    private applyFieldChanges;
+}
+//# sourceMappingURL=CloneMaterializer.d.ts.map

package/dist/CloneMaterializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloneMaterializer.d.ts","sourceRoot":"","sources":["../src/CloneMaterializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACH,UAAU,EACV,iBAAiB,EAIjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAmC,MAAM,qCAAqC,CAAC;AAcjG,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC;IACpC,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAoB;gBAEnB,QAAQ,CAAC,EAAE,iBAAiB;IAI/C,SAAS,KAAK,QAAQ,IAAI,iBAAiB,CAE1C;IAED;;OAEG;IACU,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+G5F;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAc1B,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiC5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuCjC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAW5B"}