@memberjunction/ng-explorer-core 5.38.0 → 5.40.0

package/dist/lib/services/form-resolver.service.js

@@ -1,235 +0,0 @@
-import { Injectable } from '@angular/core';
-import { LogError } from '@memberjunction/core';
-import { InteractiveFormsEngine } from '@memberjunction/core-entities';
-import { MJGlobal, UUIDsEqual } from '@memberjunction/global';
-import { BaseFormComponent } from '@memberjunction/ng-base-forms';
-import { UserInfoEngine } from '@memberjunction/core-entities';
-import * as i0 from "@angular/core";
-/**
- * UserInfoEngine setting-key prefix for per-user, per-entity form-variant
- * preferences. Persisted to `MJ: User Settings` so the choice follows the
- * user across browsers and devices — localStorage is intentionally NOT used.
- *
- * Key format: `mj.formVariant.<entityname-lowercased>`.
- *
- * Value is one of:
- *   - an `EntityFormOverride.ID` (UUID) → use that specific override
- *   - {@link FormResolverService.EXPLICIT_DEFAULT_SENTINEL} → user picked
- *     the CodeGen Angular fallback explicitly; resolver skips all overrides
- *   - (key absent) → no preference, apply auto-pick rules
- */
-const VARIANT_SETTING_PREFIX = 'mj.formVariant.';
-/**
- * Picks the form to render for an entity record and exposes the full list of
- * applicable variants so the toolbar's variant switcher can offer alternates.
- *
- * Tier order for the **default** pick:
- *   1. `EntityFormOverride` row matching the caller's User/Role/Global scope,
- *      Status='Active', ordered by scope tier (User > Role > Global), then
- *      Priority DESC, then `__mj_CreatedAt DESC`. First row wins.
- *   2. Existing `ClassFactory.GetRegistration(BaseFormComponent, entityName)` —
- *      the @RegisterClass + CodeGen-generated path used today.
- *   3. None — caller surfaces the "no form registered" error.
- *
- * **Session selection.** If the user previously chose a non-default variant
- * via the variant switcher and that choice is still applicable + Active, that
- * choice wins over the default. Choice is keyed by entity name in
- * `localStorage`. Honoring this is part of the variant-switcher contract;
- * without it, switching variants would only last for the lifetime of the
- * record-form view.
- *
- * **Performance.** Backed by `InteractiveFormsEngine` (in MJCoreEntities)
- * — overrides are cached in memory with BaseEntity event-driven
- * invalidation, so resolution is an O(N) JS filter against a small
- * set instead of a per-LoadForm RunView round-trip. Cold latency
- * dropped from ~50ms to <1ms after the first load. The engine is
- * lazy-Config'd here on first resolution; users who never open a
- * record pay nothing.
- */
-export class FormResolverService {
-    async ResolveFormForEntity(entity, user, provider) {
-        const variants = await this.listApplicableVariants(entity, user, provider);
-        const active = this.pickActive(entity, variants);
-        if (active) {
-            return { kind: 'interactive', override: active, variants };
-        }
-        const reg = MJGlobal.Instance.ClassFactory.GetRegistration(BaseFormComponent, entity.Name);
-        return reg
-            ? { kind: 'class', subClass: reg.SubClass, variants }
-            : { kind: 'none', variants };
-    }
-    /**
-     * Public list-API for the variant switcher UI. Returns all variants
-     * applicable to (entity, user). Includes Active, Pending, and Inactive
-     * rows so the picker can offer "switch back to v1.0.0" alongside the
-     * current active variant.
-     */
-    async ListVariantsForEntity(entity, user, provider) {
-        return this.listApplicableVariants(entity, user, provider);
-    }
-    /**
-     * Sentinel stored in localStorage when the user **explicitly picks the
-     * "Default form"** option from the variant picker. Distinct from a
-     * missing localStorage key (= "no preference, use auto-pick rules")
-     * and from an override UUID. Without this sentinel, picking "Default"
-     * cleared the preference and `pickActive` re-applied the auto-pick —
-     * which always selects the first Active override, making the
-     * CodeGen/Angular fallback unreachable from the UI.
-     *
-     * Format: a leading `__` makes it visually distinct from a UUID and
-     * impossible to collide with one (UUIDs don't contain underscores).
-     */
-    static EXPLICIT_DEFAULT_SENTINEL = '__codegen-default__';
-    /**
-     * Build the per-entity setting key. Lowercased so case variants of
-     * the entity name collapse onto a single record in `MJ: User Settings`.
-     */
-    settingKey(entityName) {
-        return VARIANT_SETTING_PREFIX + entityName.toLowerCase();
-    }
-    /**
-     * Persist a specific override choice. Pass the override UUID. Writes
-     * via `UserInfoEngine.SetSettingDebounced` so rapid successive picks
-     * don't hammer the DB. Use {@link SetExplicitDefault} to record "user
-     * wants the CodeGen Angular fallback" and {@link ClearSelectedVariant}
-     * to wipe the preference entirely (revert to auto-pick).
-     */
-    SetSelectedVariant(entityName, overrideID) {
-        UserInfoEngine.Instance.SetSettingDebounced(this.settingKey(entityName), overrideID);
-    }
-    /**
-     * Record that the user explicitly picked the "Default form" row in
-     * the picker. `pickActive` reads this sentinel and returns null even
-     * when Active overrides exist for the entity, so the form-loading
-     * path falls back to CodeGen's `@RegisterClass` lookup.
-     */
-    SetExplicitDefault(entityName) {
-        UserInfoEngine.Instance.SetSettingDebounced(this.settingKey(entityName), FormResolverService.EXPLICIT_DEFAULT_SENTINEL);
-    }
-    /**
-     * Wipe the user's stored preference for this entity. Next load
-     * applies the auto-pick rules (first Active override in tier order).
-     * Called internally when a saved override ID is no longer valid.
-     * Fire-and-forget — the resolver doesn't need to await the delete.
-     */
-    ClearSelectedVariant(entityName) {
-        void UserInfoEngine.Instance.DeleteSetting(this.settingKey(entityName))
-            .catch(err => LogError(`FormResolverService.ClearSelectedVariant: ${err instanceof Error ? err.message : String(err)}`));
-    }
-    /**
-     * Read the user's previously-saved variant choice for the entity.
-     * Synchronous because `UserInfoEngine` keeps the user-settings table
-     * in memory after bootstrap. Returns the stored UUID, the explicit-
-     * default sentinel, or null when no preference exists.
-     */
-    GetSelectedVariant(entityName) {
-        return UserInfoEngine.Instance.GetSetting(this.settingKey(entityName)) ?? null;
-    }
-    // ── internals ────────────────────────────────────────────────────────
-    async listApplicableVariants(entity, user, provider) {
-        // Lazy-load the form-metadata engine on first call. No-op when
-        // already loaded. BaseEngine's event subscription keeps the
-        // cache fresh through save / delete / remote-invalidate — we
-        // don't need `BypassCache: true` (the previous RunView path's
-        // escape hatch) because the engine's invalidation IS that
-        // freshness guarantee. See `InteractiveFormsEngine` doc-block.
-        try {
-            await InteractiveFormsEngine.Instance.Config(false, user, provider);
-        }
-        catch (err) {
-            LogError(`FormResolverService: InteractiveFormsEngine.Config failed: ${err instanceof Error ? err.message : String(err)}`);
-            return [];
-        }
-        const userRoleIds = new Set((user.UserRoles ?? []).map(r => r.RoleID).filter((id) => !!id));
-        // Filter cached overrides for this (entity, user, roles) tuple.
-        // Includes Active + Pending + Inactive (the variant picker shows
-        // all three; pickActive() filters to Active separately). Replaces
-        // a per-LoadForm RunView with an in-memory predicate — sub-ms.
-        const applicable = InteractiveFormsEngine.Instance.Overrides.filter(o => {
-            if (!o.EntityID || !UUIDsEqual(o.EntityID, entity.ID))
-                return false;
-            if (o.Scope === 'User')
-                return !!o.UserID && o.UserID.toLowerCase() === user.ID.toLowerCase();
-            if (o.Scope === 'Role')
-                return !!o.RoleID && userRoleIds.has(o.RoleID);
-            if (o.Scope === 'Global')
-                return true;
-            return false;
-        });
-        // Sort: User > Role > Global, then Priority DESC (higher beats),
-        // then newest first. Matches the prior SQL ORDER BY semantics so
-        // pickActive() / the variant switcher see the same order.
-        const scopeRank = (s) => {
-            if (s === 'User')
-                return 1;
-            if (s === 'Role')
-                return 2;
-            if (s === 'Global')
-                return 3;
-            return 4;
-        };
-        applicable.sort((a, b) => {
-            const sa = scopeRank(a.Scope);
-            const sb = scopeRank(b.Scope);
-            if (sa !== sb)
-                return sa - sb;
-            const pa = a.Priority ?? 0;
-            const pb = b.Priority ?? 0;
-            if (pa !== pb)
-                return pb - pa; // Priority DESC
-            const ca = a.__mj_CreatedAt instanceof Date ? a.__mj_CreatedAt.getTime() : 0;
-            const cb = b.__mj_CreatedAt instanceof Date ? b.__mj_CreatedAt.getTime() : 0;
-            return cb - ca; // newest first
-        });
-        // Project to the slim row shape the resolver returns. Keeps the
-        // contract identical to the old RunView return so callers don't
-        // change shape.
-        return applicable.map(o => ({
-            ID: o.ID,
-            EntityID: o.EntityID,
-            ComponentID: o.ComponentID,
-            Scope: o.Scope,
-            UserID: o.UserID,
-            RoleID: o.RoleID,
-            Priority: o.Priority,
-            Status: o.Status,
-            Name: o.Name,
-            Description: o.Description,
-        }));
-    }
-    /**
-     * Pick the override that should actually render given the variant list
-     * and the user's stored selection (if any).
-     *
-     * Selection rules:
-     *   - If the user explicitly picked the "Default form" row in the
-     *     variant picker (sentinel in localStorage) → return null so the
-     *     form-loading path falls back to CodeGen's `@RegisterClass` lookup.
-     *     This is what makes the Angular fallback reachable from the UI.
-     *   - Else if the user has a saved variant ID AND that variant is in
-     *     the applicable list AND it's Active → use it.
-     *   - Else → first Active row in tier+priority order (auto-pick).
-     *   - Else → null (fall back to CodeGen/@RegisterClass path).
-     */
-    pickActive(entity, variants) {
-        const selectedID = this.GetSelectedVariant(entity.Name);
-        if (selectedID === FormResolverService.EXPLICIT_DEFAULT_SENTINEL) {
-            return null;
-        }
-        if (selectedID) {
-            const sel = variants.find(v => v.Status === 'Active' && UUIDsEqual(v.ID, selectedID));
-            if (sel)
-                return sel;
-            // Selection no longer valid — wipe it so future loads auto-pick.
-            this.ClearSelectedVariant(entity.Name);
-        }
-        return variants.find(v => v.Status === 'Active') ?? null;
-    }
-    static ɵfac = function FormResolverService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || FormResolverService)(); };
-    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: FormResolverService, factory: FormResolverService.ɵfac, providedIn: 'root' });
-}
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(FormResolverService, [{
-        type: Injectable,
-        args: [{ providedIn: 'root' }]
-    }], null, null); })();
-//# sourceMappingURL=form-resolver.service.js.map

