@memberjunction/unit-testing 0.0.1 → 4.3.0

package/README.md

@@ -1,45 +1,332 @@
 # @memberjunction/unit-testing
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Utilities and mocks for writing unit tests in the MemberJunction monorepo using Vitest.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Installation
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+```bash
+npm install --save-dev @memberjunction/unit-testing
+```
 
-## Purpose
+This package is typically already included as a dev dependency in MemberJunction projects.
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/unit-testing`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+## Overview
 
-## What is OIDC Trusted Publishing?
+This package provides helper functions and mock utilities to simplify unit testing of MemberJunction components. It handles common testing challenges like:
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+- **Singleton reset** - Clean state between tests
+- **Entity mocking** - Mock BaseEntity behavior without database
+- **RunView mocking** - Mock data loading operations
+- **Custom matchers** - Additional Vitest assertions
 
-## Setup Instructions
+## Utilities
 
-To properly configure OIDC trusted publishing for this package:
+### Singleton Reset
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+MemberJunction uses singletons for engines and global state. Reset them between tests to ensure isolation.
 
-## DO NOT USE THIS PACKAGE
+#### `resetMJSingletons()`
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+Clears ALL MJ singleton instances from the global store.
 
-## More Information
+```typescript
+import { describe, it, beforeEach } from 'vitest';
+import { resetMJSingletons } from '@memberjunction/unit-testing';
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+describe('MyEngine', () => {
+  beforeEach(() => {
+    resetMJSingletons(); // Clean slate for each test
+  });
 
----
+  it('should create fresh engine instance', () => {
+    const engine = MyEngine.Instance; // Gets new instance
+    // ... test
+  });
+});
+```
 
-**Maintained for OIDC setup purposes only**
+#### `resetClassFactory()`
+
+Resets only the ClassFactory registrations. Lighter weight than `resetMJSingletons`.
+
+```typescript
+import { resetClassFactory } from '@memberjunction/unit-testing';
+
+beforeEach(() => {
+  resetClassFactory(); // Only reset class registrations
+});
+```
+
+#### `resetObjectCache()`
+
+Clears the global object cache used by MJ for caching data.
+
+```typescript
+import { resetObjectCache } from '@memberjunction/unit-testing';
+
+beforeEach(() => {
+  resetObjectCache(); // Clear cached objects
+});
+```
+
+### Entity Mocking
+
+#### `createMockEntity<T>(data, options?)`
+
+Creates a Proxy-based mock that behaves like a BaseEntity with getter/setter properties.
+
+**Why needed:** BaseEntity uses getters/setters, so the spread operator (`...entity`) doesn't work. This mock provides the same interface without requiring a real database.
+
+```typescript
+import { createMockEntity } from '@memberjunction/unit-testing';
+
+// Create a mock user entity
+const mockUser = createMockEntity({
+  ID: 'user-123',
+  Name: 'Test User',
+  Email: 'test@example.com',
+  Status: 'Active'
+});
+
+// Use like a real entity
+console.log(mockUser.Name); // 'Test User'
+mockUser.Status = 'Inactive'; // Setter works
+console.log(mockUser.Get('Email')); // 'test@example.com'
+console.log(mockUser.GetAll()); // { ID: '...', Name: '...', ... }
+
+await mockUser.Save(); // Mock save (always succeeds)
+console.log(mockUser.Dirty); // false after save
+```
+
+**Options:**
+
+```typescript
+interface MockEntityOptions {
+  isSaved?: boolean;  // Default: true - Entity appears saved to DB
+  isDirty?: boolean;  // Default: false - Entity appears clean
+}
+
+// Create unsaved entity
+const newEntity = createMockEntity(
+  { ID: '', Name: 'New User' },
+  { isSaved: false, isDirty: true }
+);
+```
+
+**Mock Entity Methods:**
+
+- `Get(fieldName)` - Get field value (case-insensitive)
+- `Set(fieldName, value)` - Set field value (marks dirty)
+- `GetAll()` - Returns all fields as plain object
+- `Save()` - Mock save operation (always succeeds, clears dirty flag)
+- `Delete()` - Mock delete operation (always succeeds)
+- `Dirty` - Boolean indicating if entity has unsaved changes
+- `IsSaved` - Boolean indicating if entity exists in DB
+- `PrimaryKey` - Mock primary key object
+
+### RunView Mocking
+
+#### `mockRunView(entityName, mockResults)`
+
+Mocks a single `RunView` operation to return specific results.
+
+```typescript
+import { mockRunView } from '@memberjunction/unit-testing';
+import { vi } from 'vitest';
+
+// Mock RunView for 'Users' entity
+const mockUsers = [
+  createMockEntity({ ID: '1', Name: 'Alice' }),
+  createMockEntity({ ID: '2', Name: 'Bob' })
+];
+
+const runViewSpy = mockRunView('Users', mockUsers);
+
+// Now when code calls RunView:
+const rv = new RunView();
+const result = await rv.RunView({ EntityName: 'Users' });
+// result.Results === mockUsers
+
+// Verify it was called
+expect(runViewSpy).toHaveBeenCalledWith(
+  expect.objectContaining({ EntityName: 'Users' })
+);
+```
+
+#### `mockRunViews(mocks)`
+
+Mocks multiple `RunView` operations at once.
+
+```typescript
+import { mockRunViews } from '@memberjunction/unit-testing';
+
+mockRunViews({
+  'Users': mockUsers,
+  'Actions': mockActions,
+  'AI Models': mockModels
+});
+
+// All three entities will return mock data
+```
+
+#### `resetRunViewMocks()`
+
+Clears all RunView mocks.
+
+```typescript
+import { resetRunViewMocks } from '@memberjunction/unit-testing';
+
+afterEach(() => {
+  resetRunViewMocks(); // Clean up mocks
+});
+```
+
+### Custom Matchers
+
+#### `installCustomMatchers()`
+
+Installs additional Vitest matchers for MemberJunction-specific assertions.
+
+```typescript
+import { installCustomMatchers } from '@memberjunction/unit-testing';
+import { beforeAll } from 'vitest';
+
+beforeAll(() => {
+  installCustomMatchers();
+});
+
+// Now use custom matchers in your tests
+// (See vitest.d.ts for available custom matchers)
+```
+
+## Common Patterns
+
+### Test Structure with Full Setup
+
+```typescript
+import { describe, it, expect, beforeEach } from 'vitest';
+import {
+  resetMJSingletons,
+  createMockEntity,
+  mockRunView
+} from '@memberjunction/unit-testing';
+
+describe('MyService', () => {
+  beforeEach(() => {
+    // Reset singletons for clean state
+    resetMJSingletons();
+  });
+
+  it('should process users correctly', async () => {
+    // Setup mock data
+    const mockUsers = [
+      createMockEntity({ ID: '1', Name: 'Alice', Status: 'Active' }),
+      createMockEntity({ ID: '2', Name: 'Bob', Status: 'Inactive' })
+    ];
+
+    // Mock RunView to return mock data
+    mockRunView('Users', mockUsers);
+
+    // Test your service
+    const service = new MyService();
+    const result = await service.getActiveUsers();
+
+    // Assertions
+    expect(result).toHaveLength(1);
+    expect(result[0].Name).toBe('Alice');
+  });
+});
+```
+
+### Mocking Entity Creation
+
+When testing code that creates entities via `Metadata.GetEntityObject()`:
+
+```typescript
+import { vi } from 'vitest';
+import { createMockEntity } from '@memberjunction/unit-testing';
+
+// Mock the Metadata class
+vi.mock('@memberjunction/core', () => ({
+  Metadata: vi.fn(function() {
+    return {
+      GetEntityObject: vi.fn(async (entityName) => {
+        return createMockEntity({ ID: '', Name: '' }, { isSaved: false });
+      })
+    };
+  })
+}));
+```
+
+### Testing Singleton Engines
+
+```typescript
+import { resetMJSingletons } from '@memberjunction/unit-testing';
+
+describe('ActionEngine', () => {
+  beforeEach(() => {
+    resetMJSingletons(); // Ensures fresh instance
+  });
+
+  it('should load actions', async () => {
+    const engine = ActionEngine.Instance;
+    await engine.Load();
+    expect(engine.Actions.length).toBeGreaterThan(0);
+  });
+
+  it('should get separate instance after reset', async () => {
+    const engine1 = ActionEngine.Instance;
+    resetMJSingletons();
+    const engine2 = ActionEngine.Instance;
+
+    expect(engine1).not.toBe(engine2); // Different instances
+  });
+});
+```
+
+## TypeScript Support
+
+This package includes TypeScript definitions for all utilities. Import types as needed:
+
+```typescript
+import type { MockEntityOptions, MockEntityMethods } from '@memberjunction/unit-testing';
+```
+
+## Best Practices
+
+### DO:
+- ✅ Always reset singletons in `beforeEach()` for test isolation
+- ✅ Use `createMockEntity()` instead of plain objects for BaseEntity mocks
+- ✅ Use `mockRunView()` to avoid database dependencies in unit tests
+- ✅ Keep mocks simple and focused on the test case
+
+### DON'T:
+- ❌ Share mock data between tests (creates hidden dependencies)
+- ❌ Forget to reset singletons (causes test interference)
+- ❌ Over-mock (test real logic where possible)
+- ❌ Use real database connections in unit tests (use integration tests instead)
+
+## Related Documentation
+
+- **Testing Strategy**: See `/unit-testing/README.md` for comprehensive testing guidelines
+- **Analytics**: See `/unit-testing/README.md` for test reporting and analytics
+- **Integration Tests**: See `/packages/TestingFramework/` for full-stack testing
+
+## Examples
+
+Look at existing tests for usage examples:
+- `/packages/MJCore/src/__tests__/` - Core functionality tests
+- `/packages/Actions/Engine/src/__tests__/` - Action engine tests
+- `/packages/AI/*/src/__tests__/` - AI provider tests
+
+## Contributing
+
+When adding new test utilities:
+1. Add the utility function to appropriate file (`singleton-reset.ts`, `mock-entity.ts`, etc.)
+2. Export from `index.ts`
+3. Update this README with usage examples
+4. Add TypeScript definitions to `vitest.d.ts` if adding custom matchers
+
+## License
+
+See repository root LICENSE file.

package/dist/custom-matchers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Install MemberJunction-specific custom matchers for Vitest.
+ * Call this once in your setup file or at the top of your test.
+ */
+export declare function installCustomMatchers(): void;
+//# sourceMappingURL=custom-matchers.d.ts.map

