@xh/hoist 75.0.0-SNAPSHOT.1753468710177 → 75.0.0-SNAPSHOT.1753485410401

package/README.md

@@ -289,7 +289,7 @@ available to application code, use the`XH.installServicesAsync()` method. This m
 construct, initialize, and install the services as a property on the XH object. Note that there is a
 strict expectation that service classes will be named ending with the word 'Service', e.g.
 `MyCustomService.`. The installed instance in this case would then be made available to application
-code as `XH.myCustomService'.
+code as `XH.myCustomService`.
 
 Many core Hoist features are exposed on the client via services such as `PrefService`,
 `ConfigService`, and `IdentityService`. See these examples for a better understanding of the kind of

package/appcontainer/AppContainerModel.ts

@@ -40,7 +40,7 @@ import {
     TrackService,
     WebSocketService
 } from '@xh/hoist/svc';
-import {checkMinVersion, throwIf} from '@xh/hoist/utils/js';
+import {checkMinVersion, createSingleton, throwIf} from '@xh/hoist/utils/js';
 import {compact, isEmpty} from 'lodash';
 import {AboutDialogModel} from './AboutDialogModel';
 import {BannerSourceModel} from './BannerSourceModel';
@@ -197,7 +197,7 @@ export class AppContainerModel extends HoistModel {
 
             // Check auth, locking out, or showing login if possible
             this.setAppState('AUTHENTICATING');
-            XH.authModel = new this.appSpec.authModelClass();
+            XH.authModel = createSingleton(this.appSpec.authModelClass);
             const isAuthenticated = await XH.authModel.completeAuthAsync();
             if (!isAuthenticated) {
                 throwIf(
@@ -287,8 +287,7 @@ export class AppContainerModel extends HoistModel {
             await wait(XH.isDevelopmentMode ? 300 : 1);
 
             this.setAppState('INITIALIZING_APP');
-            const modelClass: any = this.appSpec.modelClass;
-            this.appModel = modelClass.instance = new modelClass();
+            this.appModel = createSingleton(this.appSpec.modelClass);
             await this.appModel.initAsync();
             this.startRouter();
             this.startOptionsDialog();

package/build/types/utils/js/LangUtils.d.ts

@@ -44,6 +44,16 @@ export declare function warnIf(condition: any, message: any): void;
  * Log an error to the console if a condition evaluates as truthy.
  */
 export declare function errorIf(condition: any, message: any): void;
+/**
+ * Instantiate a singleton object of a class, and place a reference to the created
+ * object in a static property on the class.
+ *
+ * This pattern is useful to allow gaining typed references to the singleton via import
+ * and is used for creating the singleton HoistServices, AuthModel, and AppModel.
+ *
+ * @param clazz -- Class (i.e. Constructor) of singleton object to be created.
+ */
+export declare function createSingleton<T>(clazz: new () => T): T;
 export interface APIWarnOptions {
     /**
      * If provided and undefined, this method will be a no-op.

package/core/impl/InstallServices.ts

@@ -6,7 +6,7 @@
  */
 import {HoistService, HoistServiceClass, Some, XH} from '@xh/hoist/core';
 import {instanceManager} from '@xh/hoist/core/impl/InstanceManager';
-import {throwIf} from '@xh/hoist/utils/js';
+import {createSingleton, throwIf} from '@xh/hoist/utils/js';
 import {camelCase, castArray} from 'lodash';
 
 /**
@@ -30,7 +30,7 @@ export async function installServicesAsync(serviceClasses: Some<HoistServiceClas
     const notSvc = serviceClasses.find((it: any) => !it.isHoistService);
     throwIf(notSvc, `Cannot initialize ${notSvc?.name} - does not extend HoistService`);
 
-    const svcs = serviceClasses.map(serviceClass => new serviceClass());
+    const svcs = serviceClasses.map(c => createSingleton(c));
     await initServicesInternalAsync(svcs);
 
     svcs.forEach(svc => {
@@ -43,7 +43,6 @@ export async function installServicesAsync(serviceClasses: Some<HoistServiceClas
                 install the same service twice.`
         );
         XH[name] = svc;
-        (clazz as any).instance = svc;
         instanceManager.registerService(svc);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "75.0.0-SNAPSHOT.1753468710177",
+  "version": "75.0.0-SNAPSHOT.1753485410401",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",