@memberjunction/server 4.1.0 → 4.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -18,65 +18,65 @@
     "build": "tsc && tsc-alias -f",
     "bundle": "tsc -noEmit && pkgroll --sourcemap --minify",
     "watch": "tsc -w",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
-    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
     "@apollo/server": "^4.9.1",
     "@graphql-tools/schema": "latest",
     "@graphql-tools/utils": "^11.0.0",
-    "@memberjunction/actions": "4.1.0",
-    "@memberjunction/actions-base": "4.1.0",
-    "@memberjunction/actions-apollo": "4.1.0",
-    "@memberjunction/actions-bizapps-accounting": "4.1.0",
-    "@memberjunction/actions-bizapps-crm": "4.1.0",
-    "@memberjunction/actions-bizapps-formbuilders": "4.1.0",
-    "@memberjunction/actions-bizapps-lms": "4.1.0",
-    "@memberjunction/actions-bizapps-social": "4.1.0",
-    "@memberjunction/ai": "4.1.0",
-    "@memberjunction/ai-mcp-client": "4.1.0",
-    "@memberjunction/ai-agent-manager": "4.1.0",
-    "@memberjunction/ai-agent-manager-actions": "4.1.0",
-    "@memberjunction/ai-agents": "4.1.0",
-    "@memberjunction/ai-core-plus": "4.1.0",
-    "@memberjunction/ai-prompts": "4.1.0",
-    "@memberjunction/ai-provider-bundle": "4.1.0",
-    "@memberjunction/ai-vectors-pinecone": "4.1.0",
-    "@memberjunction/aiengine": "4.1.0",
-    "@memberjunction/communication-ms-graph": "4.1.0",
-    "@memberjunction/communication-sendgrid": "4.1.0",
-    "@memberjunction/communication-types": "4.1.0",
-    "@memberjunction/component-registry-client-sdk": "4.1.0",
-    "@memberjunction/config": "4.1.0",
-    "@memberjunction/core": "4.1.0",
-    "@memberjunction/core-actions": "4.1.0",
-    "@memberjunction/core-entities": "4.1.0",
-    "@memberjunction/core-entities-server": "4.1.0",
-    "@memberjunction/data-context": "4.1.0",
-    "@memberjunction/data-context-server": "4.1.0",
-    "@memberjunction/doc-utils": "4.1.0",
-    "@memberjunction/api-keys": "4.1.0",
-    "@memberjunction/encryption": "4.1.0",
-    "@memberjunction/entity-communications-base": "4.1.0",
-    "@memberjunction/entity-communications-server": "4.1.0",
-    "@memberjunction/external-change-detection": "4.1.0",
-    "@memberjunction/global": "4.1.0",
-    "@memberjunction/graphql-dataprovider": "4.1.0",
-    "@memberjunction/interactive-component-types": "4.1.0",
-    "@memberjunction/notifications": "4.1.0",
-    "@memberjunction/queue": "4.1.0",
-    "@memberjunction/scheduling-actions": "4.1.0",
-    "@memberjunction/scheduling-base-types": "4.1.0",
-    "@memberjunction/scheduling-engine": "4.1.0",
-    "@memberjunction/scheduling-engine-base": "4.1.0",
-    "@memberjunction/skip-types": "4.1.0",
-    "@memberjunction/sqlserver-dataprovider": "4.1.0",
-    "@memberjunction/storage": "4.1.0",
-    "@memberjunction/templates": "4.1.0",
-    "@memberjunction/testing-engine": "4.1.0",
-    "@memberjunction/testing-engine-base": "4.1.0",
-    "@memberjunction/version-history": "4.1.0",
+    "@memberjunction/actions": "4.3.0",
+    "@memberjunction/actions-base": "4.3.0",
+    "@memberjunction/actions-apollo": "4.3.0",
+    "@memberjunction/actions-bizapps-accounting": "4.3.0",
+    "@memberjunction/actions-bizapps-crm": "4.3.0",
+    "@memberjunction/actions-bizapps-formbuilders": "4.3.0",
+    "@memberjunction/actions-bizapps-lms": "4.3.0",
+    "@memberjunction/actions-bizapps-social": "4.3.0",
+    "@memberjunction/ai": "4.3.0",
+    "@memberjunction/ai-mcp-client": "4.3.0",
+    "@memberjunction/ai-agent-manager": "4.3.0",
+    "@memberjunction/ai-agent-manager-actions": "4.3.0",
+    "@memberjunction/ai-agents": "4.3.0",
+    "@memberjunction/ai-core-plus": "4.3.0",
+    "@memberjunction/ai-prompts": "4.3.0",
+    "@memberjunction/ai-provider-bundle": "4.3.0",
+    "@memberjunction/ai-vectors-pinecone": "4.3.0",
+    "@memberjunction/aiengine": "4.3.0",
+    "@memberjunction/communication-ms-graph": "4.3.0",
+    "@memberjunction/communication-sendgrid": "4.3.0",
+    "@memberjunction/communication-types": "4.3.0",
+    "@memberjunction/component-registry-client-sdk": "4.3.0",
+    "@memberjunction/config": "4.3.0",
+    "@memberjunction/core": "4.3.0",
+    "@memberjunction/core-actions": "4.3.0",
+    "@memberjunction/core-entities": "4.3.0",
+    "@memberjunction/core-entities-server": "4.3.0",
+    "@memberjunction/data-context": "4.3.0",
+    "@memberjunction/data-context-server": "4.3.0",
+    "@memberjunction/doc-utils": "4.3.0",
+    "@memberjunction/api-keys": "4.3.0",
+    "@memberjunction/encryption": "4.3.0",
+    "@memberjunction/entity-communications-base": "4.3.0",
+    "@memberjunction/entity-communications-server": "4.3.0",
+    "@memberjunction/external-change-detection": "4.3.0",
+    "@memberjunction/global": "4.3.0",
+    "@memberjunction/graphql-dataprovider": "4.3.0",
+    "@memberjunction/interactive-component-types": "4.3.0",
+    "@memberjunction/notifications": "4.3.0",
+    "@memberjunction/queue": "4.3.0",
+    "@memberjunction/scheduling-actions": "4.3.0",
+    "@memberjunction/scheduling-base-types": "4.3.0",
+    "@memberjunction/scheduling-engine": "4.3.0",
+    "@memberjunction/scheduling-engine-base": "4.3.0",
+    "@memberjunction/skip-types": "4.3.0",
+    "@memberjunction/sqlserver-dataprovider": "4.3.0",
+    "@memberjunction/storage": "4.3.0",
+    "@memberjunction/templates": "4.3.0",
+    "@memberjunction/testing-engine": "4.3.0",
+    "@memberjunction/testing-engine-base": "4.3.0",
+    "@memberjunction/version-history": "4.3.0",
     "@types/compression": "^1.8.1",
     "@types/cors": "^2.8.19",
     "@types/jsonwebtoken": "9.0.10",
