@memberjunction/react-runtime 2.70.0

package/dist/runtime/prop-builder.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPropPaths = exports.wrapCallbacksWithLogging = exports.createPropsTransformer = exports.mergeProps = exports.validateComponentProps = exports.normalizeStyles = exports.normalizeCallbacks = exports.buildComponentProps = void 0;
+function buildComponentProps(data = {}, userState = {}, utilities = {}, callbacks = {}, components = {}, styles, options = {}) {
+    const { validate = true, transformData, transformState } = options;
+    const transformedData = transformData ? transformData(data) : data;
+    const transformedState = transformState ? transformState(userState) : userState;
+    const props = {
+        data: transformedData,
+        userState: transformedState,
+        utilities,
+        callbacks: normalizeCallbacks(callbacks),
+        components,
+        styles: normalizeStyles(styles)
+    };
+    if (validate) {
+        validateComponentProps(props);
+    }
+    return props;
+}
+exports.buildComponentProps = buildComponentProps;
+function normalizeCallbacks(callbacks) {
+    const normalized = {};
+    if (callbacks.RefreshData && typeof callbacks.RefreshData === 'function') {
+        normalized.RefreshData = callbacks.RefreshData;
+    }
+    if (callbacks.OpenEntityRecord && typeof callbacks.OpenEntityRecord === 'function') {
+        normalized.OpenEntityRecord = callbacks.OpenEntityRecord;
+    }
+    if (callbacks.UpdateUserState && typeof callbacks.UpdateUserState === 'function') {
+        normalized.UpdateUserState = callbacks.UpdateUserState;
+    }
+    if (callbacks.NotifyEvent && typeof callbacks.NotifyEvent === 'function') {
+        normalized.NotifyEvent = callbacks.NotifyEvent;
+    }
+    return normalized;
+}
+exports.normalizeCallbacks = normalizeCallbacks;
+function normalizeStyles(styles) {
+    return styles;
+}
+exports.normalizeStyles = normalizeStyles;
+function validateComponentProps(props) {
+    if (props.data === null || props.data === undefined) {
+        throw new Error('Component props.data cannot be null or undefined');
+    }
+    if (props.userState === null) {
+        throw new Error('Component props.userState cannot be null');
+    }
+    if (props.utilities === null) {
+        throw new Error('Component props.utilities cannot be null');
+    }
+    if (!props.callbacks || typeof props.callbacks !== 'object') {
+        throw new Error('Component props.callbacks must be an object');
+    }
+    for (const [key, value] of Object.entries(props.callbacks)) {
+        if (value !== undefined && typeof value !== 'function') {
+            throw new Error(`Component callback "${key}" must be a function`);
+        }
+    }
+}
+exports.validateComponentProps = validateComponentProps;
+function mergeProps(...propsList) {
+    const merged = {
+        data: {},
+        userState: {},
+        utilities: {},
+        callbacks: {},
+        components: {},
+        styles: {}
+    };
+    for (const props of propsList) {
+        if (props.data) {
+            merged.data = { ...merged.data, ...props.data };
+        }
+        if (props.userState) {
+            merged.userState = { ...merged.userState, ...props.userState };
+        }
+        if (props.utilities) {
+            merged.utilities = { ...merged.utilities, ...props.utilities };
+        }
+        if (props.callbacks) {
+            merged.callbacks = { ...merged.callbacks, ...props.callbacks };
+        }
+        if (props.components) {
+            merged.components = { ...merged.components, ...props.components };
+        }
+        if (props.styles) {
+            merged.styles = { ...merged.styles, ...props.styles };
+        }
+    }
+    return merged;
+}
+exports.mergeProps = mergeProps;
+function createPropsTransformer(transformations) {
+    return (props) => {
+        const transformed = { ...props };
+        for (const [path, transformer] of Object.entries(transformations)) {
+            const pathParts = path.split('.');
+            let current = transformed;
+            for (let i = 0; i < pathParts.length - 1; i++) {
+                if (!current[pathParts[i]]) {
+                    current[pathParts[i]] = {};
+                }
+                current = current[pathParts[i]];
+            }
+            const lastPart = pathParts[pathParts.length - 1];
+            if (current[lastPart] !== undefined) {
+                current[lastPart] = transformer(current[lastPart]);
+            }
+        }
+        return transformed;
+    };
+}
+exports.createPropsTransformer = createPropsTransformer;
+function wrapCallbacksWithLogging(callbacks, componentName) {
+    const wrapped = {};
+    if (callbacks.RefreshData) {
+        wrapped.RefreshData = () => {
+            console.log(`[${componentName}] RefreshData called`);
+            callbacks.RefreshData();
+        };
+    }
+    if (callbacks.OpenEntityRecord) {
+        wrapped.OpenEntityRecord = (entityName, key) => {
+            console.log(`[${componentName}] OpenEntityRecord called:`, { entityName, key });
+            callbacks.OpenEntityRecord(entityName, key);
+        };
+    }
+    if (callbacks.UpdateUserState) {
+        wrapped.UpdateUserState = (state) => {
+            console.log(`[${componentName}] UpdateUserState called:`, state);
+            callbacks.UpdateUserState(state);
+        };
+    }
+    if (callbacks.NotifyEvent) {
+        wrapped.NotifyEvent = (event, data) => {
+            console.log(`[${componentName}] NotifyEvent called:`, { event, data });
+            callbacks.NotifyEvent(event, data);
+        };
+    }
+    return wrapped;
+}
+exports.wrapCallbacksWithLogging = wrapCallbacksWithLogging;
+function extractPropPaths(componentCode) {
+    const paths = [];
+    const patterns = [
+        /props\.data\.(\w+)/g,
+        /props\.userState\.(\w+)/g,
+        /props\.utilities\.(\w+)/g,
+        /props\.callbacks\.(\w+)/g
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(componentCode)) !== null) {
+            paths.push(match[0]);
+        }
+    }
+    return [...new Set(paths)];
+}
+exports.extractPropPaths = extractPropPaths;

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+export interface CompiledComponent {
+    component: any;
+    id: string;
+    name: string;
+    compiledAt: Date;
+    warnings?: string[];
+}
+export interface CompileOptions {
+    componentName: string;
+    componentCode: string;
+    styles?: ComponentStyles;
+    production?: boolean;
+    babelPlugins?: string[];
+    babelPresets?: string[];
+}
+export interface ComponentStyles {
+    className?: string;
+    style?: Record<string, any>;
+    globalCss?: string;
+}
+export interface RegistryEntry {
+    component: any;
+    metadata: ComponentMetadata;
+    lastAccessed: Date;
+    refCount: number;
+}
+export interface ComponentMetadata {
+    id: string;
+    name: string;
+    version: string;
+    namespace: string;
+    registeredAt: Date;
+    tags?: string[];
+}
+export interface ComponentError {
+    message: string;
+    stack?: string;
+    componentName: string;
+    phase: 'compilation' | 'registration' | 'render' | 'runtime';
+    details?: any;
+}
+export interface ComponentProps {
+    data: any;
+    userState: any;
+    utilities: any;
+    callbacks: ComponentCallbacks;
+    components?: Record<string, any>;
+    styles?: ComponentStyles;
+}
+export interface ComponentCallbacks {
+    RefreshData?: () => void;
+    OpenEntityRecord?: (entityName: string, key: any) => void;
+    UpdateUserState?: (state: any) => void;
+    NotifyEvent?: (event: string, data: any) => void;
+}
+export interface CompilerConfig {
+    babel: {
+        presets: string[];
+        plugins: string[];
+    };
+    minify: boolean;
+    sourceMaps: boolean;
+    cache: boolean;
+    maxCacheSize: number;
+}
+export interface RegistryConfig {
+    maxComponents: number;
+    cleanupInterval: number;
+    useLRU: boolean;
+    enableNamespaces: boolean;
+}
+export interface CompilationResult {
+    success: boolean;
+    component?: CompiledComponent;
+    error?: ComponentError;
+    duration: number;
+    size?: number;
+}
+export interface RuntimeContext {
+    React: any;
+    ReactDOM?: any;
+    libraries?: Record<string, any>;
+    utilities?: Record<string, any>;
+}
+export interface ComponentLifecycle {
+    beforeMount?: () => void;
+    afterMount?: () => void;
+    beforeUpdate?: (prevProps: any, nextProps: any) => void;
+    afterUpdate?: (prevProps: any, currentProps: any) => void;
+    beforeUnmount?: () => void;
+}
+export interface ErrorBoundaryOptions {
+    onError?: (error: Error, errorInfo: any) => void;
+    fallback?: any;
+    logErrors?: boolean;
+    recovery?: 'retry' | 'reset' | 'none';
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@memberjunction/react-runtime",
+  "version": "2.70.0",
+  "description": "Platform-agnostic React component runtime for MemberJunction. Provides core compilation, registry, and execution capabilities for React components in any JavaScript environment.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:clean": "rimraf ./dist && npm run build",
+    "watch": "tsc -w",
+    "patchVersion": "npm version patch",
+    "test": "jest"
+  },
+  "keywords": [
+    "memberjunction",
+    "react",
+    "runtime",
+    "component",
+    "compiler"
+  ],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/MemberJunction/MJ/issues"
+  },
+  "homepage": "https://github.com/MemberJunction/MJ#readme",
+  "dependencies": {
+    "@babel/standalone": "^7.23.5"
+  },
+  "devDependencies": {
+    "@types/node": "20.10.0",
+    "jest": "^27.5.1",
+    "rimraf": "^3.0.2",
+    "typescript": "~5.3.3"
+  }
+}

