@memberjunction/server-extensions-core 6.1.0-edge.6 → 6.1.0

package/README.md

@@ -1,26 +1,34 @@
 # @memberjunction/server-extensions-core
 
-Plugin architecture for MJServer that enables auto-discovery and lifecycle management of extension modules. Extensions register Express routes, handle their own authentication, and participate in health checks and graceful shutdown — all without modifying MJServer source code.
+Plugin architecture for MJServer that enables auto-discovery and lifecycle management of server extension modules. Extensions register Express routes, background workers, or WebSocket services, handle their own or MJ-managed authentication, publish and consume typed services, and participate in health checks and graceful shutdown — all without modifying MJServer source code.
+
+For complete architectural patterns and guidelines, see the **[Server Extensions Guide](../../guides/SERVER_EXTENSIONS_GUIDE.md)**.
 
 ## Overview
 
-This package provides two main exports:
+This package provides the core contracts and loader for server extensions:
 
-- **`BaseServerExtension`** — Abstract base class that all extensions implement. Defines the `Initialize`, `Shutdown`, and `HealthCheck` lifecycle methods.
-- **`ServerExtensionLoader`** — Discovers registered extension classes via MJ's `ClassFactory`, matches them to config entries, and manages their lifecycle.
+- **`BaseServerExtension`** — Abstract base class that all extensions implement. Defines `DefaultPhase`, `Initialize`, `OnAllExtensionsMounted`, `Shutdown`, and `HealthCheck` lifecycle methods.
+- **`ServerExtensionLoader`** — Discovers registered extension classes via MJ's `ClassFactory`, matches them to config entries, enforces phased mounting (`pre-auth` vs. `post-auth`), maintains the shared `ServerExtensionServiceRegistry`, and manages extension lifecycle.
+- **`ServerExtensionServiceRegistry`** — Typed registry facilitating decoupled cross-extension service discovery and telemetry sharing.
+- **`ServerExtensionInitContext`** — Unified context passed to extension `Initialize` and `OnAllExtensionsMounted` methods.
 
 Extensions are discovered automatically using MemberJunction's standard `@RegisterClass` + `ClassFactory` pattern.
 
+### Open App & Dynamic Package Discovery
 **Open App packages** listed in the host `mj.config.cjs` `dynamicPackages.server[]` declare the extensions they need:
-
 1. Named export `MJ_SERVER_EXTENSIONS` on the server package (preferred; read after the package is imported).
 2. Fallback: `package.json` → `memberjunction.serverExtensions`.
 
-`@memberjunction/server-bootstrap` collects those declarations and `serve()` merges them with the host `serverExtensions[]`. Host `DriverClass` wins (`Enabled`, `RootPath`, per-key `Settings`). A host entry with `Enabled: false` disables a discovered extension. Host-only extensions (Slack, Teams) stay in the host config.
+`@memberjunction/server-bootstrap` collects those declarations and `serve()` merges them with the host `serverExtensions[]`. Host `DriverClass` wins (`Enabled`, `RootPath`, per-key `Settings`, `Phase`). A host entry with `Enabled: false` disables a discovered extension.
 
-**Pre-auth.** Extension routes mount *before* MJServer's auth middleware. Boot logs every collected and merged extension as `PRE-AUTH` with its `DriverClass` and `RootPath` so an operator who installed an Open App for its entities can see the HTTP surface. To suppress one, add the same `DriverClass` to host `serverExtensions[]` with `Enabled: false`. Invalid `RootPath` values (`/`, `/graphql`, `/auth`, `/oauth`, `/health`, `/magic-link`, wildcards) are dropped fail-closed rather than mounted. Matching is **case-insensitive** (Express routing is) and `serve()` also passes the process's real mounts (`graphqlRootPath`, `/healthcheck`, `/esignature`, `/media`, widget, telephony, …) so a custom GraphQL root or a core path not in the static baseline cannot be claimed. Overlapping enabled roots (including case variants) are logged.
+### Lifecycle Phases (G1)
+Extensions declare their execution phase or inherit their class default:
+- **`'pre-auth'`** (Default): Mounted **before** MJServer authentication middleware. Used for external webhooks that carry provider signatures (Slack HMAC, Teams Bot Framework JWT, Twilio signatures, WebRTC SDP brokers).
+- **`'post-auth'`**: Mounted **after** MJServer authentication middleware (`createUnifiedAuthMiddleware`). Guaranteed to have authenticated `req.user` context.
 
-Open Apps therefore do **not** require the operator to copy extension blocks into the host `mj.config.cjs`. The host file is the override layer plus host-only extensions.
+### Reserved Root Path Safety (G2)
+Core system paths cannot be claimed by server extensions: `/`, `/graphql`, `/auth`, `/oauth`, `/health`, `/magic-link`, `/schema`, `/media`, `/mcp`. Configured roots matching these reserved paths fail closed and are dropped with an error.
 
 ## Installation
 
@@ -33,30 +41,46 @@ npm install @memberjunction/server-extensions-core
 ### 1. Create an Extension
 
 ```typescript
-import { Application } from 'express';
+import { Router } from 'express';
 import { RegisterClass } from '@memberjunction/global';
 import {
     BaseServerExtension,
-    ServerExtensionConfig,
+    ServerExtensionInitContext,
+    ServerExtensionPhase,
     ExtensionInitResult,
     ExtensionHealthResult
 } from '@memberjunction/server-extensions-core';
 
 @RegisterClass(BaseServerExtension, 'MyCustomExtension')
 export class MyCustomExtension extends BaseServerExtension {
-    async Initialize(app: Application, config: ServerExtensionConfig): Promise<ExtensionInitResult> {
-        // Register your Express routes
-        app.get(config.RootPath + '/hello', (_req, res) => {
+    /** Declare lifecycle phase */
+    public override get DefaultPhase(): ServerExtensionPhase {
+        return 'pre-auth';
+    }
+
+    async Initialize(context: ServerExtensionInitContext): Promise<ExtensionInitResult> {
+        const { app, config, services } = context;
+
+        const router = Router();
+        router.get('/hello', (_req, res) => {
             res.json({ message: 'Hello from my extension!' });
         });
 
+        app.use(config.RootPath, router);
+
         return {
             Success: true,
             Message: 'Custom extension loaded',
-            RegisteredRoutes: [`GET ${config.RootPath}/hello`]
+            RegisteredRoutes: [`GET ${config.RootPath}/hello`],
+            Service: { ping: () => 'pong' } // Auto-registered into ServerExtensionServiceRegistry
         };
     }
 
+    async OnAllExtensionsMounted(context: ServerExtensionInitContext): Promise<void> {
+        // Cross-extension service wiring
+        const telephony = context.services.GetService('TwilioTelephonyService');
+    }
+
     async Shutdown(): Promise<void> {
         // Clean up connections, drain requests, release resources
     }
@@ -67,38 +91,17 @@ export class MyCustomExtension extends BaseServerExtension {
 }
 ```
 
