@memberjunction/core-entities 6.2.0-edge.2 → 6.2.0-edge.3

package/dist/engines/interactive-forms.d.ts

@@ -1,6 +1,7 @@
-import { BaseEngine, IMetadataProvider, UserInfo } from "@memberjunction/core";
+import { BaseEngine, IMetadataProvider, UserInfo, type BaseEntityEvent } from "@memberjunction/core";
 import type { Observable } from "rxjs";
-import type { MJComponentEntity, MJEntityFormOverrideEntity } from "../generated/entity_subclasses.js";
+import type { MJComponentEntity, MJEntityFormContributionEntity, MJEntityFormOverrideEntity } from "../generated/entity_subclasses.js";
+import type { InstanceConfigEngine } from "./InstanceConfigEngine.js";
 /**
  * Cache of MemberJunction interactive-form metadata: the form-role
  * `MJ: Components` rows and their `MJ: Entity Form Overrides`. Designed
@@ -24,12 +25,22 @@ import type { MJComponentEntity, MJEntityFormOverrideEntity } from "../generated
  *      because the full Component table includes ~150MB of `Specification`
  *      JSON across non-form types (Skip artifacts, dashboards, etc.).
  *
- * This engine threads the needle: load `Type='Form'` Components only
- * (small dataset — a few dozen per typical deployment, ~5MB max) plus
- * **all** `EntityFormOverride` rows (tiny). Specification is included
- * because the cockpit + Skip rendering both need it. Loaded as
- * `entity_object` so callers can call `.Save()` / `.Delete()` on the
- * cached instances directly.
+ * This engine threads the needle: it loads `Type='Form'` Components (small
+ * dataset — a few dozen per typical deployment, ~5MB max), the
+ * `EntityFormOverride` rows (tiny) and, unless metadata contributions are
+ * switched off, the `MJ: Entity Form Contributions` rows. In the browser it
+ * loads the shared overrides and contributions and the signed-in user's own;
+ * on a server it loads every row. Specification is included because
+ * the cockpit + Skip rendering both need it. Loaded as `entity_object` so
+ * callers can call `.Save()` / `.Delete()` on the cached instances directly.
+ *
+ * It deliberately does NOT load `Type='Widget'` rows: `Widget` is an open set
+ * grown by registry sync and general authoring, unrelated to form-panel
+ * adoption, and this cache is written to client local storage on every boot.
+ * The widget a contribution renders is fetched by ID on first use
+ * ({@link InteractiveFormsEngine.GetComponentByID}) and kept in memory until any
+ * `MJ: Components` row is saved, deleted or changed on another server, so each
+ * distinct panel component costs one query, not one per mount.
  *
  * ## Reactivity for free
  *
@@ -73,13 +84,57 @@ import type { MJComponentEntity, MJEntityFormOverrideEntity } from "../generated
 export declare class InteractiveFormsEngine extends BaseEngine<InteractiveFormsEngine> {
     /** Standard singleton accessor — never construct directly. */
     static get Instance(): InteractiveFormsEngine;
+    /**
+     * Instance-level kill switch for metadata-registered form contributions.
+     *
+     * When false the engine loads no contribution rows and keeps the Components filter
+     * narrow, so every consumer sees exactly the pre-feature behavior: compiled
+     * `BaseFormPanel` registrations only. This is the rollback path for a bad load or a
+     * misbehaving panel — no migration, no deployment of a code change.
+     *
+     * Seeded from `MJ_FORMS_METADATA_CONTRIBUTIONS=false` where an environment exists
+     * (server, CLI). The browser has no environment: the Explorer shell calls
+     * {@link ApplyInstanceConfiguration} after Instance Config loads and before any form opens, and
+     * another browser host can do the same or set this directly before the first `Config()`.
+     */
+    private static _metadataContributionsEnabled;
+    /** The `MJ: Instance Configurations` key that turns metadata contributions off in the browser. */
+    static readonly MetadataContributionsConfigKey = "Forms.MetadataContributions.Enabled";
+    static get MetadataContributionsEnabled(): boolean;
+    static set MetadataContributionsEnabled(value: boolean);
+    /**
+     * Turns metadata contributions off when the instance configuration
+     * ({@link MetadataContributionsConfigKey}) is `false`. A missing key leaves the switch as it is,
+     * and a `true` never turns back on a switch that is already off.
+     *
+     * Call it after `InstanceConfigEngine.Config()` has finished and before the first form opens.
+     * Before Instance Config has loaded, or when it fails to load, the key reads as missing and
+     * the switch stays on.
+     */
+    static ApplyInstanceConfiguration(config: Pick<InstanceConfigEngine, 'GetBoolean'>): void;
+    private static readContributionsFlag;
     private _forms;
     private _overrides;
