@sprucelabs/spruce-heartwood-utils 16.3.15 → 16.4.0

package/build/__tests__/support/MockRemoteViewControllerFactory.d.ts

@@ -0,0 +1,15 @@
+import { ViewControllerMap, ControllerOptions } from '@sprucelabs/heartwood-view-controllers';
+import { RemoteViewControllerFactory } from '../../skillViews/RemoteViewControllerFactory';
+export default class MockRemoteViewControllerFactory implements RemoteViewControllerFactory {
+    private static instance?;
+    private loadedControllers;
+    private remoteControllerOptions?;
+    constructor();
+    Controller<N extends keyof ViewControllerMap, O extends ControllerOptions<N>>(_name: N, _options: O): ViewControllerMap[N];
+    static reset(): void;
+    static getInstance(): MockRemoteViewControllerFactory;
+    getTheme(_namespace?: string | undefined): undefined;
+    assertFetchedRemoteController(id: string, options?: Record<string, any>): void;
+    hasController(name: string): boolean;
+    RemoteController(name: string, options: Record<string, any>): Promise<any>;
+}

package/build/__tests__/support/MockRemoteViewControllerFactory.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_utils_1 = require("@sprucelabs/test-utils");
+class MockRemoteViewControllerFactory {
+    constructor() {
+        this.loadedControllers = {};
+        MockRemoteViewControllerFactory.instance = this;
+    }
+    Controller(_name, _options) {
+        return {};
+    }
+    static reset() {
+        delete this.instance;
+    }
+    static getInstance() {
+        if (!this.instance) {
+            throw 'You did not create a RemoveViewControllerFactory instance (and setup the mock factory). In your test try RemoteViewControllerFactoryImpl.Class = MockRemoteViewControllerFactory and in your skill view try this.remove = RemoteViewControllerFactoryImpl.Factory(...)';
+        }
+        return this.instance;
+    }
+    getTheme(_namespace) {
+        return undefined;
+    }
+    assertFetchedRemoteController(id, options) {
+        test_utils_1.assert.isTrue(this.hasController(id), `You never tried to fetch a controller with the id '${id}'. Try remoteViews.RemoteController(...)`);
+        if (options) {
+            test_utils_1.assert.isEqualDeep(this.remoteControllerOptions, options, `You did not pass the expected options to remoteViews.RemoteController(${id}, options)`);
+        }
+    }
+    hasController(name) {
+        var _a;
+        return (_a = this.loadedControllers[name]) !== null && _a !== void 0 ? _a : false;
+    }
+    async RemoteController(name, options) {
+        this.loadedControllers[name] = true;
+        this.remoteControllerOptions = options;
+        return {};
+    }
+}
+exports.default = MockRemoteViewControllerFactory;
+//# sourceMappingURL=MockRemoteViewControllerFactory.js.map

package/build/__tests__/support/heartwoodEventFaker.d.ts

@@ -0,0 +1,4 @@
+declare const heartwoodEventFaker: {
+    fakeGetViews(svcIds: string[], stubMethodToImplement?: string | undefined): Promise<void>;
+};
+export default heartwoodEventFaker;

package/build/__tests__/support/heartwoodEventFaker.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const spruce_test_fixtures_1 = require("@sprucelabs/spruce-test-fixtures");
+const test_utils_1 = require("@sprucelabs/test-utils");
+const heartwoodEventFaker = {
+    async fakeGetViews(svcIds, stubMethodToImplement) {
+        const vcs = svcIds.map((id) => ({
+            id,
+            stubMethod: stubMethodToImplement,
+        }));
+        const source = [
+            ...vcs.map((vc, idx) => generateVcSource({
+                vcId: vc.id,
+                count: idx + 1,
+                stubMethod: vc.stubMethod,
+            })),
+            `heartwood({ ${vcs.map((vc, idx) => `TestEventViewController${idx + 1}`)} })`,
+        ];
+        await spruce_test_fixtures_1.eventFaker.on('heartwood.get-skill-views::v2021_02_11', () => {
+            return {
+                id: (0, test_utils_1.generateId)(),
+                ids: svcIds,
+                source: source.join('\n'),
+            };
+        });
+    },
+};
+exports.default = heartwoodEventFaker;
+function generateVcSource(options) {
+    const { vcId, count, stubMethod } = options;
+    return [
+        `class TestEventViewController${count} {
+			alert = function() {}
+			${stubMethod !== null && stubMethod !== void 0 ? stubMethod : 'noop'} = function () {
+				this.wasHit = true
+				this.passedParams = Array.prototype.slice.call(arguments)
+			}
+			setTriggerRenderHandler = function(handler) {
+				this.triggerRender = handler
+			}
+			render = function() {
+				return {
+					id: '${vcId}',
+					controller: this,
+				}
+			}
+		}`,
+        `TestEventViewController${count}.id = '${vcId}'`,
+    ].join('\n\n');
+}
+//# sourceMappingURL=heartwoodEventFaker.js.map