package/dist/custom-matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-matchers.d.ts","sourceRoot":"","sources":["../src/custom-matchers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAmD5C"}

package/dist/custom-matchers.js

@@ -0,0 +1,53 @@
+import { expect } from 'vitest';
+/**
+ * Install MemberJunction-specific custom matchers for Vitest.
+ * Call this once in your setup file or at the top of your test.
+ */
+export function installCustomMatchers() {
+    expect.extend({
+        /**
+         * Asserts that a value looks like a valid MJ entity (has a non-empty ID)
+         */
+        toBeValidEntity(received) {
+            const entity = received;
+            const pass = entity != null &&
+                typeof entity === 'object' &&
+                'ID' in entity &&
+                typeof entity.ID === 'string' &&
+                entity.ID.length > 0;
+            return {
+                pass,
+                message: () => pass
+                    ? `expected value not to be a valid entity, but it has ID="${entity.ID}"`
+                    : `expected value to be a valid entity with a non-empty string ID, got ${JSON.stringify(received)}`,
+            };
+        },
+        /**
+         * Asserts that a RunView result has Success: true
+         */
+        toHaveSucceeded(received) {
+            const result = received;
+            const pass = result != null && result.Success === true;
+            return {
+                pass,
+                message: () => pass
+                    ? `expected result not to have succeeded`
+                    : `expected result to have succeeded but got: ${result?.ErrorMessage ?? 'Success was not true'}`,
+            };
+        },
+        /**
+         * Asserts that an entity-like object has a specific field
+         */
+        toHaveEntityField(received, fieldName) {
+            const entity = received;
+            const pass = entity != null && typeof entity === 'object' && fieldName in entity;
+            return {
+                pass,
+                message: () => pass
+                    ? `expected entity not to have field "${fieldName}"`
+                    : `expected entity to have field "${fieldName}", got keys: ${entity ? Object.keys(entity).join(', ') : 'null'}`,
+            };
+        },
+    });
+}
+//# sourceMappingURL=custom-matchers.js.map

