@memberjunction/server-bootstrap-lite

Lightweight class registrations manifest for MemberJunction server-side tools. Excludes heavy and ESM-incompatible dependencies (communication providers, storage, bizapps actions) that are unnecessary for CLI tools, CodeGen, MCP Server, and similar lightweight applications.

Overview

This package provides a pre-built class registration manifest that imports and registers all core @memberjunction/* classes needed for server-side operation, but intentionally excludes heavyweight packages that are only needed for the full MJAPI server.

graph TD
    A["server-bootstrap-lite"] --> B["Core Entity Classes"]
    A --> C["Core Action Classes"]
    A --> D["AI Engine Classes"]
    A --> E["Metadata Sync"]

    F["server-bootstrap<br/>(Full)"] --> A
    F --> G["Communication Providers"]
    F --> H["Storage Providers"]
    F --> I["BizApps Actions"]
    F --> J["Skip Integration"]

    K["CLI Tools / CodeGen"] --> A
    L["MJAPI Server"] --> F

    style A fill:#2d6a9f,stroke:#1a4971,color:#fff
    style F fill:#7c5295,stroke:#563a6b,color:#fff
    style K fill:#2d8659,stroke:#1a5c3a,color:#fff
    style L fill:#b8762f,stroke:#8a5722,color:#fff
    style G fill:#b8762f,stroke:#8a5722,color:#fff
    style H fill:#b8762f,stroke:#8a5722,color:#fff
    style I fill:#b8762f,stroke:#8a5722,color:#fff

Installation

npm install @memberjunction/server-bootstrap-lite

When to Use

Use server-bootstrap-lite instead of server-bootstrap for:

| Application | Use Lite? | Why | |-------------|-----------|-----| | MJCLI | Yes | Does not need communication/storage providers | | CodeGen (CodeGenLib, MJCodeGenAPI) | Yes | Only needs entity metadata and class registration | | MCP Server | Yes | Lightweight integration, no email/SMS needed | | A2A Server | Yes | Agent-to-agent, no UI or storage dependencies | | Custom CLI tools | Yes | Minimal footprint for scripting | | MJAPI Server | No | Needs full manifest with all providers | | MJ Explorer | No | Needs ng-bootstrap for Angular manifests |

Usage

// Import for side effects -- triggers all class registrations
import '@memberjunction/server-bootstrap-lite';

// Or import the manifest metadata
import {
  CLASS_REGISTRATIONS,
  CLASS_REGISTRATIONS_MANIFEST_LOADED,
  CLASS_REGISTRATIONS_COUNT,
  CLASS_REGISTRATIONS_PACKAGES
} from '@memberjunction/server-bootstrap-lite';

console.log(`Registered ${CLASS_REGISTRATIONS_COUNT} classes from ${CLASS_REGISTRATIONS_PACKAGES.length} packages`);

Exports

| Export | Type | Description | |--------|------|-------------| | CLASS_REGISTRATIONS | object[] | Array of class instances that create static import paths | | CLASS_REGISTRATIONS_MANIFEST_LOADED | boolean | Always true, confirms manifest was loaded | | CLASS_REGISTRATIONS_COUNT | number | Total number of registered classes | | CLASS_REGISTRATIONS_PACKAGES | string[] | List of package names included in the manifest |

How It Works

Modern bundlers (ESBuild, Vite) use tree-shaking to eliminate unused code. MemberJunction's @RegisterClass decorators rely on dynamic class instantiation via MJGlobal.ClassFactory, which bundlers cannot detect. The manifest system prevents tree-shaking by creating explicit static import paths for every decorated class.

This "lite" variant includes a curated subset of the full manifest, excluding packages that:

• Require ESM-incompatible native modules
• Pull in heavy communication SDKs (email, SMS, push)
• Include cloud storage providers
• Contain business application-specific actions

Dependencies

The lite manifest includes core MemberJunction packages for:

• Entity class registration
• Action class registration
• AI engine and model drivers
• Metadata synchronization
• Core business logic

See the full server-bootstrap package for the complete manifest including all providers.

License

ISC