package/build/__tests__/support/remoteVcAssert.d.ts

@@ -1,7 +1,10 @@
 import { SkillViewController } from '@sprucelabs/heartwood-view-controllers';
 import { SkillEventContract } from '@sprucelabs/mercury-types';
 import { ArgsFromSvc, ViewFixture } from '@sprucelabs/spruce-test-fixtures';
-declare type EventNames = keyof SkillEventContract['eventSignatures'];
+declare const remoteVcAssert: {
+    assertSkillViewRendersRemoteCards<Svc extends SkillViewController<Record<string, any>> = SkillViewController<Record<string, any>>>(options: AssertRendersRemoteCardsOptions<Svc>): Promise<void>;
+};
+export default remoteVcAssert;
 export interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController = SkillViewController> {
     svc: Svc;
     fqen: EventNames;
@@ -14,7 +17,4 @@ export interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController
         expectedParams?: any[];
     };
 }
-declare const remoteVcAssert: {
-    assertSkillViewRendersRemoteCards<Svc extends SkillViewController<Record<string, any>> = SkillViewController<Record<string, any>>>(options: AssertRendersRemoteCardsOptions<Svc>): Promise<void>;
-};
-export default remoteVcAssert;
+declare type EventNames = keyof SkillEventContract['eventSignatures'];

package/build/__tests__/support/remoteVcAssert.js

@@ -1,10 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const heartwood_view_controllers_1 = require("@sprucelabs/heartwood-view-controllers");
 const schema_1 = require("@sprucelabs/schema");
 const spruce_test_fixtures_1 = require("@sprucelabs/spruce-test-fixtures");
 const test_utils_1 = require("@sprucelabs/test-utils");
 const test_utils_2 = require("@sprucelabs/test-utils");
+const heartwoodEventFaker_1 = __importDefault(require("./heartwoodEventFaker"));
 const remoteVcAssert = {
     async assertSkillViewRendersRemoteCards(options) {
         var _a;
@@ -30,26 +34,9 @@ const remoteVcAssert = {
                 vcIds: ['assert.' + vc1Id, 'assert.' + vc2Id],
             };
         });
-        await spruce_test_fixtures_1.eventFaker.on('heartwood.get-skill-views::v2021_02_11', () => {
-            const source = [
-                generateVcSource({
-                    vcId: vc1Id,
-                    count: 1,
-                    stubMethod: shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName,
-                }),
-                generateVcSource({
-                    vcId: vc2Id,
-                    count: 2,
-                    stubMethod: shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName,
-                }),
-                `heartwood({ TestEventViewController1, TestEventViewController2 })`,
-            ].join('\n');
-            return {
-                id: (0, test_utils_2.generateId)(),
-                ids: [vc1Id, vc2Id],
-                source,
-            };
-        });
+        const stubMethodName = shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName;
+        const ids = [vc1Id, vc2Id];
+        await heartwoodEventFaker_1.default.fakeGetViews(ids, stubMethodName);
         await views.load(svc, loadArgs);
         test_utils_1.assert.isTrue(wasHit, `You did not load any remote cards. Next step is to add the following to your skill view's load():\n\nconst registrar = new CardRegistrar(...)\nconst cards = await registrar.fetch(...)\n\nAlso, make sure you create the new event that you'll emit when trying to fetch remote cards, something like 'my-skill.register-cards::v2020_02_02'\n\n`);
         if (expectedTarget) {
@@ -97,28 +84,6 @@ The original error is: ${(_a = err.stack) !== null && _a !== void 0 ? _a : err.m
         }
     },
 };