package/dist/custom-matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-matchers.js","sourceRoot":"","sources":["../src/custom-matchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,CAAC,MAAM,CAAC;QACZ;;WAEG;QACH,eAAe,CAAC,QAAiB;YAC/B,MAAM,MAAM,GAAG,QAA0C,CAAC;YAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI;gBACzB,OAAO,MAAM,KAAK,QAAQ;gBAC1B,IAAI,IAAI,MAAM;gBACd,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;gBAC7B,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAEvB,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;oBACjB,CAAC,CAAC,2DAA4D,MAAkC,CAAC,EAAE,GAAG;oBACtG,CAAC,CAAC,uEAAuE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;aACtG,CAAC;QACJ,CAAC;QAED;;WAEG;QACH,eAAe,CAAC,QAAiB;YAC/B,MAAM,MAAM,GAAG,QAA+D,CAAC;YAC/E,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;YAEvD,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;oBACjB,CAAC,CAAC,uCAAuC;oBACzC,CAAC,CAAC,8CAA8C,MAAM,EAAE,YAAY,IAAI,sBAAsB,EAAE;aACnG,CAAC;QACJ,CAAC;QAED;;WAEG;QACH,iBAAiB,CAAC,QAAiB,EAAE,SAAiB;YACpD,MAAM,MAAM,GAAG,QAA0C,CAAC;YAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,CAAC;YAEjF,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;oBACjB,CAAC,CAAC,sCAAsC,SAAS,GAAG;oBACpD,CAAC,CAAC,kCAAkC,SAAS,gBAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;aAClH,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { resetMJSingletons, resetClassFactory, resetObjectCache } from './singleton-reset.js';
+export { createMockEntity, type MockEntityOptions } from './mock-entity.js';
+export { mockRunView, mockRunViews, resetRunViewMocks } from './mock-run-view.js';
+export { installCustomMatchers } from './custom-matchers.js';
+export type {} from './vitest.d';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { resetMJSingletons, resetClassFactory, resetObjectCache } from './singleton-reset.js';
+export { createMockEntity } from './mock-entity.js';
+export { mockRunView, mockRunViews, resetRunViewMocks } from './mock-run-view.js';
+export { installCustomMatchers } from './custom-matchers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAA0B,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mock-entity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Options for creating mock entity objects
+ */
+export interface MockEntityOptions {
+    /** Whether the entity should report as saved (existing in DB) */
+    isSaved?: boolean;
+    /** Whether the entity should report as dirty */
+    isDirty?: boolean;
+}
+/**
+ * Creates a mock object that behaves like a BaseEntity with getter/setter properties.
+ * Since BaseEntity uses getter/setters, the spread operator doesn't work on real entities.
+ * This creates a Proxy-based mock that supports Get(), Set(), GetAll(), and property access.
+ *
+ * @param data Initial field values for the mock entity
+ * @param options Configuration options for the mock's state
+ * @returns A proxy object that behaves like a BaseEntity
+ */
+export declare function createMockEntity<T extends Record<string, unknown>>(data: T, options?: MockEntityOptions): T & MockEntityMethods;
+export interface MockEntityMethods {
+    Get(fieldName: string): unknown;
+    Set(fieldName: string, value: unknown): void;
+    GetAll(): Record<string, unknown>;
+    readonly Dirty: boolean;
+    readonly IsSaved: boolean;
+    readonly PrimaryKey: {
+        KeyValuePairs: Array<{
+            FieldName: string;
+            Value: unknown;
+        }>;
+        Values: () => string;
+    };
+    Save(): Promise<boolean>;
+    Delete(): Promise<boolean>;
+}
+//# sourceMappingURL=mock-entity.d.ts.map

