@memberjunction/react-runtime 6.2.0-edge.0 → 6.2.0-edge.2

package/src/utilities/resource-manager.ts

@@ -69,7 +69,7 @@ export class ResourceManager {
   /**
    * Register a timeout with automatic cleanup
    */
-  setTimeout(
+  SetTimeout(
     componentId: string,
     callback: () => void,
     delay: number,
@@ -90,10 +90,20 @@ export class ResourceManager {
     return id as any;
   }
 
+  /** @deprecated Use {@link SetTimeout}. */
+  setTimeout(
+    componentId: string,
+    callback: () => void,
+    delay: number,
+    metadata?: Record<string, any>
+  ): number {
+    return this.SetTimeout(componentId, callback, delay, metadata);
+  }
+
   /**
    * Register an interval with automatic cleanup
    */
-  setInterval(
+  SetInterval(
     componentId: string,
     callback: () => void,
     delay: number,
@@ -111,17 +121,27 @@ export class ResourceManager {
     return id as any;
   }
 
+  /** @deprecated Use {@link SetInterval}. */
+  setInterval(
+    componentId: string,
+    callback: () => void,
+    delay: number,
+    metadata?: Record<string, any>
+  ): number {
+    return this.SetInterval(componentId, callback, delay, metadata);
+  }
+
   /**
    * Register an animation frame with automatic cleanup
    */
-  requestAnimationFrame(
+  RequestAnimationFrame(
     componentId: string,
     callback: FrameRequestCallback,
     metadata?: Record<string, any>
   ): TimerId {
     if (!timers.requestAnimationFrame) {
       // Fallback to setTimeout in non-browser environments
-      return this.setTimeout(componentId, () => callback(Date.now()), 16, metadata);
+      return this.SetTimeout(componentId, () => callback(Date.now()), 16, metadata);
     }
 
     const id = timers.requestAnimationFrame((time) => {
@@ -139,26 +159,45 @@ export class ResourceManager {
     return id as any;
   }
 
+  /** @deprecated Use {@link RequestAnimationFrame}. */
+  requestAnimationFrame(
+    componentId: string,
+    callback: FrameRequestCallback,
+    metadata?: Record<string, any>
+  ): TimerId {
+    return this.RequestAnimationFrame(componentId, callback, metadata);
+  }
+
   /**
    * Clear a specific timeout
    */
-  clearTimeout(componentId: string, id: number): void {
+  ClearTimeout(componentId: string, id: number): void {
     timers.clearTimeout(id);
     this.removeResource(componentId, 'timer', id);
   }
 
+  /** @deprecated Use {@link ClearTimeout}. */
+  clearTimeout(componentId: string, id: number): void {
+    return this.ClearTimeout(componentId, id);
+  }
+
   /**
    * Clear a specific interval
    */
-  clearInterval(componentId: string, id: number): void {
+  ClearInterval(componentId: string, id: number): void {
     timers.clearInterval(id);
     this.removeResource(componentId, 'interval', id);
   }
 
+  /** @deprecated Use {@link ClearInterval}. */
+  clearInterval(componentId: string, id: number): void {
+    return this.ClearInterval(componentId, id);
+  }
+
   /**
    * Cancel a specific animation frame
    */
-  cancelAnimationFrame(componentId: string, id: TimerId): void {
+  CancelAnimationFrame(componentId: string, id: TimerId): void {
     if (timers.cancelAnimationFrame) {
       timers.cancelAnimationFrame(id as number);
     } else {
@@ -168,10 +207,15 @@ export class ResourceManager {
     this.removeResource(componentId, 'animationFrame', id);
   }
 
+  /** @deprecated Use {@link CancelAnimationFrame}. */
+  cancelAnimationFrame(componentId: string, id: TimerId): void {
+    return this.CancelAnimationFrame(componentId, id);
+  }
+
   /**
    * Register an event listener with automatic cleanup
    */
-  addEventListener(
+  AddEventListener(
     componentId: string,
     target: EventTarget,
     type: string,
@@ -196,10 +240,21 @@ export class ResourceManager {
     }
   }
 
+  /** @deprecated Use {@link AddEventListener}. */
+  addEventListener(
+    componentId: string,
+    target: EventTarget,
+    type: string,
+    listener: EventListener,
+    options?: AddEventListenerOptions
+  ): void {
+    return this.AddEventListener(componentId, target, type, listener, options);
+  }
+
   /**
    * Register a DOM element that needs cleanup
    */
-  registerDOMElement(
+  RegisterDOMElement(
     componentId: string,
     element: any, // Use 'any' to avoid HTMLElement type in Node.js
     cleanup?: () => void
@@ -223,10 +278,19 @@ export class ResourceManager {
     }
   }
 
+  /** @deprecated Use {@link RegisterDOMElement}. */
+  registerDOMElement(
+    componentId: string,
+    element: any, // Use 'any' to avoid HTMLElement type in Node.js
+    cleanup?: () => void
+  ): void {
+    return this.RegisterDOMElement(componentId, element, cleanup);
+  }
+
   /**
    * Register a React root for cleanup
    */
-  registerReactRoot(
+  RegisterReactRoot(
     componentId: string,
     root: any,
     unmountFn: () => void
@@ -239,23 +303,42 @@ export class ResourceManager {
     });
   }
 
+  /** @deprecated Use {@link RegisterReactRoot}. */
+  registerReactRoot(
+    componentId: string,
+    root: any,
+    unmountFn: () => void
+  ): void {
+    return this.RegisterReactRoot(componentId, root, unmountFn);
+  }
+
   /**
    * Register a generic cleanup callback for a component
    */
-  registerCleanup(componentId: string, cleanup: () => void): void {
+  RegisterCleanup(componentId: string, cleanup: () => void): void {
     if (!this.cleanupCallbacks.has(componentId)) {
       this.cleanupCallbacks.set(componentId, []);
     }
     this.cleanupCallbacks.get(componentId)!.push(cleanup);
   }
 
+  /** @deprecated Use {@link RegisterCleanup}. */
+  registerCleanup(componentId: string, cleanup: () => void): void {
+    return this.RegisterCleanup(componentId, cleanup);
+  }
+
   /**
    * Register a global resource (not tied to a specific component)
    */
-  registerGlobalResource(resource: ManagedResource): void {
+  RegisterGlobalResource(resource: ManagedResource): void {
     this.globalResources.add(resource);
   }
 
+  /** @deprecated Use {@link RegisterGlobalResource}. */
+  registerGlobalResource(resource: ManagedResource): void {
+    return this.RegisterGlobalResource(resource);
+  }
+
   /**
    * Add a resource to be managed
    */
@@ -288,7 +371,7 @@ export class ResourceManager {
   /**
    * Clean up all resources for a specific component
    */
-  cleanupComponent(componentId: string): void {
+  CleanupComponent(componentId: string): void {
     // Clean up tracked resources
     const componentResources = this.resources.get(componentId);
     if (componentResources) {
@@ -316,10 +399,15 @@ export class ResourceManager {
     }
   }
 
+  /** @deprecated Use {@link CleanupComponent}. */
+  cleanupComponent(componentId: string): void {
+    return this.CleanupComponent(componentId);
+  }
+
   /**
    * Clean up all global resources
    */
-  cleanupGlobal(): void {
+  CleanupGlobal(): void {
     this.globalResources.forEach(resource => {
       try {
         resource.cleanup();
@@ -330,23 +418,33 @@ export class ResourceManager {
     this.globalResources.clear();
   }
 
+  /** @deprecated Use {@link CleanupGlobal}. */
+  cleanupGlobal(): void {
+    return this.CleanupGlobal();
+  }
+
   /**
    * Clean up all resources (components and global)
    */
-  cleanupAll(): void {
+  CleanupAll(): void {
     // Clean up all component resources
     for (const componentId of this.resources.keys()) {
-      this.cleanupComponent(componentId);
+      this.CleanupComponent(componentId);
     }
 
     // Clean up global resources
-    this.cleanupGlobal();
+    this.CleanupGlobal();
+  }
+
+  /** @deprecated Use {@link CleanupAll}. */
+  cleanupAll(): void {
+    return this.CleanupAll();
   }
 
   /**
    * Get resource statistics for debugging
    */
-  getStats(): {
+  GetStats(): {
     componentCount: number;
     resourceCounts: Record<string, number>;
     globalResourceCount: number;
@@ -365,7 +463,16 @@ export class ResourceManager {
       globalResourceCount: this.globalResources.size
     };
   }
+
+  /** @deprecated Use {@link GetStats}. */
+  getStats(): {
+    componentCount: number;
+    resourceCounts: Record<string, number>;
+    globalResourceCount: number;
+  } {
+    return this.GetStats();
+  }
 }
 
 // Singleton instance
-export const resourceManager = new ResourceManager();
+export const resourceManager = new ResourceManager();  // case-violation-ok-legacy-back-compat: the PascalCase name is already taken in this scope

package/src/utilities/runtime-utilities.ts

@@ -92,30 +92,35 @@ export class RuntimeUtilities {
    *        passes its own `ProviderToUse`; omitting it falls back to the global default, named
    *        explicitly rather than reached for via `new Metadata()`.
    */
-  public buildUtilities(debug: boolean = false, provider?: IMetadataProvider): ComponentUtilities {
+  public BuildUtilities(debug: boolean = false, provider?: IMetadataProvider): ComponentUtilities {
     this.debug = debug;
     this.provider = provider ?? Metadata.Provider;
-    return this.SetupUtilities(this.provider);
+    return this.setupUtilities(this.provider);
+  }
+
+  /** @deprecated Use {@link BuildUtilities}. */
+  public buildUtilities(debug: boolean = false, provider?: IMetadataProvider): ComponentUtilities {
+    return this.BuildUtilities(debug, provider);
   }
 
   /**
    * Sets up the utilities object - copied from skip-chat implementation
    */
-  private SetupUtilities(md: IMetadataProvider): ComponentUtilities {
+  private setupUtilities(md: IMetadataProvider): ComponentUtilities {
     const rv = RunView.FromMetadataProvider(md);
     const rq = new RunQuery(md as unknown as IRunQueryProvider);
     const u: ComponentUtilities = {
-      md: this.CreateSimpleMetadata(md),
-      rv: this.CreateSimpleRunView(rv),
-      rq: this.CreateSimpleRunQuery(rq),
-      ai: this.CreateSimpleAITools(),
-      geoDataEngine: this.CreateSimpleGeoDataEngine(),
-      ml: this.CreateSimpleMLTools()
+      md: this.createSimpleMetadata(md),
+      rv: this.createSimpleRunView(rv),
+      rq: this.createSimpleRunQuery(rq),
+      ai: this.createSimpleAITools(),
+      geoDataEngine: this.createSimpleGeoDataEngine(),
+      ml: this.createSimpleMLTools()
     };
     return u;
   }
 
-  private CreateSimpleAITools(): SimpleAITools {
+  private createSimpleAITools(): SimpleAITools {
     // Get the GraphQL provider - it's the same as the BaseEntity provider
     const provider = BaseEntity.Provider;
     
@@ -199,7 +204,7 @@ export class RuntimeUtilities {
    * Python sidecar lives server-side and cannot run in the browser). Returns `undefined` when no
    * GraphQL provider is available, so the `ml` capability degrades cleanly.
    */
-  private CreateSimpleMLTools(): SimpleMLTools | undefined {
+  private createSimpleMLTools(): SimpleMLTools | undefined {
     const provider = BaseEntity.Provider;
     // Scoring requires a GraphQL provider to route the Remote Operation to the server engine.
     if (!(provider instanceof GraphQLDataProvider)) {
@@ -354,7 +359,7 @@ export class RuntimeUtilities {
     return value.replace(/'/g, "''");
   }
 
-  private CreateSimpleMetadata(md: IMetadataProvider): SimpleMetadata {
+  private createSimpleMetadata(md: IMetadataProvider): SimpleMetadata {
     return {
       Entities: md.Entities,
       GetEntityObject: (entityName: string) => {
@@ -363,7 +368,7 @@ export class RuntimeUtilities {
     }
   }
 
-  private CreateSimpleGeoDataEngine(): SimpleGeoDataEngine | undefined {
+  private createSimpleGeoDataEngine(): SimpleGeoDataEngine | undefined {
     try {
       const geo = GeoDataEngine.Instance;
       if (!geo) return undefined;
@@ -383,7 +388,7 @@ export class RuntimeUtilities {
     }
   }
 
-  private CreateSimpleRunQuery(rq: RunQuery): SimpleRunQuery {
+  private createSimpleRunQuery(rq: RunQuery): SimpleRunQuery {
     return {
       RunQuery: async (params: RunQueryParams) => {
         // Run a single query and return the results
@@ -408,7 +413,7 @@ export class RuntimeUtilities {
     }
   }
 
-  private CreateSimpleRunView(rv: RunView): SimpleRunView {
+  private createSimpleRunView(rv: RunView): SimpleRunView {
     return {
       RunView: async (params: RunViewParams) => {
         // Run a single view and return the results
@@ -457,7 +462,7 @@ export class RuntimeUtilities {
  * In a Node.js environment, this will use MJ's ClassFactory for runtime substitution
  * In a browser environment, it will use the base class directly
  */
-export function createRuntimeUtilities(): RuntimeUtilities {
+export function CreateRuntimeUtilities(): RuntimeUtilities {
   try {
     // Resolve through ClassFactory so a host that registers a higher-priority subclass gets it.
     // `CreateInstance` with a null key matches any registration for this root class, and the
@@ -473,4 +478,9 @@ export function createRuntimeUtilities(): RuntimeUtilities {
   }
 
   return new RuntimeUtilities();
+}
+
+/** @deprecated Use {@link CreateRuntimeUtilities}. */
+export function createRuntimeUtilities(): RuntimeUtilities {
+  return CreateRuntimeUtilities();
 }

package/src/utilities/standard-libraries.ts

@@ -33,56 +33,91 @@ export class StandardLibraryManager {
   /**
    * Set a custom library configuration
    */
-  static setConfiguration(config: LibraryConfiguration): void {
+  static SetConfiguration(config: LibraryConfiguration): void {
     this.configuration = config;
   }
+
+  /** @deprecated Use {@link SetConfiguration}. */
+  static setConfiguration(config: LibraryConfiguration): void {
+    return this.SetConfiguration(config);
+  }
   
   /**
    * Get the current library configuration
    */
-  static getConfiguration(): LibraryConfiguration {
+  static GetConfiguration(): LibraryConfiguration {
     return this.configuration;
   }
+
+  /** @deprecated Use {@link GetConfiguration}. */
+  static getConfiguration(): LibraryConfiguration {
+    return this.GetConfiguration();
+  }
   
   /**
    * Get all enabled libraries
    */
-  static getEnabledLibraries(): ExternalLibraryConfig[] {
+  static GetEnabledLibraries(): ExternalLibraryConfig[] {
     return this.configuration.libraries.filter(lib => lib.isEnabled);
   }
+
+  /** @deprecated Use {@link GetEnabledLibraries}. */
+  static getEnabledLibraries(): ExternalLibraryConfig[] {
+    return this.GetEnabledLibraries();
+  }
   
   /**
    * Get libraries by category
    */
-  static getLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {
+  static GetLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {
     return this.configuration.libraries.filter(lib => lib.category === category && lib.isEnabled);
   }
+
+  /** @deprecated Use {@link GetLibrariesByCategory}. */
+  static getLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {
+    return this.GetLibrariesByCategory(category);
+  }
   
   /**
    * Get core libraries (runtime essentials)
    */
-  static getCoreLibraries(): ExternalLibraryConfig[] {
+  static GetCoreLibraries(): ExternalLibraryConfig[] {
     return this.configuration.libraries.filter(lib => lib.isCore && lib.isEnabled);
   }
+
+  /** @deprecated Use {@link GetCoreLibraries}. */
+  static getCoreLibraries(): ExternalLibraryConfig[] {
+    return this.GetCoreLibraries();
+  }
   
   /**
    * Get component libraries (non-runtime)
    */
-  static getComponentLibraries(): ExternalLibraryConfig[] {
+  static GetComponentLibraries(): ExternalLibraryConfig[] {
     return this.configuration.libraries.filter(lib => !lib.isRuntimeOnly && lib.isEnabled);
   }
+
+  /** @deprecated Use {@link GetComponentLibraries}. */
+  static getComponentLibraries(): ExternalLibraryConfig[] {
+    return this.GetComponentLibraries();
+  }
   
   /**
    * Get library by ID
    */
-  static getLibraryById(id: string): ExternalLibraryConfig | undefined {
+  static GetLibraryById(id: string): ExternalLibraryConfig | undefined {
     return this.configuration.libraries.find(lib => lib.id === id);
   }
+
+  /** @deprecated Use {@link GetLibraryById}. */
+  static getLibraryById(id: string): ExternalLibraryConfig | undefined {
+    return this.GetLibraryById(id);
+  }
   
   /**
    * Get library URLs as a simple object (for backward compatibility)
    */
-  static getLibraryUrls(): Record<string, string> {
+  static GetLibraryUrls(): Record<string, string> {
     const urls: Record<string, string> = {};
     this.configuration.libraries
       .filter(lib => lib.isEnabled)
@@ -96,13 +131,23 @@ export class StandardLibraryManager {
       });
     return urls;
   }
+
+  /** @deprecated Use {@link GetLibraryUrls}. */
+  static getLibraryUrls(): Record<string, string> {
+    return this.GetLibraryUrls();
+  }
   
   /**
    * Reset to default configuration
    */
-  static resetToDefault(): void {
+  static ResetToDefault(): void {
     this.configuration = DEFAULT_LIBRARY_CONFIG;
   }
+
+  /** @deprecated Use {@link ResetToDefault}. */
+  static resetToDefault(): void {
+    return this.ResetToDefault();
+  }
 }
 
 
@@ -110,7 +155,7 @@ export class StandardLibraryManager {
  * Creates a standard libraries object for browser environments
  * Dynamically collects all libraries based on current configuration
  */
-export function createStandardLibraries(): StandardLibraries {
+export function CreateStandardLibraries(): StandardLibraries {
   if (typeof window === 'undefined') {
     // Return empty object in Node.js environments
     return {};
@@ -127,4 +172,9 @@ export function createStandardLibraries(): StandardLibraries {
   });
   
   return libs;
+}
+
+/** @deprecated Use {@link CreateStandardLibraries}. */
+export function createStandardLibraries(): StandardLibraries {
+  return CreateStandardLibraries();
 }

package/src/utilities/user-state.ts

@@ -35,7 +35,7 @@ export const USER_STATE_KEY_PREFIX = 'InteractiveComponents_UserState_Root/';
  * @returns the resolved scope, or `null` when no stable scope can be derived
  *          (e.g. an unnamed component) — signaling the caller to skip persistence.
  */
-export function resolveUserStateScope(
+export function ResolveUserStateScope(
   explicitScope: string | undefined | null,
   namespace: string | undefined | null,
   name: string | undefined | null
@@ -53,20 +53,34 @@ export function resolveUserStateScope(
   return scope.toLowerCase();
 }
 
+/** @deprecated Use {@link ResolveUserStateScope}. */
+export function resolveUserStateScope(
+  explicitScope: string | undefined | null,
+  namespace: string | undefined | null,
+  name: string | undefined | null
+): string | null {
+  return ResolveUserStateScope(explicitScope, namespace, name);
+}
+
 /**
  * Build the full storage key for a resolved scope, or `null` when the scope is
  * `null` (persistence should be skipped).
  */
-export function userStateStorageKey(scope: string | null): string | null {
+export function UserStateStorageKey(scope: string | null): string | null {
   return scope ? `${USER_STATE_KEY_PREFIX}${scope}` : null;
 }
 
+/** @deprecated Use {@link UserStateStorageKey}. */
+export function userStateStorageKey(scope: string | null): string | null {
+  return UserStateStorageKey(scope);
+}
+
 /**
  * Safely parse a stored settings blob into a plain object. Returns `{}` for
  * null/empty input, invalid JSON, or any non-object JSON (arrays, primitives) —
  * persisted user settings are always a flat key/value object.
  */
-export function parseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {
+export function ParseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {
   if (!raw) {
     return {};
   }
@@ -81,18 +95,31 @@ export function parseStoredUserSettings(raw: string | undefined | null): Record<
   }
 }
 
+/** @deprecated Use {@link ParseStoredUserSettings}. */
+export function parseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {
+  return ParseStoredUserSettings(raw);
+}
+
 /**
  * Merge host-provided defaults with the stored per-user settings. Stored values
  * win, so a returning user sees their saved preferences while a host can still
  * seed sensible first-run defaults that fill any gaps.
  */
-export function mergeUserSettings(
+export function MergeUserSettings(
   hostDefaults: Record<string, unknown> | undefined | null,
   stored: Record<string, unknown> | undefined | null
 ): Record<string, unknown> {
   return { ...(hostDefaults ?? {}), ...(stored ?? {}) };
 }
 
+/** @deprecated Use {@link MergeUserSettings}. */
+export function mergeUserSettings(
+  hostDefaults: Record<string, unknown> | undefined | null,
+  stored: Record<string, unknown> | undefined | null
+): Record<string, unknown> {
+  return MergeUserSettings(hostDefaults, stored);
+}
+
 /**
  * Apply an `onSaveUserSettings` payload to the host's current settings snapshot.
  *
@@ -113,7 +140,7 @@ export function mergeUserSettings(
  *
  * @returns a new object — neither input is mutated.
  */
-export function applyUserSettingsUpdate(
+export function ApplyUserSettingsUpdate(
   current: Record<string, unknown> | undefined | null,
   incoming: Record<string, unknown> | undefined | null
 ): Record<string, unknown> {
@@ -127,3 +154,11 @@ export function applyUserSettingsUpdate(
   }
   return next;
 }
+
+/** @deprecated Use {@link ApplyUserSettingsUpdate}. */
+export function applyUserSettingsUpdate(
+  current: Record<string, unknown> | undefined | null,
+  incoming: Record<string, unknown> | undefined | null
+): Record<string, unknown> {
+  return ApplyUserSettingsUpdate(current, incoming);
+}