@memberjunction/core 6.1.0-edge.1 → 6.1.0-edge.3

package/dist/generic/entityConfiguration.d.ts

@@ -0,0 +1,131 @@
+export declare const DEFAULT_AUTO_LEFT_NAV_AT = 8;
+export declare const DEFAULT_PRIMARY_RELATED_BUDGET = 6;
+export declare const RELATED_ROLE_SCORE: {
+    readonly RelatedRecordCollection: 200;
+    readonly CustomDisplayComponent: 150;
+    readonly SameSchema: 100;
+    readonly OneToMany: 50;
+    readonly BeforeFieldTabs: 40;
+    /**
+     * Cap for the inbound-relationship hub boost. A related entity that many
+     * other entities point at (Order Headers) outranks a satellite with two
+     * incoming keys (Task Activities). Applied as `min(cap, 20 * log2(count))`.
+     */
+    readonly InboundHubCap: 120;
+    readonly CreatedByJoin: -90;
+    readonly SatelliteName: -70;
+    readonly PlatformSchema: -80;
+};
+export declare const PLATFORM_SCHEMA_NAME = "__mj";
+export type FormLayout = 'accordion' | 'left-nav' | 'auto';
+export type RelatedRolePolicy = 'keep-all-primary' | 'smart';
+export type FormRole = 'Primary' | 'Detail';
+/** L1 membership on a parent form. None never reaches the ranker. */
+export type FormInclusion = 'Primary' | 'More' | 'None';
+import { IEntityConfiguration, IEntityFormConfiguration } from './JSONType-interfaces/IEntityConfiguration.js';
+import { IEntityFieldConfiguration } from './JSONType-interfaces/IEntityFieldConfiguration.js';
+import { IEntityRelationshipConfiguration } from './JSONType-interfaces/IEntityRelationshipConfiguration.js';
+export * from './JSONType-interfaces/IEntityConfiguration.js';
+export * from './JSONType-interfaces/IEntityFieldConfiguration.js';
+export * from './JSONType-interfaces/IEntityRelationshipConfiguration.js';
+export interface IEntityRelationshipJoin {
+    mode: 'any';
+    fields: string[];
+}
+export type RelatedFormRoleReason = 'explicit-primary' | 'explicit-detail' | 'explicit-none' | 'join-sibling-none' | 'ranked-primary' | 'ranked-detail' | 'keep-all-primary' | 'under-budget' | 'install-primary' | 'install-more' | 'install-none';
+export type FormChromeRuleTargetKind = 'Relationship' | 'Contribution';
+/**
+ * One install-overlay (L3) pin. Loaded from `MJ: Form Chrome Rules`.
+ * Keyed by (parent entity, related entity) or (parent entity, contributionKey).
+ */
+export interface FormChromeRule {
+    EntityID: string;
+    TargetKind: FormChromeRuleTargetKind;
+    RelatedEntityID?: string | null;
+    ContributionKey?: string | null;
+    Inclusion: FormInclusion;
+    JoinFields?: string[] | null;
+    Sequence?: number | null;
+    /**
+     * Admin display title. Null / blank keeps the L1 DisplayName or
+     * humanized entity name. Keyed with the rule, not the previous label,
+     * so an OpenApp upgrade that renames the related entity does not
+     * overwrite a site-specific title.
+     */
+    Title?: string | null;
+}
+export interface RelatedFormRoleCandidate {
+    ID: string;
+    RelatedEntity: string;
+    RelatedEntityID: string;
+    RelatedEntityJoinField: string;
+    RelatedEntitySchemaName: string;
+    DisplayInForm: boolean;
+    DisplayLocation?: 'After Field Tabs' | 'Before Field Tabs' | null;
+    DisplayComponentID?: string | null;
+    RelatedRecordCollection?: string | null;
+    JoinView?: string | null;
+    Type?: string | null;
+    Sequence?: number | null;
+    /**
+     * The relationship's configuration bag, either raw JSON or already parsed.
+     * `EntityRelationshipInfo.Configuration` parses lazily and hands back
+     * {@link IEntityRelationshipConfiguration}, while callers reading straight
+     * from a row still supply the raw string — so both are accepted, matching
+     * what {@link ReadRelationshipInclusion}, {@link ReadRelationshipSortKey}
+     * and {@link ReadRelationshipJoinFields} already take.
+     */
+    Configuration?: string | IEntityRelationshipConfiguration | null;
+    /**
+     * How many EntityRelationships across metadata point at this related
+     * entity. Runtime-only — the ranker uses it as graph in-degree.
+     */
+    InboundRelationshipCount?: number | null;
+}
+export interface RelatedFormRoleAssignment {
+    RelationshipID: string;
+    RelatedEntity: string;
+    RelatedEntityID: string;
+    RelatedEntityJoinField: string;
+    Role: FormRole;
+    Inclusion: FormInclusion;
+    Score: number;
+    Reason: RelatedFormRoleReason;
+    ExplicitFormRole: FormRole | null;
+    ExplicitInclusion: FormInclusion | null;
+    JoinFields: string[] | null;
+}
+export interface RelatedFormRoleResolution {
+    Policy: RelatedRolePolicy;
+    Budget: number;
+    Assignments: RelatedFormRoleAssignment[];
+}
+export declare function ParseEntityConfiguration(raw: string | IEntityConfiguration | null | undefined): IEntityConfiguration | null;
+export declare function ParseEntityRelationshipConfiguration(raw: string | IEntityRelationshipConfiguration | null | undefined): IEntityRelationshipConfiguration | null;
+export declare function ResolveFormLayout(formConfig: IEntityFormConfiguration | null | undefined, firstClassSectionCount: number): Exclude<FormLayout, 'auto'>;
+/**
+ * Read L1 inclusion from a relationship Configuration bag.
+ * `inclusion` wins. `FormRole: 'Detail'` maps to More. `FormRole: 'Primary'` maps to Primary.
+ */
+export declare function ReadRelationshipInclusion(raw: string | IEntityRelationshipConfiguration | null | undefined): FormInclusion | null;
+/** Higher = earlier among first-class related rail items. Omit / invalid = null. */
+export declare function ReadRelationshipSortKey(raw: string | IEntityRelationshipConfiguration | null | undefined): number | null;
+export declare function ReadRelationshipJoinFields(raw: string | IEntityRelationshipConfiguration | null | undefined): string[] | null;
+/**
+ * Score a DisplayInForm relationship for the smart ranker. Explicit inclusion
+ * is not applied here — callers separate the L1 pool first.
+ */
+export declare function ScoreRelatedFormRole(candidate: RelatedFormRoleCandidate, parentSchemaName: string): number;
+export declare function ResolveRelatedFormRoles(parentSchemaName: string, formConfig: IEntityFormConfiguration | null | undefined, candidates: readonly RelatedFormRoleCandidate[]): RelatedFormRoleResolution;
+/**
+ * L3 install overlay. Pins Inclusion / JoinFields on matching relationship
+ * assignments. Later Sequence wins. Contribution rules are applied by the
+ * chrome resolver (they are not ranker assignments).
+ */
+export declare function ApplyFormChromeRules(parentEntityId: string, assignments: readonly RelatedFormRoleAssignment[], rules: readonly FormChromeRule[]): RelatedFormRoleAssignment[];
+export declare function ContributionInclusionFromRules(parentEntityId: string, contributionKey: string, rules: readonly FormChromeRule[]): FormInclusion | null;
+/**
+ * Safely parses an `EntityField.Configuration` JSON string or returns the object.
+ */
+export declare function ParseEntityFieldConfiguration(raw: string | IEntityFieldConfiguration | null | undefined): IEntityFieldConfiguration | null;
+//# sourceMappingURL=entityConfiguration.d.ts.map