package/dist/mock-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-entity.d.ts","sourceRoot":"","sources":["../src/mock-entity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,iBAAsB,GAC9B,CAAC,GAAG,iBAAiB,CAiEvB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE;QAAE,aAAa,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC;IAC3G,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B"}

package/dist/mock-entity.js

@@ -0,0 +1,74 @@
+/**
+ * Creates a mock object that behaves like a BaseEntity with getter/setter properties.
+ * Since BaseEntity uses getter/setters, the spread operator doesn't work on real entities.
+ * This creates a Proxy-based mock that supports Get(), Set(), GetAll(), and property access.
+ *
+ * @param data Initial field values for the mock entity
+ * @param options Configuration options for the mock's state
+ * @returns A proxy object that behaves like a BaseEntity
+ */
+export function createMockEntity(data, options = {}) {
+    const { isSaved = true, isDirty = false } = options;
+    const fields = new Map(Object.entries(data));
+    const oldValues = new Map(Object.entries(data));
+    let dirty = isDirty;
+    const methods = {
+        Get(fieldName) {
+            const lowerKey = [...fields.keys()].find(k => k.toLowerCase() === fieldName.toLowerCase());
+            return lowerKey ? fields.get(lowerKey) : undefined;
+        },
+        Set(fieldName, value) {
+            fields.set(fieldName, value);
+            dirty = true;
+        },
+        GetAll() {
+            const result = {};
+            for (const [key, value] of fields) {
+                result[key] = value;
+            }
+            return result;
+        },
+        get Dirty() {
+            return dirty;
+        },
+        get IsSaved() {
+            return isSaved;
+        },
+        get PrimaryKey() {
+            return {
+                KeyValuePairs: [{ FieldName: 'ID', Value: fields.get('ID') }],
+                Values: () => String(fields.get('ID') ?? ''),
+            };
+        },
+        async Save() {
+            dirty = false;
+            return true;
+        },
+        async Delete() {
+            return true;
+        },
+    };
+    return new Proxy(methods, {
+        get(target, prop) {
+            // Check methods first
+            if (prop in target) {
+                const val = target[prop];
+                return val;
+            }
+            // Then check data fields
+            const lowerProp = prop.toLowerCase();
+            for (const [key, value] of fields) {
+                if (key.toLowerCase() === lowerProp) {
+                    return value;
+                }
+            }
+            return undefined;
+        },
+        set(_target, prop, value) {
+            fields.set(prop, value);
+            dirty = true;
+            return true;
+        },
+    });
+}
+//# sourceMappingURL=mock-entity.js.map