-### 2. Declare the extension (Open App **or** host)
-
-An Open App server package publishes the default config (so installing the app is enough):
-
-```typescript
-// packages/Server/src/index.ts
-export const MJ_SERVER_EXTENSIONS = [
-    { Enabled: true, DriverClass: 'MyCustomExtension', RootPath: '/api/my-extension', Settings: {} },
-];
-```
-
-```json
-// packages/Server/package.json
-{
-  "memberjunction": {
-    "serverExtensions": [
-      { "Enabled": true, "DriverClass": "MyCustomExtension", "RootPath": "/api/my-extension", "Settings": {} }
-    ]
-  }
-}
-```
-
-A **host** `mj.config.cjs` is only needed to override that default, to disable it, or to load a host-only extension (not shipped by an Open App):
+### 2. Configure in `mj.config.cjs`
 
 ```javascript
 module.exports = {
-    // ... other MJServer config ...
     serverExtensions: [
         {
+            Name: 'MyExtension',
             Enabled: true,
             DriverClass: 'MyCustomExtension',
             RootPath: '/api/my-extension',
+            Phase: 'pre-auth',
             Settings: {
                 apiKey: process.env.MY_EXTENSION_API_KEY,
             }
@@ -107,101 +110,65 @@ module.exports = {
 };
 ```
 
-### 3. Import Your Extension Package
-
-Ensure your extension package is imported in your application so the `@RegisterClass` decorator fires at module load time. Add it as a dependency in your MJAPI project.
-
 ## API Reference
 
 ### `BaseServerExtension`
 
-Abstract base class for all server extensions.
-
-| Method | Description |
-|--------|-------------|
-| `Initialize(app, config)` | Called once at MJServer startup. Register routes, open connections. |
-| `Shutdown()` | Called during graceful shutdown (SIGTERM/SIGINT). Clean up resources. |
+| Member | Description |
+|---|---|
+| `DefaultPhase` | Getter returning default lifecycle phase (`'pre-auth'` or `'post-auth'`). Default is `'pre-auth'`. |
+| `Initialize(context)` | Called once at MJServer startup. Receives `ServerExtensionInitContext`. |
+| `OnAllExtensionsMounted?(context)` | Optional hook called after all extensions across both phases have mounted. Ideal for service wiring. |
+| `Shutdown()` | Called during graceful shutdown (SIGTERM/SIGINT). |
 | `HealthCheck()` | Called periodically. Return health status quickly (< 100ms). |
-| `OnConfigurationChange?(config)` | Optional. Called when config changes at runtime. |
+| `OnConfigurationChange?(config)` | Optional. Called when configuration changes at runtime. |
 
 ### `ServerExtensionLoader`
 
-Manages the extension lifecycle.
-
-| Method | Description |
-|--------|-------------|
-| `LoadExtensions(app, configs)` | Discover and initialize all enabled extensions from config. |
-| `HealthCheckAll()` | Run health checks on all loaded extensions. |
+| Member | Description |
+|---|---|
+| `Services` | Access the unified `ServerExtensionServiceRegistry`. |
+| `LoadExtensions(app, configs, options?)` | Discover and initialize extensions filtered by phase (`pre-auth` or `post-auth`). |
+| `NotifyAllExtensionsMounted(options?)` | Invoke `OnAllExtensionsMounted` on all loaded extensions. |
+| `HealthCheckAll()` | Run health checks across all loaded extensions. |
 | `ShutdownAll()` | Shut down all extensions in reverse order (LIFO). |
 | `Extensions` | Read-only array of loaded extension instances. |
-| `ExtensionCount` | Number of currently loaded extensions. |
 
 ### Type Interfaces
 
-#### `ServerExtensionConfig`
-
 ```typescript
-interface ServerExtensionConfig {
-    Enabled: boolean;        // Skip loading if false
-    DriverClass: string;     // Must match @RegisterClass key
-    RootPath: string;        // URL prefix for extension routes
-    Settings: Record<string, unknown>;  // Extension-specific config
+export type ServerExtensionPhase = 'pre-auth' | 'post-auth';
+
+export interface ServerExtensionConfig {
+    Name?: string;
+    DriverClass: string;
+    RootPath: string;
+    Enabled: boolean;
+    Phase?: ServerExtensionPhase;
+    Settings?: Record<string, unknown>;
+    PackagePath?: string;
 }
-```
 
-#### `ExtensionInitResult`
+export interface ServerExtensionInitContext {
+    app: Application;
+    httpServer?: Server;
+    config: ServerExtensionConfig;
+    publicUrl?: string;
+    services: ServerExtensionServiceRegistry;
+    phase: ServerExtensionPhase;
+}
 
-```typescript
-interface ExtensionInitResult {
+export interface ExtensionInitResult {
     Success: boolean;
     Message: string;
     RegisteredRoutes?: string[];
+    Service?: object;
+    Skipped?: boolean;
 }
 ```
 
-#### `ExtensionHealthResult`
-
-```typescript
-interface ExtensionHealthResult {
-    Healthy: boolean;
-    Name: string;
-    Details?: Record<string, unknown>;
-}
-```
-
-## Lifecycle
-
-1. MJServer merges Open App–discovered `serverExtensions[]` with the host `mj.config.cjs` list (host `DriverClass` wins)
-2. For each enabled entry, `ServerExtensionLoader` uses `ClassFactory.CreateInstance(BaseServerExtension, driverClass)` to find the registered class
-3. Creates an instance and calls `Initialize(app, config)`
-4. Extension registers its Express routes under `config.RootPath`
-5. MJServer exposes `GET /health/extensions` for aggregate health checks
-6. On SIGTERM/SIGINT, `ShutdownAll()` calls each extension's `Shutdown()` in reverse order
-
-## Error Handling
-
-- Extensions that fail to initialize are logged and skipped — they don't prevent other extensions from loading
-- Health check exceptions are caught and reported as unhealthy
-- Shutdown exceptions are logged but don't prevent other extensions from shutting down
-
-## Authentication
-
-Extensions handle their own authentication by default. Common patterns:
-
-- **Platform-specific auth** (Slack HMAC signatures, Teams Bot Framework JWT)
-- **MJServer auth middleware** — import from `@memberjunction/server` if you want to reuse MJServer's built-in auth
-- **Custom auth** — API keys, OAuth, etc.
-
-This is opt-in — extensions are not forced to use MJServer's auth middleware.
-
-## Testing
-
-```bash
-npm run test        # Run all tests
-npm run test:watch  # Watch mode
-```
-
 ## Related Packages
 
 - [`@memberjunction/messaging-adapters`](../MessagingAdapters/) — Slack and Teams adapters built on this framework
-- [`@memberjunction/server`](../MJServer/) — MJServer that loads and manages extensions
+- [`@memberjunction/server`](../MJServer/) — Core server hosting the extension lifecycle
+- [`guides/SERVER_EXTENSIONS_GUIDE.md`](../../guides/SERVER_EXTENSIONS_GUIDE.md) — Comprehensive developer guide