+    private _contributions;
+    /** Components fetched by {@link GetComponentByID}, by normalized ID. */
+    private _componentsByID;
+    /** Lookups in flight, by normalized ID, so panels that mount together share one query. */
+    private _componentLookups;
+    private _componentInvalidationSubscribed;
     /**
      * Lazy-load the form Component + override caches. Safe to call from
      * every entry point — no-op if already loaded (unless `forceRefresh`).
      */
     Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
+    /**
+     * The filter for the override and contribution loads: in the browser, every shared row plus
+     * the signed-in user's own personal rows; on a server, none.
+     *
+     * A browser cache holds one user's view, so other users' personal rows (with their Notes and
+     * Configuration) stay on the server. A server cache is shared by every user of the process,
+     * so it holds every row and each reader filters what it serves.
+     */
+    private static personalRowsLoadFilter;
     /** All cached form-role Components. */
     get Forms(): MJComponentEntity[];
     /** All cached EntityFormOverride rows (all scopes — caller filters). */
@@ -106,12 +161,76 @@ export declare class InteractiveFormsEngine extends BaseEngine<InteractiveFormsE
      * the resolver-style lookup that considers all scopes.
      */
     GetUserOverrides(userID: string): MJEntityFormOverrideEntity[];
+    /**
+     * All cached EntityFormContribution rows (all scopes, all statuses — callers filter).
+     *
+     * Returns nothing while the kill switch is off. Dropping the entity from the load list is
+     * not enough on its own: a process that already loaded rows would keep serving them from
+     * the engine's data map, so the switch would appear to do nothing until a restart. The
+     * rollback path has to work in the process that is misbehaving.
+     */
+    get Contributions(): MJEntityFormContributionEntity[];
+    /** Emits on every save / delete / remote-invalidate that touches `MJ: Entity Form Contributions`. */
+    get Contributions$(): Observable<MJEntityFormContributionEntity[]>;
+    /**
+     * True once the contribution cache has completed its first load.
+     *
+     * Slot hosts wait on this before the first mount: rendering compiled contributions and
+     * then adding rows a tick later is visible, and for a `bare` hero that replaces a baked
+     * section it means the user watches the Details panel render and then disappear.
+     */
+    get ContributionsReady(): boolean;
+    /**
+     * Active contribution rows that apply to (entity, user, roles): User rows for this
+     * user, Role rows for any of the user's roles, and Global rows. Sorted by
+     * `Precedence` DESC then `SortKey` DESC. Last-wins collapse against compiled
+     * registrations happens in ng-base-forms, not here.
+     *
+     * On an identity or permission entity only the user's own rows apply
+     * ({@link FormScopeAllowedOnEntity}). The clamp is applied here, on the read path, because
+     * `mj sync` — the path an OpenApp actually uses — and direct SQL bypass the actions.
+     */
+    GetApplicableContributions(entityID: string, userID: string, roleIDs: ReadonlyArray<string>): MJEntityFormContributionEntity[];
+    /**
+     * A form from the loaded forms, or a widget {@link GetComponentByID} has already fetched.
+     * Undefined for a widget not fetched yet.
+     */
+    FindComponentByID(id: string): MJComponentEntity | undefined;
+    /**
+     * Any Component by ID: a whole form from the loaded forms, otherwise one query by ID, kept in
+     * memory for the next caller. Panels that ask at the same time share one query. A failed or
+     * empty lookup is not kept, so the next caller tries again. Every kept component is dropped
+     * when any `MJ: Components` row is saved, deleted or changed on another server.
+     *
+     * @returns The component, or null when it does not exist or the lookup failed.
+     */
+    GetComponentByID(id: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<MJComponentEntity | null>;
+    /** Drops every component {@link GetComponentByID} kept. */
+    ClearComponentCache(): void;
+    private queryComponentByID;
+    /**
+     * A save of any `MJ: Components` row, and a change to one on another server, refreshes the
+     * forms array (a widget is not in it, so the save is not applied in place), and that emission
+     * drops what {@link GetComponentByID} kept. A delete of a row outside the array changes no
+     * array; {@link HandleIndividualBaseEntityEvent} covers it. Subscribed before anything is
+     * kept, so the replay on subscribe clears nothing.
+     */
+    private subscribeComponentInvalidation;
+    /**
+     * Drops what {@link GetComponentByID} kept when an `MJ: Components` row is deleted, here or on
+     * another server, then handles the event as every engine does. BaseEngine ignores a delete of a
+     * row that is not in a loaded array, which a fetched widget never is.
+     */
+    protected HandleIndividualBaseEntityEvent(event: BaseEntityEvent): Promise<boolean>;
+    private static isComponentDelete;
     /**
      * Resolver-style lookup matching the runtime form-resolver's scope
      * priority: User > Role > Global. Returns the highest-priority
      * Active override for the given (entity, user, roles) tuple, or null
      * if none match. Within the same scope, lower `Priority` wins (the
-     * resolver convention — Priority is sort key, not boost).
+     * resolver convention — Priority is sort key, not boost). On an identity
+     * or permission entity only the user's own forms count
+     * ({@link FormScopeAllowedOnEntity}).
      *
      * @param entityID The target `MJ: Entities.ID`.
      * @param userID The current user's `MJ: Users.ID`.

package/dist/engines/interactive-forms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-forms.d.ts","sourceRoot":"","sources":["../../src/engines/interactive-forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAC1E,8DAA8D;IAC9D,WAAkB,QAAQ,IAAI,sBAAsB,CAEnD;IAED,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAoC;IAEtD;;;OAGG;IACU,MAAM,CACf,YAAY,CAAC,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAqBhB,uCAAuC;IACvC,IAAW,KAAK,IAAI,iBAAiB,EAAE,CAEtC;IAED,wEAAwE;IACxE,IAAW,SAAS,IAAI,0BAA0B,EAAE,CAEnD;IAED;;;;;;;;;;;OAWG;IACH,IAAW,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAEnD;IAED,qFAAqF;IACrF,IAAW,UAAU,IAAI,UAAU,CAAC,0BAA0B,EAAE,CAAC,CAEhE;IAID;;;;;OAKG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,0BAA0B,EAAE;IAOrE;;;;;;;;;;OAUG;IACI,0BAA0B,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAC/B,0BAA0B,GAAG,IAAI;IA4BpC;;;;OAIG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQ1D,uFAAuF;IAChF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAM9D,+CAA+C;IACxC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;CAK9E"}
+{"version":3,"file":"interactive-forms.d.ts","sourceRoot":"","sources":["../../src/engines/interactive-forms.ts"],"names":[],"mappings":"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"}

package/dist/engines/interactive-forms.js

@@ -1,5 +1,6 @@
-import { BaseEngine } from "@memberjunction/core";
-import { NormalizeUUID, UUIDsEqual } from "@memberjunction/global";
+import { BaseEngine, LogError, ProviderType, RunView } from "@memberjunction/core";
+import { EscapeSQLString, NormalizeUUID, UUIDsEqual } from "@memberjunction/global";
+import { FormScopeAllowedOnEntity } from "../custom/FormScope/FormScopeRules.js";
 /**
  * Cache of MemberJunction interactive-form metadata: the form-role
  * `MJ: Components` rows and their `MJ: Entity Form Overrides`. Designed
@@ -23,12 +24,22 @@ import { NormalizeUUID, UUIDsEqual } from "@memberjunction/global";
  *      because the full Component table includes ~150MB of `Specification`
  *      JSON across non-form types (Skip artifacts, dashboards, etc.).
  *
- * This engine threads the needle: load `Type='Form'` Components only
- * (small dataset — a few dozen per typical deployment, ~5MB max) plus
- * **all** `EntityFormOverride` rows (tiny). Specification is included
- * because the cockpit + Skip rendering both need it. Loaded as
- * `entity_object` so callers can call `.Save()` / `.Delete()` on the
- * cached instances directly.
+ * This engine threads the needle: it loads `Type='Form'` Components (small
+ * dataset — a few dozen per typical deployment, ~5MB max), the
+ * `EntityFormOverride` rows (tiny) and, unless metadata contributions are
+ * switched off, the `MJ: Entity Form Contributions` rows. In the browser it
+ * loads the shared overrides and contributions and the signed-in user's own;
+ * on a server it loads every row. Specification is included because
+ * the cockpit + Skip rendering both need it. Loaded as `entity_object` so
+ * callers can call `.Save()` / `.Delete()` on the cached instances directly.
+ *
+ * It deliberately does NOT load `Type='Widget'` rows: `Widget` is an open set
+ * grown by registry sync and general authoring, unrelated to form-panel
+ * adoption, and this cache is written to client local storage on every boot.
+ * The widget a contribution renders is fetched by ID on first use
+ * ({@link InteractiveFormsEngine.GetComponentByID}) and kept in memory until any
+ * `MJ: Components` row is saved, deleted or changed on another server, so each
+ * distinct panel component costs one query, not one per mount.
  *
  * ## Reactivity for free
  *
@@ -74,33 +85,124 @@ export class InteractiveFormsEngine extends BaseEngine {
         super(...arguments);
         this._forms = [];
         this._overrides = [];
+        this._contributions = [];
+        /** Components fetched by {@link GetComponentByID}, by normalized ID. */
+        this._componentsByID = new Map();
+        /** Lookups in flight, by normalized ID, so panels that mount together share one query. */
+        this._componentLookups = new Map();
+        this._componentInvalidationSubscribed = false;
     }
     /** Standard singleton accessor — never construct directly. */
     static get Instance() {
         return super.getInstance();
     }