-function generateVcSource(options) {
-    const { vcId, count, stubMethod } = options;
-    return [
-        `class TestEventViewController${count} {
-			alert = function() {}
-			${stubMethod !== null && stubMethod !== void 0 ? stubMethod : 'noop'} = function () {
-				this.wasHit = true
-				this.passedParams = Array.prototype.slice.call(arguments)
-			}
-			setTriggerRenderHandler = function(handler) {
-				this.triggerRender = handler
-			}
-			render = function() {
-				return {
-					id: '${vcId}',
-					controller: this,
-				}
-			}
-		}`,
-        `TestEventViewController${count}.id = '${vcId}'`,
-    ].join('\n\n');
-}
 class ThrowingErrorCardVc extends heartwood_view_controllers_1.AbstractViewController {
     constructor(options) {
         super(options);

package/build/esm/__tests__/support/MockRemoteViewControllerFactory.d.ts

@@ -0,0 +1,15 @@
+import { ViewControllerMap, ControllerOptions } from '@sprucelabs/heartwood-view-controllers';
+import { RemoteViewControllerFactory } from '../../skillViews/RemoteViewControllerFactory';
+export default class MockRemoteViewControllerFactory implements RemoteViewControllerFactory {
+    private static instance?;
+    private loadedControllers;
+    private remoteControllerOptions?;
+    constructor();
+    Controller<N extends keyof ViewControllerMap, O extends ControllerOptions<N>>(_name: N, _options: O): ViewControllerMap[N];
+    static reset(): void;
+    static getInstance(): MockRemoteViewControllerFactory;
+    getTheme(_namespace?: string | undefined): undefined;
+    assertFetchedRemoteController(id: string, options?: Record<string, any>): void;
+    hasController(name: string): boolean;
+    RemoteController(name: string, options: Record<string, any>): Promise<any>;
+}

package/build/esm/__tests__/support/MockRemoteViewControllerFactory.js

@@ -0,0 +1,48 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { assert } from '@sprucelabs/test-utils';
+export default class MockRemoteViewControllerFactory {
+    constructor() {
+        this.loadedControllers = {};
+        MockRemoteViewControllerFactory.instance = this;
+    }
+    Controller(_name, _options) {
+        return {};
+    }
+    static reset() {
+        delete this.instance;
+    }
+    static getInstance() {
+        if (!this.instance) {
+            throw 'You did not create a RemoveViewControllerFactory instance (and setup the mock factory). In your test try RemoteViewControllerFactoryImpl.Class = MockRemoteViewControllerFactory and in your skill view try this.remove = RemoteViewControllerFactoryImpl.Factory(...)';
+        }
+        return this.instance;
+    }
+    getTheme(_namespace) {
+        return undefined;
+    }
+    assertFetchedRemoteController(id, options) {
+        assert.isTrue(this.hasController(id), `You never tried to fetch a controller with the id '${id}'. Try remoteViews.RemoteController(...)`);
+        if (options) {
+            assert.isEqualDeep(this.remoteControllerOptions, options, `You did not pass the expected options to remoteViews.RemoteController(${id}, options)`);
+        }
+    }
+    hasController(name) {
+        var _a;
+        return (_a = this.loadedControllers[name]) !== null && _a !== void 0 ? _a : false;
+    }
+    RemoteController(name, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.loadedControllers[name] = true;
+            this.remoteControllerOptions = options;
+            return {};
+        });
+    }
+}

package/build/esm/__tests__/support/heartwoodEventFaker.d.ts

@@ -0,0 +1,4 @@
+declare const heartwoodEventFaker: {
+    fakeGetViews(svcIds: string[], stubMethodToImplement?: string | undefined): Promise<void>;
+};
+export default heartwoodEventFaker;