package/dist/mock-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-entity.js","sourceRoot":"","sources":["../src/mock-entity.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAO,EACP,UAA6B,EAAE;IAE/B,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAkB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAkB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,KAAK,GAAG,OAAO,CAAC;IAEpB,MAAM,OAAO,GAAsB;QACjC,GAAG,CAAC,SAAiB;YACnB,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3F,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrD,CAAC;QACD,GAAG,CAAC,SAAiB,EAAE,KAAc;YACnC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC7B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM;YACJ,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,UAAU;YACZ,OAAO;gBACL,aAAa,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC7C,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI;YACR,KAAK,GAAG,KAAK,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,MAAM;YACV,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,MAAM,EAAE,IAAY;YACtB,sBAAsB;YACtB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,MAAM,CAAC,IAA+B,CAAC,CAAC;gBACpD,OAAO,GAAG,CAAC;YACb,CAAC;YACD,yBAAyB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;gBAClC,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;oBACpC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAY,EAAE,KAAK;YAC9B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAA0B,CAAC;AAC9B,CAAC"}

package/dist/mock-run-view.d.ts

@@ -0,0 +1,50 @@
+interface RunViewResult<T = unknown> {
+    Success: boolean;
+    Results: T[];
+    ErrorMessage?: string;
+    TotalRowCount?: number;
+    RowCount: number;
+    Metrics?: Record<string, unknown>;
+}
+type RunViewMockMap = Map<string, unknown[]>;
+/**
+ * Configure mock responses for RunView calls.
+ * Responses are keyed by entity name (case-insensitive).
+ *
+ * @param responses Map of entity name to array of result objects
+ *
+ * @example
+ * ```ts
+ * mockRunView(new Map([
+ *   ['Users', [{ ID: '1', Name: 'Test User' }]],
+ *   ['AI Models', [{ ID: '2', Name: 'GPT-4' }]],
+ * ]));
+ * ```
+ */
+export declare function mockRunView(responses: RunViewMockMap): void;
+/**
+ * Create a mock RunView instance that returns configured test data.
+ * Use with vi.mock() to replace the real RunView.
+ */
+export declare function createMockRunViewClass(): {
+    new (): {
+        RunView<T = unknown>(params: {
+            EntityName?: string;
+            ExtraFilter?: string;
+        }): Promise<RunViewResult<T>>;
+        RunViews<T = unknown>(paramsList: Array<{
+            EntityName?: string;
+        }>): Promise<Array<RunViewResult<T>>>;
+    };
+};
+/**
+ * Configure mock responses for batch RunViews calls.
+ * Same as mockRunView but semantically indicates batch usage.
+ */
+export declare function mockRunViews(responses: RunViewMockMap): void;
+/**
+ * Reset all RunView mock responses.
+ */
+export declare function resetRunViewMocks(): void;
+export {};
+//# sourceMappingURL=mock-run-view.d.ts.map