package/dist/BaseServerExtension.d.ts

@@ -3,7 +3,7 @@
  * @description Abstract base class for MJServer extensions.
  */
 import { Application } from 'express';
-import { ServerExtensionConfig, ExtensionInitResult, ExtensionHealthResult } from './types.js';
+import { ServerExtensionConfig, ServerExtensionPhase, ServerExtensionInitContext, ExtensionInitResult, ExtensionHealthResult } from './types.js';
 /**
  * Abstract base class for MJServer extensions.
  *
@@ -18,62 +18,32 @@ import { ServerExtensionConfig, ExtensionInitResult, ExtensionHealthResult } fro
  * 1. MJServer loads the merged `serverExtensions[]` (Open App packages + host overlay)
  * 2. For each enabled entry, looks up `@RegisterClass(BaseServerExtension, driverClass)`
  * 3. Creates instance via `ClassFactory.CreateInstance()`
- * 4. Calls `Initialize(app, config)` — extension registers routes
- * 5. Periodic `HealthCheck()` calls for monitoring
- * 6. On server shutdown, calls `Shutdown()` for cleanup
- *
- * ## Usage
- *
- * ```typescript
- * import { RegisterClass } from '@memberjunction/global';
- * import { BaseServerExtension, ServerExtensionConfig, ExtensionInitResult } from '@memberjunction/server-extensions-core';
- *
- * @RegisterClass(BaseServerExtension, 'MyCustomExtension')
- * export class MyCustomExtension extends BaseServerExtension {
- *     async Initialize(app: Application, config: ServerExtensionConfig): Promise<ExtensionInitResult> {
- *         app.get(config.RootPath + '/hello', (_req, res) => {
- *             res.json({ message: 'Hello from my extension!' });
- *         });
- *         return { Success: true, Message: 'Custom extension loaded', RegisteredRoutes: [`GET ${config.RootPath}/hello`] };
- *     }
- *
- *     async Shutdown(): Promise<void> {
- *         // Clean up resources
- *     }
- *
- *     async HealthCheck(): Promise<ExtensionHealthResult> {
- *         return { Healthy: true, Name: 'MyCustomExtension' };
- *     }
- * }
- * ```
- *
- * ## Auth Middleware
- *
- * Extensions handle their own authentication by default. If you want to leverage
- * MJServer's built-in auth middleware, import it from `@memberjunction/server`:
- *
- * ```typescript
- * import { getSystemUser, verifyUserRecord } from '@memberjunction/server';
- * ```
- *
- * This is opt-in — extensions like Slack/Teams use platform-specific auth
- * (signature verification, Bot Framework JWT) instead.
+ * 4. Calls `Initialize(context)` (or legacy `Initialize(app, config)`) — extension registers routes
+ * 5. After all extensions across both pre-auth and post-auth phases are mounted,
+ *    calls `OnAllExtensionsMounted(context)` if implemented
+ * 6. Periodic `HealthCheck()` calls for monitoring
+ * 7. On server shutdown, calls `Shutdown()` for cleanup
  */
 export declare abstract class BaseServerExtension {
+    /**
+     * Default lifecycle phase for this extension when unspecified in configuration.
+     * Defaults to `'pre-auth'` for backwards compatibility.
+     */
+    get DefaultPhase(): ServerExtensionPhase;
     /**
      * Initialize the extension. Called once during MJServer startup.
      *
-     * Use this to register Express routes, set up WebSocket handlers,
-     * initialize connections, and prepare the extension for operation.
-     *
-     * @param app - The Express application instance to register routes on.
-     *              Routes should be registered under `config.RootPath`.
-     * @param config - Extension-specific configuration from `mj.config.cjs`.
-     *                 The `Settings` object contains extension-specific config.
-     * @returns A result indicating whether initialization succeeded.
-     *          On failure, the extension is skipped but other extensions still load.
+     * Supports both modern context-based signature:
+     *   `Initialize(context: ServerExtensionInitContext): Promise<ExtensionInitResult>`
+     * and legacy 2-argument signature:
+     *   `Initialize(app: Application, config: ServerExtensionConfig): Promise<ExtensionInitResult>`
+     */
+    abstract Initialize(contextOrApp: ServerExtensionInitContext | Application, config?: ServerExtensionConfig): Promise<ExtensionInitResult>;
+    /**
+     * Optional lifecycle hook called after ALL extensions have been mounted across all phases.
+     * Ideal for cross-extension service wiring (e.g. connecting a webhook router to a telephony service).
      */
-    abstract Initialize(app: Application, config: ServerExtensionConfig): Promise<ExtensionInitResult>;
+    OnAllExtensionsMounted?(context: ServerExtensionInitContext): Promise<void>;
     /**
      * Graceful shutdown. Called when MJServer is shutting down (SIGTERM/SIGINT).
      *

package/dist/BaseServerExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseServerExtension.d.ts","sourceRoot":"","sources":["../src/BaseServerExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,8BAAsB,mBAAmB;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAElG;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAEtD;;;;;;;;OAQG;IACH,qBAAqB,CAAC,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC1E"}
+{"version":3,"file":"BaseServerExtension.d.ts","sourceRoot":"","sources":["../src/BaseServerExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,mBAAmB;IACrC;;;OAGG;IACH,IAAW,YAAY,IAAI,oBAAoB,CAE9C;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CACf,YAAY,EAAE,0BAA0B,GAAG,WAAW,EACtD,MAAM,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAE/B;;;OAGG;IACH,sBAAsB,CAAC,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3E;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAEtD;;;;;;;;OAQG;IACH,qBAAqB,CAAC,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC1E"}

package/dist/BaseServerExtension.js

@@ -16,47 +16,19 @@
  * 1. MJServer loads the merged `serverExtensions[]` (Open App packages + host overlay)
  * 2. For each enabled entry, looks up `@RegisterClass(BaseServerExtension, driverClass)`
  * 3. Creates instance via `ClassFactory.CreateInstance()`
- * 4. Calls `Initialize(app, config)` — extension registers routes
- * 5. Periodic `HealthCheck()` calls for monitoring
- * 6. On server shutdown, calls `Shutdown()` for cleanup
- *
- * ## Usage
- *
- * ```typescript
- * import { RegisterClass } from '@memberjunction/global';
- * import { BaseServerExtension, ServerExtensionConfig, ExtensionInitResult } from '@memberjunction/server-extensions-core';
- *
- * @RegisterClass(BaseServerExtension, 'MyCustomExtension')
- * export class MyCustomExtension extends BaseServerExtension {
- *     async Initialize(app: Application, config: ServerExtensionConfig): Promise<ExtensionInitResult> {
- *         app.get(config.RootPath + '/hello', (_req, res) => {
- *             res.json({ message: 'Hello from my extension!' });
- *         });
- *         return { Success: true, Message: 'Custom extension loaded', RegisteredRoutes: [`GET ${config.RootPath}/hello`] };
- *     }
- *
- *     async Shutdown(): Promise<void> {
- *         // Clean up resources
- *     }
- *
- *     async HealthCheck(): Promise<ExtensionHealthResult> {
- *         return { Healthy: true, Name: 'MyCustomExtension' };
- *     }
- * }
- * ```
- *
- * ## Auth Middleware
- *
- * Extensions handle their own authentication by default. If you want to leverage
- * MJServer's built-in auth middleware, import it from `@memberjunction/server`:
- *
- * ```typescript
- * import { getSystemUser, verifyUserRecord } from '@memberjunction/server';
- * ```
- *
- * This is opt-in — extensions like Slack/Teams use platform-specific auth
- * (signature verification, Bot Framework JWT) instead.
+ * 4. Calls `Initialize(context)` (or legacy `Initialize(app, config)`) — extension registers routes
+ * 5. After all extensions across both pre-auth and post-auth phases are mounted,
+ *    calls `OnAllExtensionsMounted(context)` if implemented
+ * 6. Periodic `HealthCheck()` calls for monitoring
+ * 7. On server shutdown, calls `Shutdown()` for cleanup
  */
 export class BaseServerExtension {
+    /**
+     * Default lifecycle phase for this extension when unspecified in configuration.
+     * Defaults to `'pre-auth'` for backwards compatibility.
+     */
+    get DefaultPhase() {
+        return 'pre-auth';
+    }
 }
 //# sourceMappingURL=BaseServerExtension.js.map

package/dist/BaseServerExtension.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseServerExtension.js","sourceRoot":"","sources":["../src/BaseServerExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,OAAgB,mBAAmB;CA+CxC"}
+{"version":3,"file":"BaseServerExtension.js","sourceRoot":"","sources":["../src/BaseServerExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAgB,mBAAmB;IACrC;;;OAGG;IACH,IAAW,YAAY;QACnB,OAAO,UAAU,CAAC;IACtB,CAAC;CAoDJ"}

package/dist/ServerExtensionLoader.d.ts

@@ -1,10 +1,34 @@
-/**
- * @module @memberjunction/server-extensions-core
- * @description Discovers, initializes, and manages server extensions.
- */
 import { Application } from 'express';
+import type { Server as HttpServer } from 'http';
 import { BaseServerExtension } from './BaseServerExtension.js';
-import { ServerExtensionConfig, ExtensionHealthResult } from './types.js';
+import { ServerExtensionConfig, ServerExtensionPhase, ServerExtensionServiceRegistry, ExtensionHealthResult } from './types.js';
+/**
+ * In-memory implementation of the ServerExtensionServiceRegistry.
+ */
+export declare class DefaultServerExtensionServiceRegistry implements ServerExtensionServiceRegistry {
+    private _services;
+    RegisterService<T extends object>(key: string, service: T): void;
+    GetService<T extends object>(key: string): T | undefined;
+    HasService(key: string): boolean;
+    GetAllServices(): ReadonlyMap<string, object>;
+}
+/**
+ * Options passed to `ServerExtensionLoader.LoadExtensions()`.
+ */
+export interface LoadExtensionsOptions {
+    /**
+     * Optional filter for lifecycle phase.
+     * When provided, only extensions matching this phase are initialized.
+     * An extension's phase is `config.Phase ?? instance.DefaultPhase`.
+     */
+    phase?: ServerExtensionPhase;
+    /** Node HTTP/HTTPS server instance (for WebSockets, media streaming, etc.). */
+    httpServer?: HttpServer;
+    /** Canonical public base URL of the MJ server. */
+    publicUrl?: string;
+    /** Custom service registry if not using the loader's default. */
+    services?: ServerExtensionServiceRegistry;
+}
 /**
  * Discovers, initializes, and manages the lifecycle of server extensions.
  *
@@ -13,30 +37,16 @@ import { ServerExtensionConfig, ExtensionHealthResult } from './types.js';
  * `mj.config.cjs` `serverExtensions[]`), uses MJ's `ClassFactory` to find
  * registered extension classes, and calls `Initialize()` on each.
  *
- * ## Discovery Flow
- *
- * 1. Receives the merged `serverExtensions[]` (discovered Open App packages + host overlay)
- * 2. For each enabled entry, uses `ClassFactory.CreateInstance(BaseServerExtension, driverClass)`
- * 3. Creates an instance and calls `Initialize(app, config)`
- * 4. Tracks all loaded extensions for health checks and shutdown
- *
- * ## Usage
- *
- * ```typescript
- * import { ServerExtensionLoader } from '@memberjunction/server-extensions-core';
- *
- * const loader = new ServerExtensionLoader();
- * await loader.LoadExtensions(app, configInfo.serverExtensions);
- *
- * // Health check
- * const health = await loader.HealthCheckAll();
- *
- * // Graceful shutdown
- * await loader.ShutdownAll();
- * ```
+ * Supports phased loading (pre-auth ahead of JWT middleware, post-auth behind it)
+ * and cross-extension service lookup and registration.
  */
 export declare class ServerExtensionLoader {
     private _loadedExtensions;
+    private _services;
+    /**
+     * The shared service registry for cross-extension service lookup and registration.
+     */
+    get Services(): ServerExtensionServiceRegistry;
     /**
      * Load and initialize all enabled extensions from config.
      *
@@ -46,8 +56,17 @@ export declare class ServerExtensionLoader {
      *
      * @param app - Express application for route registration.
      * @param extensionConfigs - Array of extension configs from `mj.config.cjs`.
+     * @param options - Phased loading, HTTP server, and URL options.
+     */
+    LoadExtensions(app: Application, extensionConfigs: ServerExtensionConfig[], options?: LoadExtensionsOptions): Promise<void>;
+    /**
+     * Notify all loaded extensions across all phases that all extensions have been mounted.
+     * Calls `OnAllExtensionsMounted(context)` on each extension that implements it.
      */
-    LoadExtensions(app: Application, extensionConfigs: ServerExtensionConfig[]): Promise<void>;
+    NotifyAllExtensionsMounted(options?: {
+        httpServer?: HttpServer;
+        publicUrl?: string;
+    }): Promise<void>;
     /**
      * Run health checks on all loaded extensions.
      *
@@ -73,6 +92,7 @@ export declare class ServerExtensionLoader {
     get Extensions(): ReadonlyArray<{
         Instance: BaseServerExtension;
         DriverClass: string;
+        Config: ServerExtensionConfig;
     }>;
     /**
      * Get the number of currently loaded extensions.

package/dist/ServerExtensionLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerExtensionLoader.d.ts","sourceRoot":"","sources":["../src/ServerExtensionLoader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,YAAY,CAAC;AAgBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,iBAAiB,CAAyB;IAElD;;;;;;;;;OASG;IACU,cAAc,CACvB,GAAG,EAAE,WAAW,EAChB,gBAAgB,EAAE,qBAAqB,EAAE,GAC1C,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;;;;;OAOG;IACU,cAAc,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAmB/D;;;;;;OAMG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAczC;;;;OAIG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC;QAAE,QAAQ,EAAE,mBAAmB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7F;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,CAElC;IAED;;;;;;OAMG;YACW,mBAAmB;CA+CpC"}
+{"version":3,"file":"ServerExtensionLoader.d.ts","sourceRoot":"","sources":["../src/ServerExtensionLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAG9B,qBAAqB,EACxB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,qCAAsC,YAAW,8BAA8B;IACxF,OAAO,CAAC,SAAS,CAA6B;IAEvC,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAWhE,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIxD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;CAGvD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAmBD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,SAAS,CAA+E;IAEhG;;OAEG;IACH,IAAW,QAAQ,IAAI,8BAA8B,CAEpD;IAED;;;;;;;;;;OAUG;IACU,cAAc,CACvB,GAAG,EAAE,WAAW,EAChB,gBAAgB,EAAE,qBAAqB,EAAE,EACzC,OAAO,CAAC,EAAE,qBAAqB,GAChC,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;OAGG;IACU,0BAA0B,CAAC,OAAO,CAAC,EAAE;QAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjB;;;;;;;OAOG;IACU,cAAc,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAmB/D;;;;;;OAMG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAczC;;;;OAIG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC;QAAE,QAAQ,EAAE,mBAAmB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAE5H;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,CAElC;IAED;;;;;;OAMG;YACW,mBAAmB;CAuFpC"}

package/dist/ServerExtensionLoader.js

@@ -1,10 +1,33 @@
-/**
- * @module @memberjunction/server-extensions-core
- * @description Discovers, initializes, and manages server extensions.
- */
 import { MJGlobal } from '@memberjunction/global';
 import { LogError, LogStatus, LogStatusEx } from '@memberjunction/core';
 import { BaseServerExtension } from './BaseServerExtension.js';
+/**
+ * In-memory implementation of the ServerExtensionServiceRegistry.
+ */
+export class DefaultServerExtensionServiceRegistry {
+    constructor() {
+        this._services = new Map();
+    }
+    RegisterService(key, service) {
+        const trimmed = key.trim();
+        if (!trimmed) {
+            throw new Error('Service key cannot be empty');
+        }
+        if (this._services.has(trimmed)) {
+            LogStatus(`Service '${trimmed}' is already registered in ServerExtensionServiceRegistry; replacing with new instance`);
+        }
+        this._services.set(trimmed, service);
+    }
+    GetService(key) {
+        return this._services.get(key.trim());
+    }
+    HasService(key) {
+        return this._services.has(key.trim());
+    }
+    GetAllServices() {
+        return this._services;
+    }
+}
 /**
  * Discovers, initializes, and manages the lifecycle of server extensions.
  *
@@ -13,31 +36,19 @@ import { BaseServerExtension } from './BaseServerExtension.js';
  * `mj.config.cjs` `serverExtensions[]`), uses MJ's `ClassFactory` to find
  * registered extension classes, and calls `Initialize()` on each.
  *
- * ## Discovery Flow
- *
- * 1. Receives the merged `serverExtensions[]` (discovered Open App packages + host overlay)
- * 2. For each enabled entry, uses `ClassFactory.CreateInstance(BaseServerExtension, driverClass)`
- * 3. Creates an instance and calls `Initialize(app, config)`
- * 4. Tracks all loaded extensions for health checks and shutdown
- *
- * ## Usage
- *
- * ```typescript
- * import { ServerExtensionLoader } from '@memberjunction/server-extensions-core';
- *
- * const loader = new ServerExtensionLoader();
- * await loader.LoadExtensions(app, configInfo.serverExtensions);
- *
- * // Health check
- * const health = await loader.HealthCheckAll();
- *
- * // Graceful shutdown
- * await loader.ShutdownAll();
- * ```
+ * Supports phased loading (pre-auth ahead of JWT middleware, post-auth behind it)
+ * and cross-extension service lookup and registration.
  */
 export class ServerExtensionLoader {
     constructor() {
         this._loadedExtensions = [];
+        this._services = new DefaultServerExtensionServiceRegistry();
+    }
+    /**
+     * The shared service registry for cross-extension service lookup and registration.
+     */
+    get Services() {
+        return this._services;
     }
     /**
      * Load and initialize all enabled extensions from config.
@@ -48,23 +59,51 @@ export class ServerExtensionLoader {
      *
      * @param app - Express application for route registration.
      * @param extensionConfigs - Array of extension configs from `mj.config.cjs`.
+     * @param options - Phased loading, HTTP server, and URL options.
      */
-    async LoadExtensions(app, extensionConfigs) {
+    async LoadExtensions(app, extensionConfigs, options) {
         if (!extensionConfigs || extensionConfigs.length === 0) {
-            // Nothing configured — stay silent (the "Loaded 0 server extension(s)"
-            // / "No server extensions configured" chatter was pure noise).
             return;
         }
+        let loadedCountThisPass = 0;
         for (const config of extensionConfigs) {
             if (!config.Enabled) {
                 LogStatus(`Server extension '${config.DriverClass}' is disabled, skipping`);
                 continue;
             }
-            await this.loadSingleExtension(app, config);
+            const loaded = await this.loadSingleExtension(app, config, options);
+            if (loaded) {
+                loadedCountThisPass++;
+            }
         }
-        // Only announce when something was actually loaded.
-        if (this._loadedExtensions.length > 0) {
-            LogStatus(`Loaded ${this._loadedExtensions.length} server extension(s)`);
+        if (loadedCountThisPass > 0) {
+            const phaseLabel = options?.phase ? ` (${options.phase})` : '';
+            LogStatus(`Loaded ${loadedCountThisPass} server extension(s)${phaseLabel}`);
+        }
+    }
+    /**
+     * Notify all loaded extensions across all phases that all extensions have been mounted.
+     * Calls `OnAllExtensionsMounted(context)` on each extension that implements it.
+     */
+    async NotifyAllExtensionsMounted(options) {
+        for (const ext of this._loadedExtensions) {
+            if (typeof ext.Instance.OnAllExtensionsMounted === 'function') {
+                try {
+                    const context = {
+                        app: ext.Context.app,
+                        httpServer: options?.httpServer ?? ext.Context.httpServer,
+                        config: ext.Config,
+                        publicUrl: options?.publicUrl ?? ext.Context.publicUrl,
+                        services: this._services,
+                        phase: ext.Config.Phase ?? ext.Instance.DefaultPhase ?? 'pre-auth',
+                    };
+                    await ext.Instance.OnAllExtensionsMounted(context);
+                    LogStatus(`Server extension '${ext.DriverClass}' OnAllExtensionsMounted completed`);
+                }
+                catch (error) {
+                    LogError(`Error in OnAllExtensionsMounted for extension '${ext.DriverClass}':`, undefined, error);
+                }
+            }
         }
     }
     /**
@@ -134,11 +173,15 @@ export class ServerExtensionLoader {
      * creates an instance, and calls `Initialize()`. On failure, logs the error and
      * continues without throwing.
      */
-    async loadSingleExtension(app, config) {
+    async loadSingleExtension(app, config, options) {
         const driverClass = config.DriverClass;
         if (!driverClass) {
             LogError('Server extension config missing DriverClass, skipping');
-            return;
+            return false;
+        }
+        // Avoid re-loading an extension that was already loaded in a previous phase
+        if (this._loadedExtensions.some((e) => e.DriverClass === driverClass)) {
+            return false;
         }
         try {
             // Use MJ's ClassFactory to find the registered extension class
@@ -147,28 +190,60 @@ export class ServerExtensionLoader {
                 LogError(`Server extension '${driverClass}' not found in ClassFactory. ` +
                     `Ensure the package is imported and the class uses ` +
                     `@RegisterClass(BaseServerExtension, '${driverClass}')`);
-                return;
+                return false;
+            }
+            const effectivePhase = config.Phase ?? instance.DefaultPhase ?? 'pre-auth';
+            // If a specific phase filter is requested and this extension doesn't match, skip for now
+            if (options?.phase && options.phase !== effectivePhase) {
+                return false;
+            }
+            const services = options?.services ?? this._services;
+            const context = {
+                app,
+                httpServer: options?.httpServer,
+                config: { ...config, Phase: effectivePhase },
+                publicUrl: options?.publicUrl,
+                services,
+                phase: effectivePhase,
+            };
+            let result;
+            if (instance.Initialize.length >= 2) {
+                result = await instance.Initialize(app, config);
+            }
+            else {
+                result = await instance.Initialize(context);
             }
-            const result = await instance.Initialize(app, config);
             if (result.Success) {
-                this._loadedExtensions.push({ Instance: instance, Config: config, DriverClass: driverClass });
-                LogStatus(`Server extension '${driverClass}' initialized: ${result.Message}`);
+                if (result.Service) {
+                    services.RegisterService(driverClass, result.Service);
+                }
+                this._loadedExtensions.push({
+                    Instance: instance,
+                    Config: { ...config, Phase: effectivePhase },
+                    DriverClass: driverClass,
+                    Context: context,
+                });
+                LogStatus(`Server extension '${driverClass}' initialized (${effectivePhase}): ${result.Message}`);
                 if (result.RegisteredRoutes && result.RegisteredRoutes.length > 0) {
                     LogStatus(`  Routes: ${result.RegisteredRoutes.join(', ')}`);
                 }
+                return true;
             }
             else if (result.Skipped) {
                 LogStatusEx({
                     message: `Server extension '${driverClass}' skipped: ${result.Message}`,
                     verboseOnly: true
                 });
+                return false;
             }
             else {
                 LogError(`Server extension '${driverClass}' failed to initialize: ${result.Message}`);
+                return false;
             }
         }
         catch (error) {
             LogError(`Error loading server extension '${driverClass}':`, undefined, error);
+            return false;
         }
     }
 }

package/dist/ServerExtensionLoader.js.map

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

package/dist/collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../src/collect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE,iFAAiF;AACjF,eAAO,MAAM,sCAAsC,oCAAoC,CAAC;AAExF,MAAM,WAAW,+BAA+B;IAC5C,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAeD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC3C,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAwDzB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAQzB;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAClD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAYzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC/D,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC1D,qBAAqB,EAAE,CAuCzB;AAED,+GAA+G;AAC/G,eAAO,MAAM,+BAA+B,EAAE,SAAS,MAAM,EAAU,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,uCAAuC,EAAE,SAAS,MAAM,EAMpE,CAAC;AAEF,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAezD;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,GAAG,IAAI,CAkCf;AAED,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAOzE;AAED,MAAM,WAAW,6BAA8B,SAAQ,+BAA+B;IAClF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC5D,OAAO,CAAC,EAAE,6BAA6B,GACxC,qBAAqB,EAAE,CAsBzB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAGlF"}
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../src/collect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE,iFAAiF;AACjF,eAAO,MAAM,sCAAsC,oCAAoC,CAAC;AAExF,MAAM,WAAW,+BAA+B;IAC5C,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAgBD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC3C,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAiEzB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAQzB;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAClD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,+BAA+B,GAC1C,qBAAqB,EAAE,CAYzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC/D,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC1D,qBAAqB,EAAE,CAwCzB;AAED,+GAA+G;AAC/G,eAAO,MAAM,+BAA+B,EAAE,SAAS,MAAM,EAAU,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,uCAAuC,EAAE,SAAS,MAAM,EAMpE,CAAC;AAEF,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAezD;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAC3C,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,GAAG,IAAI,CAkCf;AAED,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAOzE;AAED,MAAM,WAAW,6BAA8B,SAAQ,+BAA+B;IAClF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC5D,OAAO,CAAC,EAAE,6BAA6B,GACxC,qBAAqB,EAAE,CAsBzB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAIlF"}

package/dist/collect.js

@@ -17,6 +17,7 @@ function cloneConfig(config) {
         Enabled: config.Enabled,
         DriverClass: config.DriverClass,
         RootPath: config.RootPath,
+        Phase: config.Phase,
         Settings: { ...(config.Settings ?? {}) },
     };
 }
@@ -68,6 +69,15 @@ export function normalizeServerExtensionConfigs(raw, options) {
             }
             enabled = rec.Enabled;
         }
+        let phase = undefined;
+        if (rec.Phase !== undefined) {
+            if (rec.Phase === 'pre-auth' || rec.Phase === 'post-auth') {
+                phase = rec.Phase;
+            }
+            else {
+                invalid(options, `serverExtensions[${i}] ('${driverClass}') Phase must be 'pre-auth' or 'post-auth'${source}`);
+            }
+        }
         const settings = rec.Settings != null && typeof rec.Settings === 'object' && !Array.isArray(rec.Settings)
             ? { ...rec.Settings }
             : {};
@@ -78,6 +88,7 @@ export function normalizeServerExtensionConfigs(raw, options) {
             Enabled: enabled,
             DriverClass: driverClass,
             RootPath: rootPath,
+            Phase: phase,
             Settings: settings,
         });
     }
@@ -150,6 +161,7 @@ export function mergeServerExtensionConfigs(discovered, host) {
             Enabled: entry.Enabled ?? existing.Enabled,
             DriverClass: key,
             RootPath: hostRoot || existing.RootPath,
+            Phase: entry.Phase ?? existing.Phase,
             Settings: { ...(existing.Settings ?? {}), ...(entry.Settings ?? {}) },
         });
     }