package/src/compiler/babel-config.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Babel configuration for React component compilation.
+ * Provides default presets and plugins for transforming JSX and modern JavaScript.
+ * @module @memberjunction/react-runtime/compiler
+ */
+
+/**
+ * Default Babel presets for React compilation
+ */
+export const DEFAULT_PRESETS = [
+  'react', // Transforms JSX
+];
+
+/**
+ * Default Babel plugins for enhanced functionality
+ */
+export const DEFAULT_PLUGINS: string[] = [
+  // Add plugins as needed for specific transformations
+  // e.g., 'transform-class-properties', 'transform-optional-chaining'
+];
+
+/**
+ * Production-specific Babel configuration
+ */
+export const PRODUCTION_CONFIG = {
+  presets: DEFAULT_PRESETS,
+  plugins: [
+    ...DEFAULT_PLUGINS,
+    // Production optimizations could go here
+  ],
+  minified: true,
+  comments: false
+};
+
+/**
+ * Development-specific Babel configuration
+ */
+export const DEVELOPMENT_CONFIG = {
+  presets: DEFAULT_PRESETS,
+  plugins: [
+    ...DEFAULT_PLUGINS,
+    // Development helpers could go here
+  ],
+  sourceMaps: 'inline',
+  minified: false,
+  comments: true
+};
+
+/**
+ * Get Babel configuration based on environment
+ * @param production - Whether to use production configuration
+ * @returns Babel configuration object
+ */
+export function getBabelConfig(production: boolean = false) {
+  return production ? PRODUCTION_CONFIG : DEVELOPMENT_CONFIG;
+}
+
+/**
+ * Validates that required Babel presets are available
+ * @param babel - Babel instance to check
+ * @returns true if all required presets are available
+ */
+export function validateBabelPresets(babel: any): boolean {
+  if (!babel || !babel.availablePresets) {
+    return false;
+  }
+
+  // Check that React preset is available
+  return 'react' in babel.availablePresets;
+}
+
+/**
+ * Common JSX pragma options for different React versions
+ */
+export const JSX_PRAGMAS = {
+  classic: {
+    pragma: 'React.createElement',
+    pragmaFrag: 'React.Fragment'
+  },
+  automatic: {
+    runtime: 'automatic',
+    importSource: 'react'
+  }
+};
+
+/**
+ * Get appropriate JSX configuration based on React version
+ * @param reactVersion - React version (e.g., "18.2.0")
+ * @returns JSX configuration options
+ */
+export function getJSXConfig(reactVersion?: string) {
+  // React 17+ supports the new JSX transform
+  if (reactVersion && parseInt(reactVersion.split('.')[0]) >= 17) {
+    return JSX_PRAGMAS.automatic;
+  }
+  return JSX_PRAGMAS.classic;
+}