@@ -110,11 +110,8 @@
     "zod": "~3.24.4"
   },
   "devDependencies": {
-    "@jest/globals": "^30.2.0",
-    "@types/jest": "^30.0.0",
-    "jest": "^30.2.0",
     "pkgroll": "2.23.0",
-    "ts-jest": "^29.4.6",
+    "vitest": "^3.1.1",
     "typescript": "^5.9.3"
   },
   "repository": {

package/src/__tests__/setup.ts

@@ -1,21 +1,19 @@
+/// <reference types="vitest/globals" />
 /**
- * Jest setup file for MJServer tests
+ * Vitest setup file for MJServer tests
  * Runs before each test file
  */
 
 // Increase timeout for async operations
-// Using globalThis for ESM compatibility
-if (typeof jest !== 'undefined') {
-  jest.setTimeout(30000);
-}
+vi.setConfig({ testTimeout: 30000 });
 
 // Mock console methods to reduce noise (can be enabled per test)
 // Uncomment to silence logs during tests
 // global.console = {
 //   ...console,
-//   log: jest.fn(),
-//   debug: jest.fn(),
-//   info: jest.fn(),
-//   warn: jest.fn(),
-//   error: jest.fn(),
+//   log: vi.fn(),
+//   debug: vi.fn(),
+//   info: vi.fn(),
+//   warn: vi.fn(),
+//   error: vi.fn(),
 // };

package/src/auth/__tests__/backward-compatibility.test.ts

@@ -1,4 +1,16 @@
-import { describe, it, expect, beforeEach, afterEach, jest } from '@jest/globals';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+
+// Mock the config module before any imports that depend on it
+vi.mock('../../config', () => ({
+  configInfo: {
+    authProviders: [],
+    databaseSettings: {},
+    graphqlPort: 4000,
+    baseUrl: 'http://localhost',
+    graphqlRootPath: '/',
+  },
+}));
+
 import { AuthProviderFactory } from '../AuthProviderFactory';
 import { IAuthProvider } from '../IAuthProvider';
 import { initializeAuthProviders } from '../initializeProviders';
@@ -18,36 +30,32 @@ describe('Authentication Provider Backward Compatibility', () => {
     factory.clear();
   });
 
-  describe('Legacy Configuration Support', () => {
-    it('should create MSAL provider from legacy config', () => {
-      // Simulate legacy environment variables
-      process.env.TENANT_ID = 'test-tenant-id';
-      process.env.WEB_CLIENT_ID = 'test-client-id';
-      
-      // Initialize with legacy config
+  describe('Configuration-Based Provider Initialization', () => {
+    it('should initialize with no providers when config is empty', () => {
       initializeAuthProviders();
-      
-      // Check that MSAL provider was created
-      const msalProvider = factory.getByName('msal');
-      expect(msalProvider).toBeDefined();
-      expect(msalProvider?.issuer).toContain('test-tenant-id');
-      expect(msalProvider?.audience).toBe('test-client-id');
+
+      // With empty authProviders array, no providers should be registered
+      expect(factory.hasProviders()).toBe(false);
     });
-    
-    it('should create Auth0 provider from legacy config', () => {
-      // Simulate legacy environment variables
-      process.env.AUTH0_DOMAIN = 'test.auth0.com';
-      process.env.AUTH0_CLIENT_ID = 'auth0-client-id';
-      process.env.AUTH0_CLIENT_SECRET = 'auth0-secret';
-      
-      // Initialize with legacy config
+
+    it('should clear existing providers before re-initializing', () => {
+      // Register a manual provider first
+      const testProvider = {
+        name: 'test',
+        issuer: 'https://test.com',
+        audience: 'test',
+        jwksUri: 'https://test.com/jwks',
+        validateConfig: () => true,
+        getSigningKey: vi.fn(),
+        extractUserInfo: vi.fn(),
+        matchesIssuer: vi.fn(),
+      } as IAuthProvider;
+      factory.register(testProvider);
+      expect(factory.hasProviders()).toBe(true);
+
+      // Re-initialize clears everything
       initializeAuthProviders();
-      
-      // Check that Auth0 provider was created
-      const auth0Provider = factory.getByName('auth0');
-      expect(auth0Provider).toBeDefined();
-      expect(auth0Provider?.issuer).toBe('https://test.auth0.com/');
-      expect(auth0Provider?.audience).toBe('auth0-client-id');
+      expect(factory.hasProviders()).toBe(false);
     });
   });
 
@@ -61,8 +69,8 @@ describe('Authentication Provider Backward Compatibility', () => {
         audience: 'test-audience',
         jwksUri: 'https://test.provider.com/.well-known/jwks.json',
         validateConfig: () => true,
-        getSigningKey: jest.fn(),
-        extractUserInfo: jest.fn(),
+        getSigningKey: vi.fn(),
+        extractUserInfo: vi.fn(),
         matchesIssuer: (issuer: string) => {
           const normalized = issuer.toLowerCase().replace(/\/$/, '');
           return normalized === 'https://test.provider.com/oauth2';
@@ -88,9 +96,9 @@ describe('Authentication Provider Backward Compatibility', () => {
         audience: 'test',
         jwksUri: 'https://test.provider.com/jwks',
         validateConfig: () => true,
-        getSigningKey: jest.fn(),
-        extractUserInfo: jest.fn(),
-        matchesIssuer: jest.fn((issuer: string): boolean => issuer === 'https://test.provider.com')
+        getSigningKey: vi.fn(),
+        extractUserInfo: vi.fn(),
+        matchesIssuer: vi.fn((issuer: string): boolean => issuer === 'https://test.provider.com')
       } as IAuthProvider;
       
       factory.register(testProvider);
@@ -106,55 +114,36 @@ describe('Authentication Provider Backward Compatibility', () => {
   });
 
   describe('User Info Extraction', () => {
-    it('should extract user info from different token formats', () => {
-      // Test MSAL token format
-      const msalPayload = {
-        iss: 'https://login.microsoftonline.com/tenant/v2.0',
-        email: 'user@example.com',
-        given_name: 'John',
-        family_name: 'Doe',
-        name: 'John Doe',
-        preferred_username: 'john.doe@example.com'
-      };
-      
-      // Test Auth0 token format
-      const auth0Payload = {
-        iss: 'https://test.auth0.com/',
-        email: 'user@example.com',
-        given_name: 'Jane',
-        family_name: 'Smith',
-        name: 'Jane Smith'
-      };
-      
-      // Test Okta token format
-      const oktaPayload = {
-        iss: 'https://test.okta.com/oauth2/default',
-        email: 'user@example.com',
-        given_name: 'Bob',
-        family_name: 'Johnson',
-        name: 'Bob Johnson',
-        preferred_username: 'bob.johnson'
-      };
-      
-      // Initialize providers
-      initializeAuthProviders();
-      
-      // Test extraction for each provider type
-      const msalProvider = factory.getByIssuer(msalPayload.iss);
-      if (msalProvider) {
-        const msalUserInfo = msalProvider.extractUserInfo(msalPayload);
-        expect(msalUserInfo.email).toBe('user@example.com');
-        expect(msalUserInfo.firstName).toBe('John');
-        expect(msalUserInfo.lastName).toBe('Doe');
-      }
-      
-      const auth0Provider = factory.getByIssuer(auth0Payload.iss);
-      if (auth0Provider) {
-        const auth0UserInfo = auth0Provider.extractUserInfo(auth0Payload);
-        expect(auth0UserInfo.email).toBe('user@example.com');
-        expect(auth0UserInfo.firstName).toBe('Jane');
-        expect(auth0UserInfo.lastName).toBe('Smith');
-      }
+    it('should return undefined for unregistered issuer', () => {
+      const provider = factory.getByIssuer('https://unknown.issuer.com');
+      expect(provider).toBeUndefined();
+    });
+
+    it('should support extractUserInfo on manually registered providers', () => {
+      const mockExtract = vi.fn().mockReturnValue({
+        email: 'user@test.com',
+        firstName: 'Test',
+        lastName: 'User',
+      });
+      const testProvider = {
+        name: 'test-extract',
+        issuer: 'https://test-extract.com',
+        audience: 'test',
+        jwksUri: 'https://test-extract.com/jwks',
+        validateConfig: () => true,
+        getSigningKey: vi.fn(),
+        extractUserInfo: mockExtract,
+        matchesIssuer: (iss: string) => iss === 'https://test-extract.com',
+      } as IAuthProvider;
+
+      factory.register(testProvider);
+
+      const found = factory.getByIssuer('https://test-extract.com');
+      expect(found).toBeDefined();
+
+      const userInfo = found!.extractUserInfo({ email: 'user@test.com' });
+      expect(userInfo.email).toBe('user@test.com');
+      expect(mockExtract).toHaveBeenCalledTimes(1);
     });
   });
 
@@ -172,9 +161,9 @@ describe('Authentication Provider Backward Compatibility', () => {
         audience: 'test',
         jwksUri: 'https://test.com/jwks',
         validateConfig: () => false,
-        getSigningKey: jest.fn(),
-        extractUserInfo: jest.fn(),
-        matchesIssuer: jest.fn()
+        getSigningKey: vi.fn(),
+        extractUserInfo: vi.fn(),
+        matchesIssuer: vi.fn()
       } as IAuthProvider;
       
       expect(() => factory.register(invalidProvider)).toThrow();

package/src/generated/generated.ts

@@ -59681,6 +59681,14 @@ export class MJSchemaInfo_ {
     @Field({nullable: true}) 
     Description?: string;
         
+    @Field({nullable: true, description: `Optional prefix to prepend to entity names generated for this schema. For example, setting this to "Committees: " would result in entity names like "Committees: Individuals". Can be overridden by mj.config.cjs NameRulesBySchema settings.`}) 
+    @MaxLength(50)
+    EntityNamePrefix?: string;
+        
+    @Field({nullable: true, description: `Optional suffix to append to entity names generated for this schema. Can be overridden by mj.config.cjs NameRulesBySchema settings.`}) 
+    @MaxLength(50)
+    EntityNameSuffix?: string;
+        
 }
 
 //****************************************************************************
@@ -59705,6 +59713,12 @@ export class CreateMJSchemaInfoInput {
 
     @Field({ nullable: true })
     Description: string | null;
+
+    @Field({ nullable: true })
+    EntityNamePrefix: string | null;
+
+    @Field({ nullable: true })
+    EntityNameSuffix: string | null;
 }
     
 
@@ -59731,6 +59745,12 @@ export class UpdateMJSchemaInfoInput {
     @Field({ nullable: true })
     Description?: string | null;
 
+    @Field({ nullable: true })
+    EntityNamePrefix?: string | null;
+
+    @Field({ nullable: true })
+    EntityNameSuffix?: string | null;
+
     @Field(() => [KeyValuePairInput], { nullable: true })
     OldValues___?: KeyValuePairInput[];
 }

package/src/generic/DeleteOptionsInput.ts

@@ -1,13 +1,30 @@
 import { Field, InputType } from "type-graphql";
 
 /**
- * GraphQL InputType for the DeleteOptions 
+ * GraphQL InputType for the DeleteOptions.
+ * Must be kept in sync with EntityDeleteOptions in @memberjunction/core.
  */
 @InputType()
 export class DeleteOptionsInput {
     @Field(() => Boolean)
     SkipEntityAIActions: boolean;
-    
-    @Field(() => Boolean) 
+
+    @Field(() => Boolean)
     SkipEntityActions: boolean;
+
+    /**
+     * When set to true, the delete operation will BYPASS Validate() and the actual
+     * process of deleting the record from the database but WILL invoke any associated
+     * actions (AI Actions, Entity Actions, etc...).
+     */
+    @Field(() => Boolean)
+    ReplayOnly: boolean;
+
+    /**
+     * When true, this entity is being deleted as part of an IS-A parent chain
+     * initiated by a child entity. The child deletes itself first (FK constraint),
+     * then cascades deletion to its parent.
+     */
+    @Field(() => Boolean)
+    IsParentEntityDelete: boolean;
 }

package/src/index.ts

@@ -91,6 +91,7 @@ export * from './resolvers/MCPResolver.js';
 export * from './resolvers/ActionResolver.js';
 export * from './resolvers/EntityCommunicationsResolver.js';
 export * from './resolvers/EntityResolver.js';
+export * from './resolvers/ISAEntityResolver.js';
 export * from './resolvers/FileCategoryResolver.js';
 export * from './resolvers/FileResolver.js';
 export * from './resolvers/InfoResolver.js';

package/src/resolvers/CreateQueryResolver.ts

@@ -816,7 +816,9 @@ export class MJQueryResolverExtended extends MJQueryResolver {
             // Provide default options if none provided
             const deleteOptions = options || {
                 SkipEntityAIActions: false,
-                SkipEntityActions: false
+                SkipEntityActions: false,
+                ReplayOnly: false,
+                IsParentEntityDelete: false
             };
             
             // Use inherited DeleteRecord method from ResolverBase

package/src/resolvers/ISAEntityResolver.ts

@@ -0,0 +1,96 @@
+import { EntityInfo, IEntityDataProvider, Metadata, UserInfo } from '@memberjunction/core';
+import { Arg, Ctx, Field, ObjectType, Query, Resolver } from 'type-graphql';
+import { AppContext } from '../types.js';
+import { GetReadOnlyProvider } from '../util.js';
+
+/**
+ * Result type for the IS-A child entity discovery query.
+ * Returns the name of the child entity type that has a record matching
+ * the given parent entity's primary key, or null if no child exists.
+ */
+@ObjectType()
+export class ISAChildEntityResult {
+    @Field(() => Boolean)
+    Success: boolean;
+
+    @Field(() => String, { nullable: true })
+    ChildEntityName?: string;
+
+    @Field(() => String, { nullable: true })
+    ErrorMessage?: string;
+}
+
+/**
+ * Resolver for IS-A entity hierarchy discovery.
+ *
+ * Provides a GraphQL endpoint for client-side code to discover child entity
+ * records in an IS-A hierarchy. This enables bidirectional chain construction
+ * where a loaded entity discovers its more-derived child type.
+ */
+@Resolver(ISAChildEntityResult)
+export class ISAEntityResolver {
+    /**
+     * Discovers which IS-A child entity, if any, has a record with the given
+     * primary key value. The server executes a single UNION ALL query across
+     * all child entity tables for maximum efficiency.
+     *
+     * @param EntityName The parent entity name to check children for
+     * @param RecordID The primary key value to search for in child tables
+     * @returns The child entity name if found, or null with Success=true if no child exists
+     */
+    @Query(() => ISAChildEntityResult)
+    async FindISAChildEntity(
+        @Arg('EntityName', () => String) EntityName: string,
+        @Arg('RecordID', () => String) RecordID: string,
+        @Ctx() { providers, userPayload }: AppContext
+    ): Promise<ISAChildEntityResult> {
+        try {
+            const provider = GetReadOnlyProvider(providers, { allowFallbackToReadWrite: true });
+            const md = new Metadata();
+            const entityInfo = md.Entities.find(e => e.Name === EntityName);
+
+            if (!entityInfo) {
+                return {
+                    Success: false,
+                    ErrorMessage: `Entity '${EntityName}' not found`
+                };
+            }
+
+            if (!entityInfo.IsParentType) {
+                return { Success: true };
+            }
+
+            // Cast to IEntityDataProvider to access the optional FindISAChildEntity method
+            const entityProvider = provider as unknown as IEntityDataProvider;
+            if (!entityProvider.FindISAChildEntity) {
+                return {
+                    Success: false,
+                    ErrorMessage: 'Provider does not support FindISAChildEntity'
+                };
+            }
+
+            const result = await entityProvider.FindISAChildEntity(
+                entityInfo,
+                RecordID,
+                userPayload?.userRecord
+            );
+
+            if (result) {
+                return {
+                    Success: true,
+                    ChildEntityName: result.ChildEntityName
+                };
+            }
+
+            return { Success: true };
+        }
+        catch (e) {
+            return {
+                Success: false,
+                ErrorMessage: e instanceof Error ? e.message : String(e)
+            };
+        }
+    }
+}
+
+export default ISAEntityResolver;