package/build/esm/__tests__/support/heartwoodEventFaker.js

@@ -0,0 +1,59 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { eventFaker } from '@sprucelabs/spruce-test-fixtures';
+import { generateId } from '@sprucelabs/test-utils';
+const heartwoodEventFaker = {
+    fakeGetViews(svcIds, stubMethodToImplement) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const vcs = svcIds.map((id) => ({
+                id,
+                stubMethod: stubMethodToImplement,
+            }));
+            const source = [
+                ...vcs.map((vc, idx) => generateVcSource({
+                    vcId: vc.id,
+                    count: idx + 1,
+                    stubMethod: vc.stubMethod,
+                })),
+                `heartwood({ ${vcs.map((vc, idx) => `TestEventViewController${idx + 1}`)} })`,
+            ];
+            yield eventFaker.on('heartwood.get-skill-views::v2021_02_11', () => {
+                return {
+                    id: generateId(),
+                    ids: svcIds,
+                    source: source.join('\n'),
+                };
+            });
+        });
+    },
+};
+export default heartwoodEventFaker;
+function generateVcSource(options) {
+    const { vcId, count, stubMethod } = options;
+    return [
+        `class TestEventViewController${count} {
+			alert = function() {}
+			${stubMethod !== null && stubMethod !== void 0 ? stubMethod : 'noop'} = function () {
+				this.wasHit = true
+				this.passedParams = Array.prototype.slice.call(arguments)
+			}
+			setTriggerRenderHandler = function(handler) {
+				this.triggerRender = handler
+			}
+			render = function() {
+				return {
+					id: '${vcId}',
+					controller: this,
+				}
+			}
+		}`,
+        `TestEventViewController${count}.id = '${vcId}'`,
+    ].join('\n\n');
+}

package/build/esm/__tests__/support/remoteVcAssert.d.ts

@@ -1,7 +1,10 @@
 import { SkillViewController } from '@sprucelabs/heartwood-view-controllers';
 import { SkillEventContract } from '@sprucelabs/mercury-types';
 import { ArgsFromSvc, ViewFixture } from '@sprucelabs/spruce-test-fixtures';
-declare type EventNames = keyof SkillEventContract['eventSignatures'];
+declare const remoteVcAssert: {
+    assertSkillViewRendersRemoteCards<Svc extends SkillViewController<Record<string, any>> = SkillViewController<Record<string, any>>>(options: AssertRendersRemoteCardsOptions<Svc>): Promise<void>;
+};
+export default remoteVcAssert;
 export interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController = SkillViewController> {
     svc: Svc;
     fqen: EventNames;
@@ -14,7 +17,4 @@ export interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController
         expectedParams?: any[];
     };
 }
-declare const remoteVcAssert: {
-    assertSkillViewRendersRemoteCards<Svc extends SkillViewController<Record<string, any>> = SkillViewController<Record<string, any>>>(options: AssertRendersRemoteCardsOptions<Svc>): Promise<void>;
-};
-export default remoteVcAssert;
+declare type EventNames = keyof SkillEventContract['eventSignatures'];

package/build/esm/__tests__/support/remoteVcAssert.js

@@ -12,6 +12,7 @@ import { assertOptions } from '@sprucelabs/schema';
 import { eventFaker, } from '@sprucelabs/spruce-test-fixtures';
 import { assert } from '@sprucelabs/test-utils';
 import { generateId } from '@sprucelabs/test-utils';
+import heartwoodEventFaker from './heartwoodEventFaker.js';
 const remoteVcAssert = {
     assertSkillViewRendersRemoteCards(options) {
         var _a;
@@ -38,26 +39,9 @@ const remoteVcAssert = {
                     vcIds: ['assert.' + vc1Id, 'assert.' + vc2Id],
                 };
             }));