+    /**
+     * Instance-level kill switch for metadata-registered form contributions.
+     *
+     * When false the engine loads no contribution rows and keeps the Components filter
+     * narrow, so every consumer sees exactly the pre-feature behavior: compiled
+     * `BaseFormPanel` registrations only. This is the rollback path for a bad load or a
+     * misbehaving panel — no migration, no deployment of a code change.
+     *
+     * Seeded from `MJ_FORMS_METADATA_CONTRIBUTIONS=false` where an environment exists
+     * (server, CLI). The browser has no environment: the Explorer shell calls
+     * {@link ApplyInstanceConfiguration} after Instance Config loads and before any form opens, and
+     * another browser host can do the same or set this directly before the first `Config()`.
+     */
+    static { this._metadataContributionsEnabled = InteractiveFormsEngine.readContributionsFlag(); }
+    /** The `MJ: Instance Configurations` key that turns metadata contributions off in the browser. */
+    static { this.MetadataContributionsConfigKey = 'Forms.MetadataContributions.Enabled'; }
+    static get MetadataContributionsEnabled() {
+        return InteractiveFormsEngine._metadataContributionsEnabled;
+    }
+    static set MetadataContributionsEnabled(value) {
+        InteractiveFormsEngine._metadataContributionsEnabled = value;
+    }
+    /**
+     * Turns metadata contributions off when the instance configuration
+     * ({@link MetadataContributionsConfigKey}) is `false`. A missing key leaves the switch as it is,
+     * and a `true` never turns back on a switch that is already off.
+     *
+     * Call it after `InstanceConfigEngine.Config()` has finished and before the first form opens.
+     * Before Instance Config has loaded, or when it fails to load, the key reads as missing and
+     * the switch stays on.
+     */
+    static ApplyInstanceConfiguration(config) {
+        if (!config.GetBoolean(InteractiveFormsEngine.MetadataContributionsConfigKey, true)) {
+            InteractiveFormsEngine.MetadataContributionsEnabled = false;
+        }
+    }
+    static readContributionsFlag() {
+        // Guarded: this class runs in the browser too, where `process` does not exist.
+        const env = typeof process !== 'undefined' ? process?.env?.MJ_FORMS_METADATA_CONTRIBUTIONS : undefined;
+        if (env === undefined || env === null || env.trim().length === 0)
+            return true;
+        const v = env.trim().toLowerCase();
+        return !(v === 'false' || v === '0' || v === 'off' || v === 'no');
+    }
     /**
      * Lazy-load the form Component + override caches. Safe to call from
      * every entry point — no-op if already loaded (unless `forceRefresh`).
      */
     async Config(forceRefresh, contextUser, provider) {
+        const contributionsEnabled = InteractiveFormsEngine.MetadataContributionsEnabled;
+        const personalRowsFilter = InteractiveFormsEngine.personalRowsLoadFilter(provider ?? this.ProviderToUse, contextUser);
+        const overrides = {
+            Type: 'entity',
+            EntityName: 'MJ: Entity Form Overrides',
+            PropertyName: '_overrides',
+            CacheLocal: true,
+        };
+        if (personalRowsFilter)
+            overrides.Filter = personalRowsFilter;
         const c = [
             {
                 Type: 'entity',
                 EntityName: 'MJ: Components',
                 PropertyName: '_forms',
+                // Whole forms only — deliberately NOT widened to all widgets: `Widget` is an
+                // open set grown by registry sync and general authoring, and this cache is
+                // written to client local storage on every boot.
+                //
+                // A contribution's panel Component (Type='Widget') is therefore NOT in this
+                // cache; `GetComponentByID` fetches it by ID on first use. The filter takes no
+                // subquery over `vwEntityFormContributions`: a view name resolves against the
+                // connecting user's default schema rather than the core schema, and a filter
+                // that fails takes the WHOLE engine down with it, so every form would wait on a
+                // cache that never loads. Fetching exactly the components that render, lazily,
+                // needs no cross-schema SQL at all.
                 Filter: "Type='Form'",
                 CacheLocal: true,
             },
-            {
+            overrides,
+        ];
+        if (contributionsEnabled) {
+            const contributions = {
                 Type: 'entity',
-                EntityName: 'MJ: Entity Form Overrides',
-                PropertyName: '_overrides',
+                EntityName: 'MJ: Entity Form Contributions',
+                PropertyName: '_contributions',
                 CacheLocal: true,
-            },
-        ];
+            };
+            if (personalRowsFilter)
+                contributions.Filter = personalRowsFilter;
+            c.push(contributions);
+        }
         await this.Load(c, provider, forceRefresh, contextUser);
     }