@@ -269,6 +281,7 @@ export function prepareServerExtensionConfigs(configs, options) {
  */
 export function describeServerExtensionMount(config) {
     const state = config.Enabled ? 'enabled' : 'disabled';
-    return `${config.DriverClass} at ${config.RootPath} (${state}, PRE-AUTH; host mj.config.cjs serverExtensions[] can set Enabled: false to suppress)`;
+    const phase = (config.Phase ?? 'pre-auth').toUpperCase();
+    return `${config.DriverClass} at ${config.RootPath} (${state}, ${phase}; host mj.config.cjs serverExtensions[] can set Enabled: false to suppress)`;
 }
 //# sourceMappingURL=collect.js.map

package/dist/collect.js.map

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

package/dist/index.d.ts

@@ -30,8 +30,10 @@
  * @see {@link ServerExtensionLoader} for the discovery and lifecycle manager
  */
 export { BaseServerExtension } from './BaseServerExtension.js';
-export { ServerExtensionLoader } from './ServerExtensionLoader.js';
-export { ServerExtensionConfig, ExtensionInitResult, ExtensionHealthResult, } from './types.js';
+export { ServerExtensionLoader, DefaultServerExtensionServiceRegistry } from './ServerExtensionLoader.js';
+export type { LoadExtensionsOptions } from './ServerExtensionLoader.js';
+export { ServerExtensionConfig, ServerExtensionPhase, ServerExtensionServiceRegistry, ServerExtensionInitContext, ExtensionInitResult, ExtensionHealthResult, } from './types.js';
 export { MJ_SERVER_EXTENSIONS_EXPORT, MJ_SERVER_EXTENSIONS_PACKAGE_JSON_PATH, MAX_SERVER_EXTENSION_ROOT_PATH_LENGTH, RESERVED_SERVER_EXTENSION_ROOTS, RESERVED_SERVER_EXTENSION_ROOT_PREFIXES, describeServerExtensionMount, extractServerExtensionsFromModule, extractServerExtensionsFromPackageJson, mergeServerExtensionConfigs, normalizeServerExtensionConfigs, prepareServerExtensionConfigs, serverExtensionRootsOverlap, validateServerExtensionRootPath, } from './collect.js';
 export type { NormalizeServerExtensionOptions, PrepareServerExtensionOptions } from './collect.js';
+export { RegisterMediaUpgradeRoute, InstallMediaUpgradeDispatcher, IsGraphQLWsPath, type IWebSocketUpgradeTarget, } from './mediaUpgradeRouter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACH,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,2BAA2B,EAC3B,sCAAsC,EACtC,qCAAqC,EACrC,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,iCAAiC,EACjC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,GAClC,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AAC1G,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,2BAA2B,EAC3B,sCAAsC,EACtC,qCAAqC,EACrC,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,iCAAiC,EACjC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,GAClC,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EACH,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,EACf,KAAK,uBAAuB,GAC/B,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -30,6 +30,7 @@
  * @see {@link ServerExtensionLoader} for the discovery and lifecycle manager
  */
 export { BaseServerExtension } from './BaseServerExtension.js';
-export { ServerExtensionLoader } from './ServerExtensionLoader.js';
+export { ServerExtensionLoader, DefaultServerExtensionServiceRegistry } from './ServerExtensionLoader.js';
 export { MJ_SERVER_EXTENSIONS_EXPORT, MJ_SERVER_EXTENSIONS_PACKAGE_JSON_PATH, MAX_SERVER_EXTENSION_ROOT_PATH_LENGTH, RESERVED_SERVER_EXTENSION_ROOTS, RESERVED_SERVER_EXTENSION_ROOT_PREFIXES, describeServerExtensionMount, extractServerExtensionsFromModule, extractServerExtensionsFromPackageJson, mergeServerExtensionConfigs, normalizeServerExtensionConfigs, prepareServerExtensionConfigs, serverExtensionRootsOverlap, validateServerExtensionRootPath, } from './collect.js';
+export { RegisterMediaUpgradeRoute, InstallMediaUpgradeDispatcher, IsGraphQLWsPath, } from './mediaUpgradeRouter.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMnE,OAAO,EACH,2BAA2B,EAC3B,sCAAsC,EACtC,qCAAqC,EACrC,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,iCAAiC,EACjC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,GAClC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AAU1G,OAAO,EACH,2BAA2B,EAC3B,sCAAsC,EACtC,qCAAqC,EACrC,+BAA+B,EAC/B,uCAAuC,EACvC,4BAA4B,EAC5B,iCAAiC,EACjC,sCAAsC,EACtC,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,GAClC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,GAElB,MAAM,yBAAyB,CAAC"}

package/dist/mediaUpgradeRouter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a server extension WebSocket socket) fight on every upgrade —
+ * the non-owning server 400s the request.
+ *
+ * The fix: extension WebSocket servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each extension socket on its own. When no extension routes are
+ * registered, we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server-extensions-core
+ */
+import type { IncomingMessage, Server as HttpServer } from 'node:http';
+import type { Duplex } from 'node:stream';
+/**
+ * Structural interface representing a WebSocketServer target for upgrade handling.
+ * Duck-typed so callers don't need a direct dependency on the `ws` package.
+ */
+export interface IWebSocketUpgradeTarget {
+    handleUpgrade(req: IncomingMessage, socket: Duplex, head: Buffer, callback: (ws: unknown) => void): void;
+    emit(event: string, ...args: unknown[]): boolean;
+}
+/** Registers a media/extension WebSocket route. Called by extension routers during setup. */
+export declare function RegisterMediaUpgradeRoute(path: string, wss: IWebSocketUpgradeTarget): void;
+/**
+ * Whether an upgrade request's pathname should be routed to the GraphQL subscriptions socket.
+ */
+export declare function IsGraphQLWsPath(pathname: string, graphqlPath: string): boolean;
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no extension routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each extension
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocket server (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ * @param preUpgradeHandler optional handler to try before routing to GraphQL or extension sockets.
+ */
+export declare function InstallMediaUpgradeDispatcher(httpServer: HttpServer, graphqlWss: IWebSocketUpgradeTarget, graphqlPath: string, preUpgradeHandler?: (req: IncomingMessage, socket: Duplex, head: Buffer) => boolean): void;
+//# sourceMappingURL=mediaUpgradeRouter.d.ts.map

package/dist/mediaUpgradeRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaUpgradeRouter.d.ts","sourceRoot":"","sources":["../src/mediaUpgradeRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,aAAa,CACT,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAChC,IAAI,CAAC;IACR,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CACpD;AAKD,6FAA6F;AAC7F,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAE1F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CACzC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,uBAAuB,EACnC,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GACpF,IAAI,CAwBN"}

package/dist/mediaUpgradeRouter.js

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a server extension WebSocket socket) fight on every upgrade —
+ * the non-owning server 400s the request.
+ *
+ * The fix: extension WebSocket servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each extension socket on its own. When no extension routes are
+ * registered, we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server-extensions-core
+ */
+/** path → the `{ noServer:true }` WebSocket server that owns it. */
+const mediaRoutes = new Map();
+/** Registers a media/extension WebSocket route. Called by extension routers during setup. */
+export function RegisterMediaUpgradeRoute(path, wss) {
+    mediaRoutes.set(path, wss);
+}
+/**
+ * Whether an upgrade request's pathname should be routed to the GraphQL subscriptions socket.
+ */
+export function IsGraphQLWsPath(pathname, graphqlPath) {
+    return pathname === graphqlPath || (graphqlPath === '/' && pathname === '/graphql');
+}
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no extension routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each extension
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocket server (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ * @param preUpgradeHandler optional handler to try before routing to GraphQL or extension sockets.
+ */
+export function InstallMediaUpgradeDispatcher(httpServer, graphqlWss, graphqlPath, preUpgradeHandler) {
+    if (mediaRoutes.size === 0) {
+        return;
+    }
+    httpServer.removeAllListeners('upgrade');
+    const dispatch = (wss, req, socket, head) => {
+        wss.handleUpgrade(req, socket, head, (ws) => wss.emit('connection', ws, req));
+    };
+    httpServer.on('upgrade', (req, socket, head) => {
+        if (preUpgradeHandler && preUpgradeHandler(req, socket, head)) {
+            return;
+        }
+        const pathname = (req.url ?? '').split('?')[0];
+        if (IsGraphQLWsPath(pathname, graphqlPath)) {
+            dispatch(graphqlWss, req, socket, head);
+            return;
+        }
+        const wss = mediaRoutes.get(pathname);
+        if (wss) {
+            dispatch(wss, req, socket, head);
+            return;
+        }
+        socket.destroy();
+    });
+}
+//# sourceMappingURL=mediaUpgradeRouter.js.map

package/dist/mediaUpgradeRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaUpgradeRouter.js","sourceRoot":"","sources":["../src/mediaUpgradeRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH,oEAAoE;AACpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAC;AAE/D,6FAA6F;AAC7F,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,GAA4B;IAChF,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,WAAmB;IACjE,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,WAAW,KAAK,GAAG,IAAI,QAAQ,KAAK,UAAU,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CACzC,UAAsB,EACtB,UAAmC,EACnC,WAAmB,EACnB,iBAAmF;IAEnF,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACX,CAAC;IACD,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,GAA4B,EAAE,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAQ,EAAE;QACxG,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QAC5E,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAC5D,OAAO;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;YACzC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO;QACX,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/types.d.ts

@@ -1,7 +1,12 @@
+import type { Application } from 'express';
+import type { Server as HttpServer } from 'http';
 /**
- * @module @memberjunction/server-extensions-core
- * @description Core types for the MJServer extension framework.
+ * Lifecycle phase for a server extension.
+ * - 'pre-auth': Mounted before JWT authentication middleware. Used for webhooks,
+ *   health checks, media stream endpoints, SSO handshakes, etc.
+ * - 'post-auth': Mounted after JWT authentication middleware. Protected by default.
  */
+export type ServerExtensionPhase = 'pre-auth' | 'post-auth';
 /**
  * Configuration for a server extension instance.
  *
@@ -22,6 +27,7 @@
  *             Enabled: true,
  *             DriverClass: 'SlackMessagingExtension',
  *             RootPath: '/webhook/slack',
+ *             Phase: 'pre-auth',
  *             Settings: {
  *                 AgentID: '...',
  *                 BotToken: process.env.SLACK_BOT_TOKEN,
@@ -44,6 +50,11 @@ export interface ServerExtensionConfig {
      * The extension registers its routes under this prefix on the Express app.
      */
     RootPath: string;
+    /**
+     * Lifecycle phase for this extension. Defaults to the extension class's `DefaultPhase`
+     * (usually `'pre-auth'`) when not specified.
+     */
+    Phase?: ServerExtensionPhase;
     /**
      * Extension-specific configuration. The shape varies by extension type.
      * For messaging adapters, this contains `AgentID`, `BotToken`, etc.
@@ -51,6 +62,47 @@ export interface ServerExtensionConfig {
      */
     Settings: Record<string, unknown>;
 }