-            yield eventFaker.on('heartwood.get-skill-views::v2021_02_11', () => {
-                const source = [
-                    generateVcSource({
-                        vcId: vc1Id,
-                        count: 1,
-                        stubMethod: shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName,
-                    }),
-                    generateVcSource({
-                        vcId: vc2Id,
-                        count: 2,
-                        stubMethod: shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName,
-                    }),
-                    `heartwood({ TestEventViewController1, TestEventViewController2 })`,
-                ].join('\n');
-                return {
-                    id: generateId(),
-                    ids: [vc1Id, vc2Id],
-                    source,
-                };
-            });
+            const stubMethodName = shouldInvoke === null || shouldInvoke === void 0 ? void 0 : shouldInvoke.methodName;
+            const ids = [vc1Id, vc2Id];
+            yield heartwoodEventFaker.fakeGetViews(ids, stubMethodName);
             yield views.load(svc, loadArgs);
             assert.isTrue(wasHit, `You did not load any remote cards. Next step is to add the following to your skill view's load():\n\nconst registrar = new CardRegistrar(...)\nconst cards = await registrar.fetch(...)\n\nAlso, make sure you create the new event that you'll emit when trying to fetch remote cards, something like 'my-skill.register-cards::v2020_02_02'\n\n`);
             if (expectedTarget) {
@@ -106,28 +90,6 @@ The original error is: ${(_a = err.stack) !== null && _a !== void 0 ? _a : err.m
         });
     },
 };