package/dist/lib/services/form-resolver.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"form-resolver.service.js","sourceRoot":"","sources":["../../../src/lib/services/form-resolver.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, Type } from '@angular/core';\nimport { IMetadataProvider, UserInfo, EntityInfo, LogError } from '@memberjunction/core';\nimport { InteractiveFormsEngine } from '@memberjunction/core-entities';\nimport { MJGlobal, UUIDsEqual } from '@memberjunction/global';\nimport { BaseFormComponent } from '@memberjunction/ng-base-forms';\nimport { UserInfoEngine } from '@memberjunction/core-entities';\n\n/**\n * Slim row shape for an `EntityFormOverride` lookup. Resolution doesn't need\n * the full BaseEntity object — `simple` ResultType is faster and avoids a\n * compile-time dependency on the generated entity class. The row is only ever\n * read by the resolver; mutation goes through the generated entity in other\n * code paths (Studio, AI authoring).\n */\nexport interface EntityFormOverrideRow {\n    ID: string;\n    EntityID: string;\n    ComponentID: string;\n    Scope: 'User' | 'Role' | 'Global';\n    UserID: string | null;\n    RoleID: string | null;\n    Priority: number;\n    Status: 'Active' | 'Inactive' | 'Pending';\n    Name?: string;\n    Description?: string | null;\n}\n\n/** Resolved form kind for a given (entity, user, roles) tuple. */\nexport type FormResolution =\n    | { kind: 'interactive'; override: EntityFormOverrideRow; variants: EntityFormOverrideRow[] }\n    | { kind: 'class'; subClass: Type<BaseFormComponent>; variants: EntityFormOverrideRow[] }\n    | { kind: 'none'; variants: EntityFormOverrideRow[] };\n\n/**\n * UserInfoEngine setting-key prefix for per-user, per-entity form-variant\n * preferences. Persisted to `MJ: User Settings` so the choice follows the\n * user across browsers and devices — localStorage is intentionally NOT used.\n *\n * Key format: `mj.formVariant.<entityname-lowercased>`.\n *\n * Value is one of:\n *   - an `EntityFormOverride.ID` (UUID) → use that specific override\n *   - {@link FormResolverService.EXPLICIT_DEFAULT_SENTINEL} → user picked\n *     the CodeGen Angular fallback explicitly; resolver skips all overrides\n *   - (key absent) → no preference, apply auto-pick rules\n */\nconst VARIANT_SETTING_PREFIX = 'mj.formVariant.';\n\n/**\n * Picks the form to render for an entity record and exposes the full list of\n * applicable variants so the toolbar's variant switcher can offer alternates.\n *\n * Tier order for the **default** pick:\n *   1. `EntityFormOverride` row matching the caller's User/Role/Global scope,\n *      Status='Active', ordered by scope tier (User > Role > Global), then\n *      Priority DESC, then `__mj_CreatedAt DESC`. First row wins.\n *   2. Existing `ClassFactory.GetRegistration(BaseFormComponent, entityName)` —\n *      the @RegisterClass + CodeGen-generated path used today.\n *   3. None — caller surfaces the \"no form registered\" error.\n *\n * **Session selection.** If the user previously chose a non-default variant\n * via the variant switcher and that choice is still applicable + Active, that\n * choice wins over the default. Choice is keyed by entity name in\n * `localStorage`. Honoring this is part of the variant-switcher contract;\n * without it, switching variants would only last for the lifetime of the\n * record-form view.\n *\n * **Performance.** Backed by `InteractiveFormsEngine` (in MJCoreEntities)\n * — overrides are cached in memory with BaseEntity event-driven\n * invalidation, so resolution is an O(N) JS filter against a small\n * set instead of a per-LoadForm RunView round-trip. Cold latency\n * dropped from ~50ms to <1ms after the first load. The engine is\n * lazy-Config'd here on first resolution; users who never open a\n * record pay nothing.\n */\n@Injectable({ providedIn: 'root' })\nexport class FormResolverService {\n\n    async ResolveFormForEntity(\n        entity: EntityInfo,\n        user: UserInfo,\n        provider: IMetadataProvider,\n    ): Promise<FormResolution> {\n        const variants = await this.listApplicableVariants(entity, user, provider);\n        const active = this.pickActive(entity, variants);\n\n        if (active) {\n            return { kind: 'interactive', override: active, variants };\n        }\n\n        const reg = MJGlobal.Instance.ClassFactory.GetRegistration(BaseFormComponent, entity.Name);\n        return reg\n            ? { kind: 'class', subClass: reg.SubClass as Type<BaseFormComponent>, variants }\n            : { kind: 'none', variants };\n    }\n\n    /**\n     * Public list-API for the variant switcher UI. Returns all variants\n     * applicable to (entity, user). Includes Active, Pending, and Inactive\n     * rows so the picker can offer \"switch back to v1.0.0\" alongside the\n     * current active variant.\n     */\n    async ListVariantsForEntity(\n        entity: EntityInfo,\n        user: UserInfo,\n        provider: IMetadataProvider,\n    ): Promise<EntityFormOverrideRow[]> {\n        return this.listApplicableVariants(entity, user, provider);\n    }\n\n    /**\n     * Sentinel stored in localStorage when the user **explicitly picks the\n     * \"Default form\"** option from the variant picker. Distinct from a\n     * missing localStorage key (= \"no preference, use auto-pick rules\")\n     * and from an override UUID. Without this sentinel, picking \"Default\"\n     * cleared the preference and `pickActive` re-applied the auto-pick —\n     * which always selects the first Active override, making the\n     * CodeGen/Angular fallback unreachable from the UI.\n     *\n     * Format: a leading `__` makes it visually distinct from a UUID and\n     * impossible to collide with one (UUIDs don't contain underscores).\n     */\n    public static readonly EXPLICIT_DEFAULT_SENTINEL = '__codegen-default__';\n\n    /**\n     * Build the per-entity setting key. Lowercased so case variants of\n     * the entity name collapse onto a single record in `MJ: User Settings`.\n     */\n    private settingKey(entityName: string): string {\n        return VARIANT_SETTING_PREFIX + entityName.toLowerCase();\n    }\n\n    /**\n     * Persist a specific override choice. Pass the override UUID. Writes\n     * via `UserInfoEngine.SetSettingDebounced` so rapid successive picks\n     * don't hammer the DB. Use {@link SetExplicitDefault} to record \"user\n     * wants the CodeGen Angular fallback\" and {@link ClearSelectedVariant}\n     * to wipe the preference entirely (revert to auto-pick).\n     */\n    SetSelectedVariant(entityName: string, overrideID: string): void {\n        UserInfoEngine.Instance.SetSettingDebounced(this.settingKey(entityName), overrideID);\n    }\n\n    /**\n     * Record that the user explicitly picked the \"Default form\" row in\n     * the picker. `pickActive` reads this sentinel and returns null even\n     * when Active overrides exist for the entity, so the form-loading\n     * path falls back to CodeGen's `@RegisterClass` lookup.\n     */\n    SetExplicitDefault(entityName: string): void {\n        UserInfoEngine.Instance.SetSettingDebounced(\n            this.settingKey(entityName),\n            FormResolverService.EXPLICIT_DEFAULT_SENTINEL,\n        );\n    }\n\n    /**\n     * Wipe the user's stored preference for this entity. Next load\n     * applies the auto-pick rules (first Active override in tier order).\n     * Called internally when a saved override ID is no longer valid.\n     * Fire-and-forget — the resolver doesn't need to await the delete.\n     */\n    ClearSelectedVariant(entityName: string): void {\n        void UserInfoEngine.Instance.DeleteSetting(this.settingKey(entityName))\n            .catch(err => LogError(`FormResolverService.ClearSelectedVariant: ${err instanceof Error ? err.message : String(err)}`));\n    }\n\n    /**\n     * Read the user's previously-saved variant choice for the entity.\n     * Synchronous because `UserInfoEngine` keeps the user-settings table\n     * in memory after bootstrap. Returns the stored UUID, the explicit-\n     * default sentinel, or null when no preference exists.\n     */\n    GetSelectedVariant(entityName: string): string | null {\n        return UserInfoEngine.Instance.GetSetting(this.settingKey(entityName)) ?? null;\n    }\n\n    // ── internals ────────────────────────────────────────────────────────\n\n    private async listApplicableVariants(\n        entity: EntityInfo,\n        user: UserInfo,\n        provider: IMetadataProvider,\n    ): Promise<EntityFormOverrideRow[]> {\n        // Lazy-load the form-metadata engine on first call. No-op when\n        // already loaded. BaseEngine's event subscription keeps the\n        // cache fresh through save / delete / remote-invalidate — we\n        // don't need `BypassCache: true` (the previous RunView path's\n        // escape hatch) because the engine's invalidation IS that\n        // freshness guarantee. See `InteractiveFormsEngine` doc-block.\n        try {\n            await InteractiveFormsEngine.Instance.Config(false, user, provider);\n        } catch (err) {\n            LogError(`FormResolverService: InteractiveFormsEngine.Config failed: ${err instanceof Error ? err.message : String(err)}`);\n            return [];\n        }\n\n        const userRoleIds = new Set(\n            (user.UserRoles ?? []).map(r => r.RoleID).filter((id): id is string => !!id),\n        );\n\n        // Filter cached overrides for this (entity, user, roles) tuple.\n        // Includes Active + Pending + Inactive (the variant picker shows\n        // all three; pickActive() filters to Active separately). Replaces\n        // a per-LoadForm RunView with an in-memory predicate — sub-ms.\n        const applicable = InteractiveFormsEngine.Instance.Overrides.filter(o => {\n            if (!o.EntityID || !UUIDsEqual(o.EntityID, entity.ID)) return false;\n            if (o.Scope === 'User')   return !!o.UserID && o.UserID.toLowerCase() === user.ID.toLowerCase();\n            if (o.Scope === 'Role')   return !!o.RoleID && userRoleIds.has(o.RoleID);\n            if (o.Scope === 'Global') return true;\n            return false;\n        });\n\n        // Sort: User > Role > Global, then Priority DESC (higher beats),\n        // then newest first. Matches the prior SQL ORDER BY semantics so\n        // pickActive() / the variant switcher see the same order.\n        const scopeRank = (s: string | null | undefined): number => {\n            if (s === 'User')   return 1;\n            if (s === 'Role')   return 2;\n            if (s === 'Global') return 3;\n            return 4;\n        };\n        applicable.sort((a, b) => {\n            const sa = scopeRank(a.Scope);\n            const sb = scopeRank(b.Scope);\n            if (sa !== sb) return sa - sb;\n            const pa = a.Priority ?? 0;\n            const pb = b.Priority ?? 0;\n            if (pa !== pb) return pb - pa;  // Priority DESC\n            const ca = a.__mj_CreatedAt instanceof Date ? a.__mj_CreatedAt.getTime() : 0;\n            const cb = b.__mj_CreatedAt instanceof Date ? b.__mj_CreatedAt.getTime() : 0;\n            return cb - ca;  // newest first\n        });\n\n        // Project to the slim row shape the resolver returns. Keeps the\n        // contract identical to the old RunView return so callers don't\n        // change shape.\n        return applicable.map(o => ({\n            ID: o.ID,\n            EntityID: o.EntityID,\n            ComponentID: o.ComponentID,\n            Scope: o.Scope as 'User' | 'Role' | 'Global',\n            UserID: o.UserID,\n            RoleID: o.RoleID,\n            Priority: o.Priority,\n            Status: o.Status as 'Active' | 'Inactive' | 'Pending',\n            Name: o.Name,\n            Description: o.Description,\n        }));\n    }\n\n    /**\n     * Pick the override that should actually render given the variant list\n     * and the user's stored selection (if any).\n     *\n     * Selection rules:\n     *   - If the user explicitly picked the \"Default form\" row in the\n     *     variant picker (sentinel in localStorage) → return null so the\n     *     form-loading path falls back to CodeGen's `@RegisterClass` lookup.\n     *     This is what makes the Angular fallback reachable from the UI.\n     *   - Else if the user has a saved variant ID AND that variant is in\n     *     the applicable list AND it's Active → use it.\n     *   - Else → first Active row in tier+priority order (auto-pick).\n     *   - Else → null (fall back to CodeGen/@RegisterClass path).\n     */\n    private pickActive(\n        entity: EntityInfo,\n        variants: EntityFormOverrideRow[],\n    ): EntityFormOverrideRow | null {\n        const selectedID = this.GetSelectedVariant(entity.Name);\n        if (selectedID === FormResolverService.EXPLICIT_DEFAULT_SENTINEL) {\n            return null;\n        }\n        if (selectedID) {\n            const sel = variants.find(v => v.Status === 'Active' && UUIDsEqual(v.ID, selectedID));\n            if (sel) return sel;\n            // Selection no longer valid — wipe it so future loads auto-pick.\n            this.ClearSelectedVariant(entity.Name);\n        }\n        return variants.find(v => v.Status === 'Active') ?? null;\n    }\n}\n"]}