+/**
+ * Service registry shared among server extensions, enabling cross-extension
+ * service registration and consumption.
+ */
+export interface ServerExtensionServiceRegistry {
+    /**
+     * Register a service instance under a unique key.
+     * Throws or logs if a service with the same key is already registered.
+     */
+    RegisterService<T extends object>(key: string, service: T): void;
+    /**
+     * Retrieve a registered service instance by key.
+     * Returns undefined if no service is registered under that key.
+     */
+    GetService<T extends object>(key: string): T | undefined;
+    /**
+     * Check if a service is registered under the given key.
+     */
+    HasService(key: string): boolean;
+    /**
+     * Optional accessor returning all registered services as a read-only map.
+     */
+    GetAllServices?(): ReadonlyMap<string, object>;
+}
+/**
+ * Context passed to `BaseServerExtension.Initialize()` and `OnAllExtensionsMounted()`.
+ */
+export interface ServerExtensionInitContext {
+    /** Express application instance to mount routes on. */
+    app: Application;
+    /** Node HTTP/HTTPS server instance, if available (e.g. for WebSocket attachment). */
+    httpServer?: HttpServer;
+    /** Extension configuration from mj.config.cjs or Open App metadata. */
+    config: ServerExtensionConfig;
+    /** Canonical public base URL of the MJ server (e.g. 'https://api.example.com'). */
+    publicUrl?: string;
+    /** Shared service registry for cross-extension service lookup and registration. */
+    services: ServerExtensionServiceRegistry;
+    /** Current lifecycle phase being mounted ('pre-auth' | 'post-auth'). */
+    phase: ServerExtensionPhase;
+}
 /**
  * Result returned from extension initialization.
  * Extensions report whether startup succeeded and what routes they registered.
@@ -73,6 +125,11 @@ export interface ExtensionInitResult {
      * `MJ_VERBOSE` is enabled). Implies `Success: false`.
      */
     Skipped?: boolean;