package/dist/mock-run-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-run-view.d.ts","sourceRoot":"","sources":["../src/mock-run-view.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa,CAAC,CAAC,GAAG,OAAO;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAI7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAI3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB;;gBAEpB,CAAC,oBAAoB;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;iBAW7F,CAAC,wBAAwB,KAAK,CAAC;YAAE,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;;EAQ5G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/mock-run-view.js

@@ -0,0 +1,57 @@
+let _mockResponses = new Map();
+/**
+ * Configure mock responses for RunView calls.
+ * Responses are keyed by entity name (case-insensitive).
+ *
+ * @param responses Map of entity name to array of result objects
+ *
+ * @example
+ * ```ts
+ * mockRunView(new Map([
+ *   ['Users', [{ ID: '1', Name: 'Test User' }]],
+ *   ['AI Models', [{ ID: '2', Name: 'GPT-4' }]],
+ * ]));
+ * ```
+ */
+export function mockRunView(responses) {
+    _mockResponses = new Map([...responses.entries()].map(([k, v]) => [k.toLowerCase(), v]));
+}
+/**
+ * Create a mock RunView instance that returns configured test data.
+ * Use with vi.mock() to replace the real RunView.
+ */
+export function createMockRunViewClass() {
+    return class MockRunView {
+        async RunView(params) {
+            const entityName = params.EntityName?.toLowerCase() ?? '';
+            const results = (_mockResponses.get(entityName) ?? []);
+            return {
+                Success: true,
+                Results: results,
+                RowCount: results.length,
+                TotalRowCount: results.length,
+            };
+        }
+        async RunViews(paramsList) {
+            const results = [];
+            for (const params of paramsList) {
+                results.push(await this.RunView(params));
+            }
+            return results;
+        }
+    };
+}
+/**
+ * Configure mock responses for batch RunViews calls.
+ * Same as mockRunView but semantically indicates batch usage.
+ */
+export function mockRunViews(responses) {
+    mockRunView(responses);
+}
+/**
+ * Reset all RunView mock responses.
+ */
+export function resetRunViewMocks() {
+    _mockResponses = new Map();
+}
+//# sourceMappingURL=mock-run-view.js.map