+    /**
+     * The filter for the override and contribution loads: in the browser, every shared row plus
+     * the signed-in user's own personal rows; on a server, none.
+     *
+     * A browser cache holds one user's view, so other users' personal rows (with their Notes and
+     * Configuration) stay on the server. A server cache is shared by every user of the process,
+     * so it holds every row and each reader filters what it serves.
+     */
+    static personalRowsLoadFilter(provider, contextUser) {
+        if (!provider || provider.ProviderType === ProviderType.Database)
+            return null;
+        const userID = (contextUser ?? provider.CurrentUser)?.ID;
+        return userID ? `Scope <> 'User' OR UserID = '${EscapeSQLString(userID)}'` : null;
+    }
     // ─── Read-side accessors ────────────────────────────────────────────────
     /** All cached form-role Components. */
     get Forms() {
@@ -141,12 +243,163 @@ export class InteractiveFormsEngine extends BaseEngine {
             return [];
         return this.Overrides.filter(o => o.Scope === 'User' && o.UserID && UUIDsEqual(o.UserID, userID));
     }
+    /**
+     * All cached EntityFormContribution rows (all scopes, all statuses — callers filter).
+     *
+     * Returns nothing while the kill switch is off. Dropping the entity from the load list is
+     * not enough on its own: a process that already loaded rows would keep serving them from
+     * the engine's data map, so the switch would appear to do nothing until a restart. The
+     * rollback path has to work in the process that is misbehaving.
+     */
+    get Contributions() {
+        if (!InteractiveFormsEngine.MetadataContributionsEnabled)
+            return [];
+        return this.GetConfigData('_contributions');
+    }
+    /** Emits on every save / delete / remote-invalidate that touches `MJ: Entity Form Contributions`. */
+    get Contributions$() {
+        return this.ObserveProperty('_contributions');
+    }
+    /**
+     * True once the contribution cache has completed its first load.
+     *
+     * Slot hosts wait on this before the first mount: rendering compiled contributions and
+     * then adding rows a tick later is visible, and for a `bare` hero that replaces a baked
+     * section it means the user watches the Details panel render and then disappear.
+     */
+    get ContributionsReady() {
+        return this.Loaded || this.IsPermissionConstrained;
+    }
+    /**
+     * Active contribution rows that apply to (entity, user, roles): User rows for this
+     * user, Role rows for any of the user's roles, and Global rows. Sorted by
+     * `Precedence` DESC then `SortKey` DESC. Last-wins collapse against compiled
+     * registrations happens in ng-base-forms, not here.
+     *
+     * On an identity or permission entity only the user's own rows apply
+     * ({@link FormScopeAllowedOnEntity}). The clamp is applied here, on the read path, because
+     * `mj sync` — the path an OpenApp actually uses — and direct SQL bypass the actions.
+     */
+    GetApplicableContributions(entityID, userID, roleIDs) {
+        if (!entityID)
+            return [];
+        const rows = this.Contributions.filter(c => c.EntityID && UUIDsEqual(c.EntityID, entityID)
+            && c.Status === 'Active'
+            && FormScopeAllowedOnEntity(c.Entity, c.Scope)
+            && ((c.Scope === 'User' && !!c.UserID && !!userID && UUIDsEqual(c.UserID, userID)) ||
+                (c.Scope === 'Role' && !!c.RoleID && roleIDs.some(r => UUIDsEqual(r, c.RoleID))) ||
+                (c.Scope === 'Global')));
+        return rows.sort((a, b) => {
+            const p = (b.Precedence ?? 0) - (a.Precedence ?? 0);
+            if (p !== 0)
+                return p;
+            return (b.SortKey ?? 0) - (a.SortKey ?? 0);
+        });
+    }
+    /**
+     * A form from the loaded forms, or a widget {@link GetComponentByID} has already fetched.
+     * Undefined for a widget not fetched yet.
+     */
+    FindComponentByID(id) {
+        if (!id)
+            return undefined;
+        return this.FindFormByID(id) ?? this._componentsByID.get(NormalizeUUID(id));
+    }
+    /**
+     * Any Component by ID: a whole form from the loaded forms, otherwise one query by ID, kept in
+     * memory for the next caller. Panels that ask at the same time share one query. A failed or
+     * empty lookup is not kept, so the next caller tries again. Every kept component is dropped
+     * when any `MJ: Components` row is saved, deleted or changed on another server.
+     *
+     * @returns The component, or null when it does not exist or the lookup failed.
+     */
+    async GetComponentByID(id, contextUser, provider) {
+        if (!id)
+            return null;
+        const loaded = this.FindComponentByID(id);
+        if (loaded)
+            return loaded;
+        this.subscribeComponentInvalidation();
+        const key = NormalizeUUID(id);
+        const inFlight = this._componentLookups.get(key);
+        if (inFlight)
+            return inFlight;
+        const lookup = this.queryComponentByID(id, contextUser, provider).then((component) => {
+            // A component change during the query cleared the maps; this result is then stale.
+            if (this._componentLookups.get(key) !== lookup)
+                return component;
+            this._componentLookups.delete(key);
+            if (component)
+                this._componentsByID.set(key, component);
+            return component;
+        });
+        this._componentLookups.set(key, lookup);
+        return lookup;
+    }
+    /** Drops every component {@link GetComponentByID} kept. */
+    ClearComponentCache() {
+        this._componentsByID.clear();
+        this._componentLookups.clear();
+    }
+    async queryComponentByID(id, contextUser, provider) {
+        const source = provider ?? this.ProviderToUse;
+        try {
+            const result = await RunView.FromMetadataProvider(source).RunView({
+                EntityName: 'MJ: Components',
+                ExtraFilter: `ID='${EscapeSQLString(id)}'`,
+                ResultType: 'entity_object',
+                MaxRows: 1,
+            }, contextUser ?? source?.CurrentUser);
+            if (!result.Success) {
+                LogError(`InteractiveFormsEngine: component lookup failed for ${id}: ${result.ErrorMessage ?? 'unknown error'}`);
+                return null;
+            }
+            return (result.Results ?? [])[0] ?? null;
+        }
+        catch (err) {
+            LogError(`InteractiveFormsEngine: component lookup threw for ${id}: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+    /**
+     * A save of any `MJ: Components` row, and a change to one on another server, refreshes the
+     * forms array (a widget is not in it, so the save is not applied in place), and that emission
+     * drops what {@link GetComponentByID} kept. A delete of a row outside the array changes no
+     * array; {@link HandleIndividualBaseEntityEvent} covers it. Subscribed before anything is
+     * kept, so the replay on subscribe clears nothing.
+     */
+    subscribeComponentInvalidation() {
+        if (this._componentInvalidationSubscribed)
+            return;
+        this._componentInvalidationSubscribed = true;
+        this.Forms$.subscribe(() => this.ClearComponentCache());
+    }
+    /**
+     * Drops what {@link GetComponentByID} kept when an `MJ: Components` row is deleted, here or on
+     * another server, then handles the event as every engine does. BaseEngine ignores a delete of a
+     * row that is not in a loaded array, which a fetched widget never is.
+     */
+    async HandleIndividualBaseEntityEvent(event) {
+        if (InteractiveFormsEngine.isComponentDelete(event))
+            this.ClearComponentCache();
+        return super.HandleIndividualBaseEntityEvent(event);
+    }
+    static isComponentDelete(event) {
+        const entityName = (event.baseEntity?.EntityInfo?.Name ?? event.entityName ?? '').trim().toLowerCase();
+        if (entityName !== 'mj: components')
+            return false;
+        if (event.type === 'delete')
+            return true;
+        return event.type === 'remote-invalidate' && event.payload?.action === 'delete';
+    }
     /**
      * Resolver-style lookup matching the runtime form-resolver's scope
      * priority: User > Role > Global. Returns the highest-priority
      * Active override for the given (entity, user, roles) tuple, or null
      * if none match. Within the same scope, lower `Priority` wins (the
-     * resolver convention — Priority is sort key, not boost).
+     * resolver convention — Priority is sort key, not boost). On an identity
+     * or permission entity only the user's own forms count
+     * ({@link FormScopeAllowedOnEntity}).
      *
      * @param entityID The target `MJ: Entities.ID`.
      * @param userID The current user's `MJ: Users.ID`.
@@ -157,6 +410,7 @@ export class InteractiveFormsEngine extends BaseEngine {
             return null;
         const candidates = this.Overrides.filter(o => o.EntityID && UUIDsEqual(o.EntityID, entityID)
             && o.Status === 'Active'
+            && FormScopeAllowedOnEntity(o.Entity, o.Scope)
             && ((o.Scope === 'User' && o.UserID && userID && UUIDsEqual(o.UserID, userID)) ||
                 (o.Scope === 'Role' && o.RoleID && roleIDs.some(r => UUIDsEqual(r, o.RoleID))) ||
                 (o.Scope === 'Global')));

package/dist/engines/interactive-forms.js.map

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