+    /**
+     * Optional service instance provided by this extension to be registered in the shared
+     * service registry (under `config.DriverClass` and/or a custom key).
+     */
+    Service?: object;
 }
 /**
  * Health check result for a single extension.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,qBAAqB;IAClC,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;IAEjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IAEjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,qBAAqB;IAClC,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC3C;;;OAGG;IACH,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,uDAAuD;IACvD,GAAG,EAAE,WAAW,CAAC;IAEjB,qFAAqF;IACrF,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,uEAAuE;IACvE,MAAM,EAAE,qBAAqB,CAAC;IAE9B,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mFAAmF;IACnF,QAAQ,EAAE,8BAA8B,CAAC;IAEzC,wEAAwE;IACxE,KAAK,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;IAEjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IAEjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/dist/types.js

@@ -1,6 +1,2 @@
-/**
- * @module @memberjunction/server-extensions-core
- * @description Core types for the MJServer extension framework.
- */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server-extensions-core",
-  "version": "6.1.0-edge.6",
+  "version": "6.1.0",
   "description": "MemberJunction: Server Extension framework - plugin architecture for MJServer that enables auto-discovery and lifecycle management of extension modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,8 +11,8 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/global": "6.1.0-edge.6",
-    "@memberjunction/core": "6.1.0-edge.6",
+    "@memberjunction/global": "6.1.0",
+    "@memberjunction/core": "6.1.0",
     "express": "^5.2.1"
   },
   "devDependencies": {