-function generateVcSource(options) {
-    const { vcId, count, stubMethod } = options;
-    return [
-        `class TestEventViewController${count} {
-			alert = function() {}
-			${stubMethod !== null && stubMethod !== void 0 ? stubMethod : 'noop'} = function () {
-				this.wasHit = true
-				this.passedParams = Array.prototype.slice.call(arguments)
-			}
-			setTriggerRenderHandler = function(handler) {
-				this.triggerRender = handler
-			}
-			render = function() {
-				return {
-					id: '${vcId}',
-					controller: this,
-				}
-			}
-		}`,
-        `TestEventViewController${count}.id = '${vcId}'`,
-    ].join('\n\n');
-}
 class ThrowingErrorCardVc extends AbstractViewController {
     constructor(options) {
         super(options);

package/build/esm/index-module.d.ts

@@ -1,5 +1,6 @@
 export { default as RemoteViewControllerFactory } from './skillViews/RemoteViewControllerFactory';
 export { default as CardRegistrar } from './skillViews/CardRegistrar';
 export { default as remoteVcAssert } from './__tests__/support/remoteVcAssert';
+export { default as fakeGetViews } from './__tests__/support/heartwoodEventFaker';
 export * from './types/heartwood-module.types';
 export { default as loadActiveThemeForOrg } from './theming/loadActiveThemeForOrg';

package/build/esm/index-module.js

@@ -1,5 +1,6 @@
 export { default as RemoteViewControllerFactory } from './skillViews/RemoteViewControllerFactory.js';
 export { default as CardRegistrar } from './skillViews/CardRegistrar.js';
 export { default as remoteVcAssert } from './__tests__/support/remoteVcAssert.js';
+export { default as fakeGetViews } from './__tests__/support/heartwoodEventFaker.js';
 export * from './types/heartwood-module.types.js';
 export { default as loadActiveThemeForOrg } from './theming/loadActiveThemeForOrg.js';

package/build/esm/skillViews/CardRegistrar.js

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { assertOptions } from '@sprucelabs/schema';
-import RemoteViewControllerFactory from './RemoteViewControllerFactory.js';
+import RemoteViewControllerFactoryImpl from './RemoteViewControllerFactory.js';
 export default class CardRegistrar {
     /** @ts-ignore */
     constructor(options) {
@@ -21,7 +21,7 @@ export default class CardRegistrar {
         this.client = options.client;
         this.eventName = options.eventName;
         this.vcIdsTransformer = options.vcIdsTransformer;
-        this.remoteVcFactory = RemoteViewControllerFactory.Factory({
+        this.remoteVcFactory = RemoteViewControllerFactoryImpl.Factory({
             //@ts-ignore
             connectToApi: () => options.client,
             vcFactory: options.vcFactory,
@@ -84,6 +84,7 @@ export default class CardRegistrar {
     }
     ErrorCardVc(err) {
         return this.remoteVcFactory.Controller('heartwood.error-card', {
+            //@ts-ignore
             error: err,
         });
     }

package/build/esm/skillViews/RemoteViewControllerFactory.d.ts

@@ -1,16 +1,18 @@
-import { ViewController, ViewControllerFactory } from '@sprucelabs/heartwood-view-controllers';
+import { ControllerOptions, ViewController, ViewControllerFactory, ViewControllerId, ViewControllerMap } from '@sprucelabs/heartwood-view-controllers';
 import { MercuryClient } from '@sprucelabs/mercury-client';
 import { SkillTheme } from '../theming/ThemeManager';
-export default class RemoteViewControllerFactory implements Factory {
+export default class RemoteViewControllerFactoryImpl implements RemoteViewControllerFactory {
+    static Class?: new (options: RemoteFactoryOptions) => RemoteViewControllerFactory;
     static Request: any;
     private connectToApi;
     private vcFactory;
     private themesByNamespace;
-    static Factory(options: FactoryOptions): RemoteViewControllerFactory;
+    static Factory(options: RemoteFactoryOptions): RemoteViewControllerFactory;
+    static reset(): void;
     private constructor();
     hasController(name: string): boolean;
     getTheme(namespace?: string): SkillTheme;
-    Controller(name: string, options: Record<string, any>): any;
+    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(name: N, options: O): ViewControllerMap[N];
     private getNamespace;
     getController(name: string): any;
     fetchRemoteController(name: string): Promise<(new () => ViewController<any>) & {
@@ -20,11 +22,16 @@ export default class RemoteViewControllerFactory implements Factory {
     private optionallyLoadController;
     private fetchFromUrl;
 }
+declare type Theme = SkillTheme;
 declare type ConnectToApi = () => Promise<MercuryClient>;
 export declare type VcFactoryForRemoteFactory = Pick<ViewControllerFactory, 'setController' | 'hasController' | 'getController' | 'Controller' | 'importControllers'>;
-interface FactoryOptions {
+export interface RemoteFactoryOptions {
     connectToApi: ConnectToApi;
     vcFactory: VcFactoryForRemoteFactory;
 }
-declare type Factory = Pick<ViewControllerFactory, 'hasController'>;
+declare type Factory = Pick<ViewControllerFactory, 'hasController' | 'Controller'>;
+export interface RemoteViewControllerFactory extends Factory {
+    RemoteController: (name: string, options: Record<string, any>) => Promise<ViewController<Record<string, any>>>;
+    getTheme: (namespace?: string) => Theme | undefined;
+}
 export {};

package/build/esm/skillViews/RemoteViewControllerFactory.js

@@ -9,14 +9,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { ViewControllerImporter, } from '@sprucelabs/heartwood-view-controllers';
 import SpruceError from '../errors/SpruceError.js';
-export default class RemoteViewControllerFactory {
+export default class RemoteViewControllerFactoryImpl {
     constructor(options) {
         this.themesByNamespace = {};
         this.connectToApi = options.connectToApi;
         this.vcFactory = options.vcFactory;
     }
     static Factory(options) {
-        return new this(options);
+        var _a;
+        return new ((_a = this.Class) !== null && _a !== void 0 ? _a : this)(options);
+    }
+    static reset() {
+        delete this.Class;
     }
     hasController(name) {
         return this.vcFactory.hasController(name);
@@ -73,7 +77,7 @@ export default class RemoteViewControllerFactory {
     fetchFromUrl(sourceUrl) {
         return __awaiter(this, void 0, void 0, function* () {
             return (yield new Promise((resolve, reject) => {
-                const request = new RemoteViewControllerFactory.Request();
+                const request = new RemoteViewControllerFactoryImpl.Request();
                 request.open('GET', sourceUrl, true);
                 request.onload = () => {
                     if (request.readyState !== 4) {
@@ -94,4 +98,4 @@ export default class RemoteViewControllerFactory {
         });
     }
 }
-RemoteViewControllerFactory.Request = typeof XMLHttpRequest === 'undefined' ? {} : XMLHttpRequest;
+RemoteViewControllerFactoryImpl.Request = typeof XMLHttpRequest === 'undefined' ? {} : XMLHttpRequest;

package/build/index-module.d.ts

@@ -1,5 +1,6 @@
 export { default as RemoteViewControllerFactory } from './skillViews/RemoteViewControllerFactory';
 export { default as CardRegistrar } from './skillViews/CardRegistrar';
 export { default as remoteVcAssert } from './__tests__/support/remoteVcAssert';
+export { default as fakeGetViews } from './__tests__/support/heartwoodEventFaker';
 export * from './types/heartwood-module.types';
 export { default as loadActiveThemeForOrg } from './theming/loadActiveThemeForOrg';

package/build/index-module.js

@@ -17,13 +17,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadActiveThemeForOrg = exports.remoteVcAssert = exports.CardRegistrar = exports.RemoteViewControllerFactory = void 0;
+exports.loadActiveThemeForOrg = exports.fakeGetViews = exports.remoteVcAssert = exports.CardRegistrar = exports.RemoteViewControllerFactory = void 0;
 var RemoteViewControllerFactory_1 = require("./skillViews/RemoteViewControllerFactory");
 Object.defineProperty(exports, "RemoteViewControllerFactory", { enumerable: true, get: function () { return __importDefault(RemoteViewControllerFactory_1).default; } });
 var CardRegistrar_1 = require("./skillViews/CardRegistrar");
 Object.defineProperty(exports, "CardRegistrar", { enumerable: true, get: function () { return __importDefault(CardRegistrar_1).default; } });
 var remoteVcAssert_1 = require("./__tests__/support/remoteVcAssert");
 Object.defineProperty(exports, "remoteVcAssert", { enumerable: true, get: function () { return __importDefault(remoteVcAssert_1).default; } });
+var heartwoodEventFaker_1 = require("./__tests__/support/heartwoodEventFaker");
+Object.defineProperty(exports, "fakeGetViews", { enumerable: true, get: function () { return __importDefault(heartwoodEventFaker_1).default; } });
 __exportStar(require("./types/heartwood-module.types"), exports);
 var loadActiveThemeForOrg_1 = require("./theming/loadActiveThemeForOrg");
 Object.defineProperty(exports, "loadActiveThemeForOrg", { enumerable: true, get: function () { return __importDefault(loadActiveThemeForOrg_1).default; } });

package/build/skillViews/CardRegistrar.js

@@ -78,6 +78,7 @@ class CardRegistrar {
     }
     ErrorCardVc(err) {
         return this.remoteVcFactory.Controller('heartwood.error-card', {
+            //@ts-ignore
             error: err,
         });
     }

package/build/skillViews/RemoteViewControllerFactory.d.ts

@@ -1,16 +1,18 @@
-import { ViewController, ViewControllerFactory } from '@sprucelabs/heartwood-view-controllers';
+import { ControllerOptions, ViewController, ViewControllerFactory, ViewControllerId, ViewControllerMap } from '@sprucelabs/heartwood-view-controllers';
 import { MercuryClient } from '@sprucelabs/mercury-client';
 import { SkillTheme } from '../theming/ThemeManager';
-export default class RemoteViewControllerFactory implements Factory {
+export default class RemoteViewControllerFactoryImpl implements RemoteViewControllerFactory {
+    static Class?: new (options: RemoteFactoryOptions) => RemoteViewControllerFactory;
     static Request: any;
     private connectToApi;
     private vcFactory;
     private themesByNamespace;
-    static Factory(options: FactoryOptions): RemoteViewControllerFactory;
+    static Factory(options: RemoteFactoryOptions): RemoteViewControllerFactory;
+    static reset(): void;
     private constructor();
     hasController(name: string): boolean;
     getTheme(namespace?: string): SkillTheme;
-    Controller(name: string, options: Record<string, any>): any;
+    Controller<N extends ViewControllerId, O extends ControllerOptions<N>>(name: N, options: O): ViewControllerMap[N];
     private getNamespace;
     getController(name: string): any;
     fetchRemoteController(name: string): Promise<(new () => ViewController<any>) & {
@@ -20,11 +22,16 @@ export default class RemoteViewControllerFactory implements Factory {
     private optionallyLoadController;
     private fetchFromUrl;
 }
+declare type Theme = SkillTheme;
 declare type ConnectToApi = () => Promise<MercuryClient>;
 export declare type VcFactoryForRemoteFactory = Pick<ViewControllerFactory, 'setController' | 'hasController' | 'getController' | 'Controller' | 'importControllers'>;
-interface FactoryOptions {
+export interface RemoteFactoryOptions {
     connectToApi: ConnectToApi;
     vcFactory: VcFactoryForRemoteFactory;
 }
-declare type Factory = Pick<ViewControllerFactory, 'hasController'>;
+declare type Factory = Pick<ViewControllerFactory, 'hasController' | 'Controller'>;
+export interface RemoteViewControllerFactory extends Factory {
+    RemoteController: (name: string, options: Record<string, any>) => Promise<ViewController<Record<string, any>>>;
+    getTheme: (namespace?: string) => Theme | undefined;
+}
 export {};

package/build/skillViews/RemoteViewControllerFactory.js

@@ -5,14 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const heartwood_view_controllers_1 = require("@sprucelabs/heartwood-view-controllers");
 const SpruceError_1 = __importDefault(require("../errors/SpruceError"));
-class RemoteViewControllerFactory {
+class RemoteViewControllerFactoryImpl {
     constructor(options) {
         this.themesByNamespace = {};
         this.connectToApi = options.connectToApi;
         this.vcFactory = options.vcFactory;
     }
     static Factory(options) {
-        return new this(options);
+        var _a;
+        return new ((_a = this.Class) !== null && _a !== void 0 ? _a : this)(options);
+    }
+    static reset() {
+        delete this.Class;
     }
     hasController(name) {
         return this.vcFactory.hasController(name);
@@ -62,7 +66,7 @@ class RemoteViewControllerFactory {
     }
     async fetchFromUrl(sourceUrl) {
         return (await new Promise((resolve, reject) => {
-            const request = new RemoteViewControllerFactory.Request();
+            const request = new RemoteViewControllerFactoryImpl.Request();
             request.open('GET', sourceUrl, true);
             request.onload = () => {
                 if (request.readyState !== 4) {
@@ -82,6 +86,6 @@ class RemoteViewControllerFactory {
         }));
     }
 }
-exports.default = RemoteViewControllerFactory;
-RemoteViewControllerFactory.Request = typeof XMLHttpRequest === 'undefined' ? {} : XMLHttpRequest;
+exports.default = RemoteViewControllerFactoryImpl;
+RemoteViewControllerFactoryImpl.Request = typeof XMLHttpRequest === 'undefined' ? {} : XMLHttpRequest;
 //# sourceMappingURL=RemoteViewControllerFactory.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@sprucelabs/spruce-heartwood-utils",
 	"description": "Heartwood Utilities",
-	"version": "16.3.15",
+	"version": "16.4.0",
 	"skill": {
 		"namespace": "heartwood"
 	},
@@ -34,6 +34,14 @@
 		"build/__tests__/support/remoteVcAssert.d.ts",
 		"build/esm/__tests__/support/remoteVcAssert.js",
 		"build/esm/__tests__/support/remoteVcAssert.d.ts",
+		"build/__tests__/support/heartwoodEventFaker.js",
+		"build/__tests__/support/heartwoodEventFaker.d.ts",
+		"build/esm/__tests__/support/heartwoodEventFaker.js",
+		"build/esm/__tests__/support/heartwoodEventFaker.d.ts",
+		"build/__tests__/support/MockRemoteViewControllerFactory.js",
+		"build/__tests__/support/MockRemoteViewControllerFactory.d.ts",
+		"build/esm/__tests__/support/MockRemoteViewControllerFactory.js",
+		"build/esm/__tests__/support/MockRemoteViewControllerFactory.d.ts",
 		"build/utilities/slug.js",
 		"build/utilities/slug.d.ts",
 		"build/esm/utilities/slug.js",