package/dist/generic/entityConfiguration.d.ts.map

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

package/dist/generic/entityConfiguration.js

@@ -0,0 +1,346 @@
+/**
+ * Runtime view of `MJ: Entities.Configuration` and
+ * `MJ: Entity Relationships.Configuration`.
+ *
+ * Keep this file in lockstep with:
+ * - `metadata/entities/JSONType-interfaces/IEntityConfiguration.ts`
+ * - `metadata/entities/JSONType-interfaces/IEntityRelationshipConfiguration.ts`
+ *
+ * Those files are CodeGen's source of truth (the generated
+ * `MJEntityEntity_IEntityConfiguration` / ER counterpart). This file is what
+ * `EntityInfo` / the form-chrome ranker consume — `@memberjunction/core` cannot
+ * import the generated entity package.
+ *
+ * NULL / `{}` / omitted keys = accordion until AutoLeftNavAt, then left-nav.
+ * Related-role policy defaults to `'smart'`: a budgeted ranker over Auto
+ * leftovers. L1 `inclusion: 'None'` never enters the ranker.
+ *
+ * @see guides/FORMS_ARCHITECTURE_GUIDE.md §7d
+ */
+import { SafeJSONParse } from '@memberjunction/global';
+export const DEFAULT_AUTO_LEFT_NAV_AT = 8;
+export const DEFAULT_PRIMARY_RELATED_BUDGET = 6;
+export const RELATED_ROLE_SCORE = {
+    RelatedRecordCollection: 200,
+    CustomDisplayComponent: 150,
+    SameSchema: 100,
+    OneToMany: 50,
+    BeforeFieldTabs: 40,
+    /**
+     * Cap for the inbound-relationship hub boost. A related entity that many
+     * other entities point at (Order Headers) outranks a satellite with two
+     * incoming keys (Task Activities). Applied as `min(cap, 20 * log2(count))`.
+     */
+    InboundHubCap: 120,
+    CreatedByJoin: -90,
+    SatelliteName: -70,
+    PlatformSchema: -80,
+};
+export const PLATFORM_SCHEMA_NAME = '__mj';
+export * from './JSONType-interfaces/IEntityConfiguration.js';
+export * from './JSONType-interfaces/IEntityFieldConfiguration.js';
+export * from './JSONType-interfaces/IEntityRelationshipConfiguration.js';
+export function ParseEntityConfiguration(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'object')
+        return raw;
+    if (typeof raw !== 'string' || raw.trim().length === 0)
+        return null;
+    return SafeJSONParse(raw, false) ?? null;
+}
+export function ParseEntityRelationshipConfiguration(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'object')
+        return raw;
+    if (typeof raw !== 'string' || raw.trim().length === 0)
+        return null;
+    return SafeJSONParse(raw, false) ?? null;
+}
+export function ResolveFormLayout(formConfig, firstClassSectionCount) {
+    const layout = formConfig?.Layout ?? 'auto';
+    if (layout === 'accordion' || layout === 'left-nav')
+        return layout;
+    const threshold = formConfig?.AutoLeftNavAt ?? DEFAULT_AUTO_LEFT_NAV_AT;
+    return firstClassSectionCount >= threshold ? 'left-nav' : 'accordion';
+}
+/**
+ * Read L1 inclusion from a relationship Configuration bag.
+ * `inclusion` wins. `FormRole: 'Detail'` maps to More. `FormRole: 'Primary'` maps to Primary.
+ */
+export function ReadRelationshipInclusion(raw) {
+    const parsed = ParseEntityRelationshipConfiguration(raw);
+    const ui = parsed?.UI;
+    if (ui?.inclusion === 'Primary' || ui?.inclusion === 'More' || ui?.inclusion === 'None') {
+        return ui.inclusion;
+    }
+    if (ui?.FormRole === 'Primary')
+        return 'Primary';
+    if (ui?.FormRole === 'Detail')
+        return 'More';
+    return null;
+}
+/** Higher = earlier among first-class related rail items. Omit / invalid = null. */
+export function ReadRelationshipSortKey(raw) {
+    const sort = ParseEntityRelationshipConfiguration(raw)?.UI?.sortKey;
+    if (typeof sort !== 'number' || !Number.isFinite(sort))
+        return null;
+    return sort;
+}
+export function ReadRelationshipJoinFields(raw) {
+    const fields = ParseEntityRelationshipConfiguration(raw)?.UI?.join?.fields;
+    if (!fields || fields.length === 0)
+        return null;
+    const cleaned = fields.map((f) => f.trim()).filter((f) => f.length > 0);
+    return cleaned.length > 0 ? cleaned : null;
+}
+/**
+ * Score a DisplayInForm relationship for the smart ranker. Explicit inclusion
+ * is not applied here — callers separate the L1 pool first.
+ */
+export function ScoreRelatedFormRole(candidate, parentSchemaName) {
+    let score = 0;
+    if (hasText(candidate.RelatedRecordCollection)) {
+        score += RELATED_ROLE_SCORE.RelatedRecordCollection;
+    }
+    if (hasText(candidate.DisplayComponentID)) {
+        score += RELATED_ROLE_SCORE.CustomDisplayComponent;
+    }
+    if (schemasEqual(candidate.RelatedEntitySchemaName, parentSchemaName)) {
+        score += RELATED_ROLE_SCORE.SameSchema;
+    }
+    if (isOneToMany(candidate)) {
+        score += RELATED_ROLE_SCORE.OneToMany;
+    }
+    if (candidate.DisplayLocation === 'Before Field Tabs') {
+        score += RELATED_ROLE_SCORE.BeforeFieldTabs;
+    }
+    score += inboundHubBoost(candidate.InboundRelationshipCount);
+    score += createdByJoinPenalty(candidate.RelatedEntityJoinField);
+    score += satelliteNamePenalty(candidate.RelatedEntity);
+    if (isPlatformSchema(candidate.RelatedEntitySchemaName) && !isPlatformSchema(parentSchemaName)) {
+        score += RELATED_ROLE_SCORE.PlatformSchema;
+    }
+    return score;
+}
+export function ResolveRelatedFormRoles(parentSchemaName, formConfig, candidates) {
+    const policy = formConfig?.RelatedRolePolicy ?? 'smart';
+    const budget = resolveBudget(formConfig?.PrimaryRelatedBudget);
+    const visible = candidates.filter((c) => c.DisplayInForm);
+    const assignments = [];
+    const untagged = [];
+    const joinSiblingNone = impliedJoinSiblingNoneIds(visible);
+    for (const candidate of visible) {
+        const explicit = ReadRelationshipInclusion(candidate.Configuration);
+        const inclusion = explicit ?? (joinSiblingNone.has(candidate.ID) ? 'None' : null);
+        const score = ScoreRelatedFormRole(candidate, parentSchemaName);
+        if (inclusion === 'None') {
+            const reason = explicit === 'None' ? 'explicit-none' : 'join-sibling-none';
+            assignments.push(toAssignment(candidate, 'Detail', 'None', score, reason, explicit));
+            continue;
+        }
+        if (inclusion === 'Primary') {
+            assignments.push(toAssignment(candidate, 'Primary', 'Primary', score, 'explicit-primary', inclusion));
+            continue;
+        }
+        if (inclusion === 'More') {
+            assignments.push(toAssignment(candidate, 'Detail', 'More', score, 'explicit-detail', inclusion));
+            continue;
+        }
+        untagged.push({ candidate, score });
+    }
+    if (policy === 'keep-all-primary') {
+        for (const item of untagged) {
+            assignments.push(toAssignment(item.candidate, 'Primary', 'Primary', item.score, 'keep-all-primary', null));
+        }
+        return { Policy: policy, Budget: budget, Assignments: sortAssignments(assignments) };
+    }
+    if (untagged.length <= budget) {
+        for (const item of untagged) {
+            assignments.push(toAssignment(item.candidate, 'Primary', 'Primary', item.score, 'under-budget', null));
+        }
+        return { Policy: policy, Budget: budget, Assignments: sortAssignments(assignments) };
+    }
+    const ranked = [...untagged].sort(compareUntagged);
+    ranked.forEach((item, index) => {
+        const isPrimary = index < budget;
+        assignments.push(toAssignment(item.candidate, isPrimary ? 'Primary' : 'Detail', isPrimary ? 'Primary' : 'More', item.score, isPrimary ? 'ranked-primary' : 'ranked-detail', null));
+    });
+    return { Policy: policy, Budget: budget, Assignments: sortAssignments(assignments) };
+}
+function resolveBudget(raw) {
+    if (raw == null || !Number.isFinite(raw))
+        return DEFAULT_PRIMARY_RELATED_BUDGET;
+    return Math.max(0, Math.floor(raw));
+}
+function toAssignment(candidate, role, inclusion, score, reason, explicitInclusion) {
+    const explicitRole = explicitInclusion === 'Primary' ? 'Primary'
+        : explicitInclusion === 'More' ? 'Detail'
+            : null;
+    return {
+        RelationshipID: candidate.ID,
+        RelatedEntity: candidate.RelatedEntity,
+        RelatedEntityID: candidate.RelatedEntityID,
+        RelatedEntityJoinField: candidate.RelatedEntityJoinField,
+        Role: role,
+        Inclusion: inclusion,
+        Score: score,
+        Reason: reason,
+        ExplicitFormRole: explicitRole,
+        ExplicitInclusion: explicitInclusion,
+        JoinFields: ReadRelationshipJoinFields(candidate.Configuration),
+    };
+}
+/**
+ * When one relationship to a related entity carries `join.fields`, sibling
+ * FKs to that same entity with no explicit inclusion are not candidates.
+ */
+function impliedJoinSiblingNoneIds(candidates) {
+    const ownerKeys = new Set();
+    for (const candidate of candidates) {
+        if (ReadRelationshipJoinFields(candidate.Configuration)) {
+            ownerKeys.add(relatedEntityKey(candidate));
+        }
+    }
+    const noneIds = new Set();
+    if (ownerKeys.size === 0)
+        return noneIds;
+    for (const candidate of candidates) {
+        if (!ownerKeys.has(relatedEntityKey(candidate)))
+            continue;
+        if (ReadRelationshipInclusion(candidate.Configuration) != null)
+            continue;
+        if (ReadRelationshipJoinFields(candidate.Configuration))
+            continue;
+        noneIds.add(candidate.ID);
+    }
+    return noneIds;
+}
+function relatedEntityKey(candidate) {
+    const id = (candidate.RelatedEntityID ?? '').trim().toLowerCase();
+    if (id.length > 0)
+        return id;
+    return (candidate.RelatedEntity ?? '').trim().toLowerCase();
+}
+/**
+ * L3 install overlay. Pins Inclusion / JoinFields on matching relationship
+ * assignments. Later Sequence wins. Contribution rules are applied by the
+ * chrome resolver (they are not ranker assignments).
+ */
+export function ApplyFormChromeRules(parentEntityId, assignments, rules) {
+    const parent = parentEntityId.trim().toLowerCase();
+    if (parent.length === 0 || rules.length === 0)
+        return [...assignments];
+    const applicable = rules
+        .filter((rule) => rule.TargetKind === 'Relationship' && idsEqual(rule.EntityID, parent))
+        .sort((a, b) => (a.Sequence ?? 0) - (b.Sequence ?? 0));
+    if (applicable.length === 0)
+        return [...assignments];
+    return assignments.map((assignment) => {
+        const rule = lastMatchingRelationshipRule(applicable, assignment);
+        return rule ? applyRelationshipRule(assignment, rule) : assignment;
+    });
+}
+export function ContributionInclusionFromRules(parentEntityId, contributionKey, rules) {
+    const parent = parentEntityId.trim().toLowerCase();
+    const key = contributionKey.trim().toLowerCase();
+    if (parent.length === 0 || key.length === 0)
+        return null;
+    const matches = rules
+        .filter((rule) => rule.TargetKind === 'Contribution'
+        && idsEqual(rule.EntityID, parent)
+        && (rule.ContributionKey ?? '').trim().toLowerCase() === key)
+        .sort((a, b) => (a.Sequence ?? 0) - (b.Sequence ?? 0));
+    return matches.at(-1)?.Inclusion ?? null;
+}
+function lastMatchingRelationshipRule(rules, assignment) {
+    const matches = rules.filter((rule) => idsEqual(rule.RelatedEntityID, assignment.RelatedEntityID));
+    return matches.at(-1);
+}
+function applyRelationshipRule(assignment, rule) {
+    const inclusion = rule.Inclusion;
+    const role = inclusion === 'Primary' ? 'Primary' : 'Detail';
+    const reason = inclusion === 'Primary' ? 'install-primary'
+        : inclusion === 'More' ? 'install-more'
+            : 'install-none';
+    const join = rule.JoinFields && rule.JoinFields.length > 0
+        ? rule.JoinFields
+        : assignment.JoinFields;
+    return { ...assignment, Role: role, Inclusion: inclusion, Reason: reason, JoinFields: join };
+}
+function idsEqual(a, b) {
+    return (a ?? '').trim().toLowerCase() === (b ?? '').trim().toLowerCase()
+        && (a ?? '').trim().length > 0;
+}
+function sortAssignments(assignments) {
+    return [...assignments].sort((a, b) => {
+        if (b.Score !== a.Score)
+            return b.Score - a.Score;
+        return a.RelatedEntity.localeCompare(b.RelatedEntity);
+    });
+}
+function compareUntagged(a, b) {
+    if (b.score !== a.score)
+        return b.score - a.score;
+    const aSeq = effectiveSequence(a.candidate.Sequence);
+    const bSeq = effectiveSequence(b.candidate.Sequence);
+    if (aSeq !== bSeq)
+        return aSeq - bSeq;
+    return a.candidate.RelatedEntity.localeCompare(b.candidate.RelatedEntity);
+}
+function isOneToMany(candidate) {
+    if (hasText(candidate.JoinView))
+        return false;
+    const type = (candidate.Type ?? '').trim().toUpperCase();
+    if (type.length === 0)
+        return true;
+    return type === 'ONE TO MANY';
+}
+function inboundHubBoost(count) {
+    if (count == null || count <= 2)
+        return 0;
+    return Math.min(RELATED_ROLE_SCORE.InboundHubCap, Math.round(20 * Math.log2(count)));
+}
+function createdByJoinPenalty(joinField) {
+    const field = (joinField ?? '').trim();
+    if (/^(CreatedBy|UpdatedBy|DeletedBy|OwnedBy)/i.test(field)) {
+        return RELATED_ROLE_SCORE.CreatedByJoin;
+    }
+    return 0;
+}
+function satelliteNamePenalty(relatedEntity) {
+    const name = (relatedEntity ?? '').toLowerCase();
+    if (/(activit|comment|log|notification|exemption|intent|assignment|dependenc|decision|tag link|stored value|payment method|entitlement|promotion code)/.test(name)) {
+        return RELATED_ROLE_SCORE.SatelliteName;
+    }
+    return 0;
+}
+function effectiveSequence(sequence) {
+    if (sequence == null || sequence === 0)
+        return 999;
+    return sequence;
+}
+function isPlatformSchema(schemaName) {
+    return (schemaName ?? '').trim().toLowerCase() === PLATFORM_SCHEMA_NAME;
+}
+function schemasEqual(a, b) {
+    return (a ?? '').trim().toLowerCase() === (b ?? '').trim().toLowerCase()
+        && (a ?? '').trim().length > 0;
+}
+function hasText(value) {
+    return value != null && value.trim().length > 0;
+}
+/**
+ * Safely parses an `EntityField.Configuration` JSON string or returns the object.
+ */
+export function ParseEntityFieldConfiguration(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'object')
+        return raw;
+    if (typeof raw !== 'string' || raw.trim().length === 0)
+        return null;
+    return SafeJSONParse(raw, false) ?? null;
+}
+//# sourceMappingURL=entityConfiguration.js.map

package/dist/generic/entityConfiguration.js.map

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