package/dist/mock-run-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-run-view.js","sourceRoot":"","sources":["../src/mock-run-view.ts"],"names":[],"mappings":"AAaA,IAAI,cAAc,GAAmB,IAAI,GAAG,EAAE,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,SAAyB;IACnD,cAAc,GAAG,IAAI,GAAG,CACtB,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,MAAM,WAAW;QACtB,KAAK,CAAC,OAAO,CAAc,MAAqD;YAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAQ,CAAC;YAC9D,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,OAAO,CAAC,MAAM;gBACxB,aAAa,EAAE,OAAO,CAAC,MAAM;aAC9B,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ,CAAc,UAA0C;YACpE,MAAM,OAAO,GAA4B,EAAE,CAAC;YAC5C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAI,MAAM,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAyB;IACpD,WAAW,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;AAC7B,CAAC"}

package/dist/singleton-reset.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reset ALL MJ singletons by clearing their entries from the global object store.
+ * Call this in beforeEach() to ensure clean test isolation.
+ */
+export declare function resetMJSingletons(): void;
+/**
+ * Reset just the ClassFactory registrations without destroying the MJGlobal singleton.
+ * Lighter weight than resetMJSingletons - use when you only need a clean ClassFactory.
+ */
+export declare function resetClassFactory(): void;
+/**
+ * Clear the global ObjectCache.
+ */
+export declare function resetObjectCache(): void;
+//# sourceMappingURL=singleton-reset.d.ts.map

package/dist/singleton-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton-reset.d.ts","sourceRoot":"","sources":["../src/singleton-reset.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CASxC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/singleton-reset.js

@@ -0,0 +1,30 @@
+import { MJGlobal } from '@memberjunction/global';
+import { GetGlobalObjectStore } from '@memberjunction/global';
+/**
+ * Reset ALL MJ singletons by clearing their entries from the global object store.
+ * Call this in beforeEach() to ensure clean test isolation.
+ */
+export function resetMJSingletons() {
+    const store = GetGlobalObjectStore();
+    if (store) {
+        const indexableStore = store;
+        const singletonKeys = Object.keys(indexableStore).filter(k => k.startsWith('___SINGLETON__'));
+        for (const key of singletonKeys) {
+            delete indexableStore[key];
+        }
+    }
+}
+/**
+ * Reset just the ClassFactory registrations without destroying the MJGlobal singleton.
+ * Lighter weight than resetMJSingletons - use when you only need a clean ClassFactory.
+ */
+export function resetClassFactory() {
+    MJGlobal.Instance.Reset();
+}
+/**
+ * Clear the global ObjectCache.
+ */
+export function resetObjectCache() {
+    MJGlobal.Instance.ObjectCache.Clear();
+}
+//# sourceMappingURL=singleton-reset.js.map

package/dist/singleton-reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton-reset.js","sourceRoot":"","sources":["../src/singleton-reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,cAAc,GAAG,KAAgC,CAAC;QACxD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC9F,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,10 +1,30 @@
 {
   "name": "@memberjunction/unit-testing",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/unit-testing",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "4.3.0",
+  "description": "MemberJunction: Unit testing utilities and mock infrastructure for Vitest",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "devDependencies": {
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@memberjunction/global": "4.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }