@memberjunction/core 5.11.0 → 5.13.0

package/dist/generic/hookRegistry.d.ts

@@ -1,83 +0,0 @@
-import type { RunViewResult } from './interfaces.js';
-import type { RunViewParams } from '../views/runView.js';
-import type { UserInfo } from './securityInfo.js';
-import type { BaseEntity } from './baseEntity.js';
-/**
- * Hook that runs before a RunView operation. Can modify the RunViewParams
- * (e.g., injecting tenant filters) before execution.
- * Return the (possibly modified) params to continue, or throw to abort.
- */
-export type PreRunViewHook = (params: RunViewParams, contextUser: UserInfo | undefined) => RunViewParams | Promise<RunViewParams>;
-/**
- * Hook that runs after a RunView operation completes. Can modify the result
- * (e.g., filtering or augmenting data) before it is returned to the caller.
- */
-export type PostRunViewHook = (params: RunViewParams, results: RunViewResult, contextUser: UserInfo | undefined) => RunViewResult | Promise<RunViewResult>;
-/**
- * Hook that runs before a Save operation on a BaseEntity.
- * Return `true` to allow the save, `false` to reject silently,
- * or a string to reject with that error message.
- */
-export type PreSaveHook = (entity: BaseEntity, contextUser: UserInfo | undefined) => boolean | string | Promise<boolean | string>;
-/** Well-known hook names used by the registry */
-export type HookName = 'PreRunView' | 'PostRunView' | 'PreSave';
-/**
- * Options for controlling hook registration behavior.
- */
-export interface HookRegistrationOptions {
-    /**
-     * Numeric priority. Lower numbers run first. Default: 100.
-     *
-     * Convention:
-     * - MJ built-in hooks: 50
-     * - Middle-layer hooks (e.g., SaaS layer): 100
-     * - Application-level hooks: 200+
-     */
-    Priority?: number;
-    /**
-     * Unique namespace for this hook (e.g., 'mj:tenantFilter', 'bcsaas:tenantFilter').
-     *
-     * When registering with a namespace that already exists for this hook name,
-     * the old hook is **replaced** rather than appended. This allows a middle layer
-     * to override MJ's generic hook without causing double execution.
-     */
-    Namespace?: string;
-}
-/**
- * Global hook registry backed by GetGlobalObjectStore() so it works
- * reliably across bundler code-splits (same pattern as BaseSingleton).
- *
- * Lives in @memberjunction/core so both ProviderBase and BaseEntity can
- * consume it without circular dependencies on @memberjunction/server.
- */
-export declare class HookRegistry {
-    /**
-     * Returns the backing store map, creating it lazily on first access.
-     */
-    private static get _store();
-    /**
-     * Register a hook function under the given name.
-     *
-     * When `options.Namespace` is provided and a hook with the same namespace already
-     * exists for this hook name, the old hook is replaced. Otherwise the hook is appended.
-     *
-     * Hooks are returned by `GetHooks` in ascending priority order (lower = first).
-     * The default priority is 100.
-     */
-    static Register<T>(hookName: HookName | string, hook: T, options?: HookRegistrationOptions): void;
-    /**
-     * Retrieve all hooks registered under the given name, in priority order (lowest first).
-     * Returns an empty array if none are registered (safe for iteration).
-     */
-    static GetHooks<T>(hookName: HookName | string): T[];
-    /**
-     * Remove all hooks registered under the given name.
-     * Useful for testing or server restart scenarios.
-     */
-    static Clear(hookName: HookName | string): void;
-    /**
-     * Remove all hooks from all names.
-     */
-    static ClearAll(): void;
-}
-//# sourceMappingURL=hookRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hookRegistry.d.ts","sourceRoot":"","sources":["../../src/generic/hookRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,QAAQ,GAAG,SAAS,KAC9B,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,QAAQ,GAAG,SAAS,KAC9B,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,QAAQ,GAAG,SAAS,KAC9B,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;AAElD,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,CAAC,MAAM,KAAK,MAAM,GASxB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI;IA8BjG;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;IAMpD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAK/C;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,IAAI;CAMxB"}

package/dist/generic/hookRegistry.js

@@ -1,87 +0,0 @@
-import { GetGlobalObjectStore } from '@memberjunction/global';
-const REGISTRY_KEY = '__mj_hookRegistry';
-/**
- * Global hook registry backed by GetGlobalObjectStore() so it works
- * reliably across bundler code-splits (same pattern as BaseSingleton).
- *
- * Lives in @memberjunction/core so both ProviderBase and BaseEntity can
- * consume it without circular dependencies on @memberjunction/server.
- */
-export class HookRegistry {
-    /**
-     * Returns the backing store map, creating it lazily on first access.
-     */
-    static get _store() {
-        const gos = GetGlobalObjectStore();
-        if (!gos) {
-            throw new Error('HookRegistry: GlobalObjectStore is not available');
-        }
-        if (!gos[REGISTRY_KEY]) {
-            gos[REGISTRY_KEY] = {};
-        }
-        return gos[REGISTRY_KEY];
-    }
-    /**
-     * Register a hook function under the given name.
-     *
-     * When `options.Namespace` is provided and a hook with the same namespace already
-     * exists for this hook name, the old hook is replaced. Otherwise the hook is appended.
-     *
-     * Hooks are returned by `GetHooks` in ascending priority order (lower = first).
-     * The default priority is 100.
-     */
-    static Register(hookName, hook, options) {
-        const store = HookRegistry._store;
-        if (!store[hookName]) {
-            store[hookName] = [];
-        }
-        const entry = {
-            hook,
-            priority: options?.Priority ?? 100,
-            namespace: options?.Namespace,
-        };
-        const hooks = store[hookName];
-        // If namespace is provided and already exists, replace it
-        if (entry.namespace) {
-            const existingIndex = hooks.findIndex(h => h.namespace === entry.namespace);
-            if (existingIndex >= 0) {
-                hooks[existingIndex] = entry;
-            }
-            else {
-                hooks.push(entry);
-            }
-        }
-        else {
-            hooks.push(entry);
-        }
-        // Sort by priority (lower first), stable for equal priorities
-        hooks.sort((a, b) => a.priority - b.priority);
-    }
-    /**
-     * Retrieve all hooks registered under the given name, in priority order (lowest first).
-     * Returns an empty array if none are registered (safe for iteration).
-     */
-    static GetHooks(hookName) {
-        const store = HookRegistry._store;
-        const entries = store[hookName] ?? [];
-        return entries.map(e => e.hook);
-    }
-    /**
-     * Remove all hooks registered under the given name.
-     * Useful for testing or server restart scenarios.
-     */
-    static Clear(hookName) {
-        const store = HookRegistry._store;
-        delete store[hookName];
-    }
-    /**
-     * Remove all hooks from all names.
-     */
-    static ClearAll() {
-        const gos = GetGlobalObjectStore();
-        if (gos) {
-            gos[REGISTRY_KEY] = {};
-        }
-    }
-}
-//# sourceMappingURL=hookRegistry.js.map

package/dist/generic/hookRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hookRegistry.js","sourceRoot":"","sources":["../../src/generic/hookRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAsE9D,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACK,MAAM,KAAK,MAAM;QACvB,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,CAAC,YAAY,CAAgC,CAAC;IAC1D,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAI,QAA2B,EAAE,IAAO,EAAE,OAAiC;QACxF,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAc;YACvB,IAAI;YACJ,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,GAAG;YAClC,SAAS,EAAE,OAAO,EAAE,SAAS;SAC9B,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE9B,0DAA0D;QAC1D,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;YAC5E,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAED,8DAA8D;QAC9D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAI,QAA2B;QAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,QAA2B;QACtC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;QAClC,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ;QACb,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}