@genesislcap/foundation-auth 14.124.0 → 14.125.0

package/README.md

@@ -20,6 +20,9 @@ not limited to:
 * `AuthRouting`: A routing utility, which you can call `navigateTo(...)` to navigate to internal routes.
 * Various UI components / route screens, some of which are lazy loaded on-demand to optimise the experience.
 
+For applications that do not or cannot use the DI system, we export utility functions to get each from the DI container.
+For example, `getUser`, `getAuthStore`, `getAuthMachine`, `getAuthRouting` etc.
+
 Many of these are available as [subpath exports](https://nodejs.org/api/packages.html#subpath-exports) and should be
 imported from these to optimise bundling and overall efficiency.
 
@@ -43,7 +46,7 @@ These examples are based on a host application using [FAST](https://www.fast.des
 choice should be quite similar. 
 
 ## Environment variables
-`foundation-auth` uses the following environment variables. The `.env` file below shows the built-in defaults used.
+`foundation-auth` uses the following environment variables. The `.env` file below shows the built-in defaults used with `API_HOST`.
 
 ```dotenv
 # There should be nothing sensitive here!
@@ -77,7 +80,7 @@ config(); // < loads the .env vars
 module.exports = {
   ...
   plugins: [
-    new DefinePlugin(resolveDefineConfig(['GENX_*'])), // < code replacement
+    new DefinePlugin(resolveDefineConfig(['GENX_*'])), // < code replacement should include 'API_HOST' if set, ie. ['GENX_*', 'API_HOST', ...]
   ],
 }
 ```
@@ -92,9 +95,9 @@ import { User } from '@genesislcap/foundation-auth/user';
 
 ...or via a utility if your app is not using decorators or the DI container.
 ```ts
-import { getUser, User } from '@genesislcap/foundation-auth/user';
+import { getUser } from '@genesislcap/foundation-auth/user';
 ...
-private user: User = getUser();
+private user = getUser();
 ```
 
 User properties are decorated with `@observable`, meaning in FAST terms it's reactive, and you can bind to properties
@@ -105,7 +108,7 @@ an event listener.
 import type { UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';
 ...
 const unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {
-  console.log('User authenticated?', event.detail); // < detail is a boolean
+  console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated
 });
 ```
 

package/dist/dts/machine/machine.d.ts

@@ -62,4 +62,35 @@ export declare class DefaultAuthMachine extends AbstractMachine<AuthMachineConte
  * @internal
  */
 export declare const AuthMachine: import("@microsoft/fast-foundation").InterfaceSymbol<AuthMachine>;
+/**
+ * Get AuthMachine from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthMachine } from '@genesislcap/foundation-auth/machine';
+ * import { getUser, UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';
+ * ...
+ * private authMachine = getAuthMachine();
+ * ...
+ * private user = getUser();
+ * private unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {
+ *   console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated
+ * });
+ * ...
+ * this.authMachine.send({
+ *   type: 'login',
+ *   params: {
+ *     type: CredentialType.BASIC,
+ *     username: 'JohnWick',
+ *     password: '***********',
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare function getAuthMachine(): AuthMachine;
 //# sourceMappingURL=machine.d.ts.map

package/dist/dts/machine/machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/machine/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,iBAAiB,EAMjB,OAAO,EACR,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAGrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAEL,iBAAiB,EAIlB,MAAM,eAAe,CAAC;AAYvB,OAAO,EACL,iBAAiB,EAQlB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAGhB,WAAW,EACX,WAAW,EAEZ,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;CAAG;AAErF;;;GAGG;AACH,qBAAa,kBACX,SAAQ,eAAe,CAAC,kBAAkB,EAAE,gBAAgB,CAC5D,YAAW,WAAW;IAGd,OAAO,CAAC,IAAI;IACJ,OAAO,CAAC,YAAY;IACf,OAAO,CAAC,EAAE;IACvB,OAAO,CAAC,IAAI;IACC,OAAO,CAAC,aAAa;IAC5B,OAAO,CAAC,MAAM;IACb,OAAO,CAAC,OAAO;gBANd,IAAI,EAAE,IAAI,EACF,YAAY,EAAE,YAAY,EACrB,EAAE,EAAE,iBAAiB,EAClC,IAAI,EAAE,IAAI,EACG,aAAa,EAAE,iBAAiB,EACvC,MAAM,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW;IAkjB3C,KAAK,CACH,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAM9C;IAKH;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB,SAAS,CAAC,sBAAsB,IAAI,WAAW;IAQ/C,SAAS,CAAC,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAuB3E,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,iBAAiB;IAgB3E,SAAS,CAAC,YAAY;;;;;;;;;;;;;;;;;MAoBpB;IAEF,SAAS,CAAC,aAAa;;;MAGpB;CACJ;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mEAA0E,CAAC"}
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/machine/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,YAAY,EACZ,iBAAiB,EAMjB,OAAO,EACR,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAGrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAEL,iBAAiB,EAIlB,MAAM,eAAe,CAAC;AAYvB,OAAO,EACL,iBAAiB,EAQlB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAGhB,WAAW,EACX,WAAW,EAEZ,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;CAAG;AAErF;;;GAGG;AACH,qBAAa,kBACX,SAAQ,eAAe,CAAC,kBAAkB,EAAE,gBAAgB,CAC5D,YAAW,WAAW;IAGd,OAAO,CAAC,IAAI;IACJ,OAAO,CAAC,YAAY;IACf,OAAO,CAAC,EAAE;IACvB,OAAO,CAAC,IAAI;IACC,OAAO,CAAC,aAAa;IAC5B,OAAO,CAAC,MAAM;IACb,OAAO,CAAC,OAAO;gBANd,IAAI,EAAE,IAAI,EACF,YAAY,EAAE,YAAY,EACrB,EAAE,EAAE,iBAAiB,EAClC,IAAI,EAAE,IAAI,EACG,aAAa,EAAE,iBAAiB,EACvC,MAAM,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW;IAkjB3C,KAAK,CACH,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAM9C;IAKH;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB,SAAS,CAAC,sBAAsB,IAAI,WAAW;IAQ/C,SAAS,CAAC,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAuB3E,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,iBAAiB;IAgB3E,SAAS,CAAC,YAAY;;;;;;;;;;;;;;;;;MAoBpB;IAEF,SAAS,CAAC,aAAa;;;MAGpB;CACJ;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mEAA0E,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/dts/store/auth.d.ts

@@ -77,5 +77,21 @@ export declare class DefaultAuthStore extends AbstractStoreRoot<AuthStore, AuthE
  * @internal
  */
 export declare const AuthStore: import("@microsoft/fast-foundation").InterfaceSymbol<AuthStore>;
+/**
+ * Get AuthStore from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthStore } from '@genesislcap/foundation-auth/store';
+ * ...
+ * private authStore = getAuthStore();
+ * ```
+ *
+ * @public
+ */
+export declare function getAuthStore(): AuthStore;
 export {};
 //# sourceMappingURL=auth.d.ts.map

package/dist/dts/store/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/store/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EACL,iBAAiB,EAEjB,SAAS,EACT,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,uBAAuB,GAChD,mBAAmB,GAAG;IACpB,YAAY,EAAE,WAAW,CAAC;IAC1B,aAAa,EAAE,IAAI,CAAC;IACpB,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,qBAAqB,EAAE,mBAAmB,CAAC;CAC5C,CAAC;AAEJ,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAoB,SAAQ,cAAc,CAAC,YAAY,CAAC;KAAG;CACtE;AAED,KAAK,oBAAoB,GAAG,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7E,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IACjE,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;;GAGG;AACH,qBAAa,gBACX,SAAQ,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,oBAAoB,CACvE,YAAW,SAAS;IAGN,QAAQ,CAAC,MAAM,EAAE,UAAU;IAC1B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,kBAAkB;gBAFrC,MAAM,EAAE,UAAU,EACjB,WAAW,EAAE,WAAW,EACjB,SAAS,EAAE,kBAAkB;IAK5D,wCAAwC;IACxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,6CAA6C;IAC7C,cAAc,gBAGZ;IAEF,sCAAsC;IACtC,OAAO,gBAKL;IAEF,uCAAuC;IACvC,QAAQ,gBAAuF;IAE/F,+CAA+C;IAC/C,gBAAgB,gBAKd;IAEF,+CAA+C;IAC/C,gBAAgB,gBAKd;IAEF,8CAA8C;IAC9C,eAAe,gBAKb;IAEF,2CAA2C;IAC3C,IAAI,YAAY,aAEf;IAED,4CAA4C;IAC5C,IAAI,aAAa,aAShB;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,iEAA0D,CAAC"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/store/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EACL,iBAAiB,EAEjB,SAAS,EACT,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,uBAAuB,GAChD,mBAAmB,GAAG;IACpB,YAAY,EAAE,WAAW,CAAC;IAC1B,aAAa,EAAE,IAAI,CAAC;IACpB,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,qBAAqB,EAAE,mBAAmB,CAAC;CAC5C,CAAC;AAEJ,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAoB,SAAQ,cAAc,CAAC,YAAY,CAAC;KAAG;CACtE;AAED,KAAK,oBAAoB,GAAG,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7E,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IACjE,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;;GAGG;AACH,qBAAa,gBACX,SAAQ,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,oBAAoB,CACvE,YAAW,SAAS;IAGN,QAAQ,CAAC,MAAM,EAAE,UAAU;IAC1B,QAAQ,CAAC,WAAW,EAAE,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,kBAAkB;gBAFrC,MAAM,EAAE,UAAU,EACjB,WAAW,EAAE,WAAW,EACjB,SAAS,EAAE,kBAAkB;IAK5D,wCAAwC;IACxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,6CAA6C;IAC7C,cAAc,gBAGZ;IAEF,sCAAsC;IACtC,OAAO,gBAKL;IAEF,uCAAuC;IACvC,QAAQ,gBAAuF;IAE/F,+CAA+C;IAC/C,gBAAgB,gBAKd;IAEF,+CAA+C;IAC/C,gBAAgB,gBAKd;IAEF,8CAA8C;IAC9C,eAAe,gBAKb;IAEF,2CAA2C;IAC3C,IAAI,YAAY,aAEf;IAED,4CAA4C;IAC5C,IAAI,aAAa,aAShB;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,iEAA0D,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/dist/esm/machine/machine.js

@@ -666,3 +666,36 @@ export { DefaultAuthMachine };
  * @internal
  */
 export const AuthMachine = DI.createInterface((x) => x.singleton(DefaultAuthMachine));
+/**
+ * Get AuthMachine from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthMachine } from '@genesislcap/foundation-auth/machine';
+ * import { getUser, UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';
+ * ...
+ * private authMachine = getAuthMachine();
+ * ...
+ * private user = getUser();
+ * private unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {
+ *   console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated
+ * });
+ * ...
+ * this.authMachine.send({
+ *   type: 'login',
+ *   params: {
+ *     type: CredentialType.BASIC,
+ *     username: 'JohnWick',
+ *     password: '***********',
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+export function getAuthMachine() {
+    return DI.getOrCreateDOMContainer().get(AuthMachine);
+}

package/dist/esm/store/auth.js

@@ -1,5 +1,6 @@
 import { __decorate, __param } from "tslib";
 import { AbstractStoreRoot, registerStore, } from '@genesislcap/foundation-store';
+import { DI } from '@microsoft/fast-foundation';
 import { AuthConfig } from '../config/config';
 import { AuthMachine } from '../machine/machine';
 import { AuthFormEntryStore } from './authFormEntry';
@@ -69,3 +70,21 @@ export { DefaultAuthStore };
  * @internal
  */
 export const AuthStore = registerStore(DefaultAuthStore, 'AuthStore');
+/**
+ * Get AuthStore from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthStore } from '@genesislcap/foundation-auth/store';
+ * ...
+ * private authStore = getAuthStore();
+ * ```
+ *
+ * @public
+ */
+export function getAuthStore() {
+    return DI.getOrCreateDOMContainer().get(AuthStore);
+}

package/dist/foundation-auth.api.json

@@ -10524,6 +10524,64 @@
             "endIndex": 5
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-auth!getAuthMachine:function(1)",
+          "docComment": "/**\n * Get AuthMachine from the DI container.\n *\n * @remarks\n *\n * A utility method for host applications that are not using decorators or the DI container.\n *\n * @example\n * ```ts\n * import { getAuthMachine } from '@genesislcap/foundation-auth/machine';\n * import { getUser, UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';\n * ...\n * private authMachine = getAuthMachine();\n * ...\n * private user = getUser();\n * private unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {\n *   console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated\n * });\n * ...\n * this.authMachine.send({\n *   type: 'login',\n *   params: {\n *     type: CredentialType.BASIC,\n *     username: 'JohnWick',\n *     password: '***********',\n *   },\n * });\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getAuthMachine(): "
+            },
+            {
+              "kind": "Reference",
+              "text": "AuthMachine",
+              "canonicalReference": "@genesislcap/foundation-auth!AuthMachine:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/machine/machine.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "getAuthMachine"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-auth!getAuthStore:function(1)",
+          "docComment": "/**\n * Get AuthStore from the DI container.\n *\n * @remarks\n *\n * A utility method for host applications that are not using decorators or the DI container.\n *\n * @example\n * ```ts\n * import { getAuthStore } from '@genesislcap/foundation-auth/store';\n * ...\n * private authStore = getAuthStore();\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getAuthStore(): "
+            },
+            {
+              "kind": "Reference",
+              "text": "AuthStore",
+              "canonicalReference": "@genesislcap/foundation-auth!AuthStore:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/store/auth.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "getAuthStore"
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-auth!GetCredentialOptions:type",

package/dist/foundation-auth.d.ts

@@ -1788,6 +1788,55 @@ export declare const fromDTOStringArray: (arr: string[]) => string[];
  */
 export declare const fromIDPDTO: (dto: IDENTITY_PROVIDER) => IdentityProvider;
 
+/**
+ * Get AuthMachine from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthMachine } from '@genesislcap/foundation-auth/machine';
+ * import { getUser, UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';
+ * ...
+ * private authMachine = getAuthMachine();
+ * ...
+ * private user = getUser();
+ * private unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {
+ *   console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated
+ * });
+ * ...
+ * this.authMachine.send({
+ *   type: 'login',
+ *   params: {
+ *     type: CredentialType.BASIC,
+ *     username: 'JohnWick',
+ *     password: '***********',
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare function getAuthMachine(): AuthMachine;
+
+/**
+ * Get AuthStore from the DI container.
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAuthStore } from '@genesislcap/foundation-auth/store';
+ * ...
+ * private authStore = getAuthStore();
+ * ```
+ *
+ * @public
+ */
+export declare function getAuthStore(): AuthStore;
+
 /**
  * Represents options for retrieving credentials.
  * @public

package/docs/api/foundation-auth.getauthmachine.md

@@ -0,0 +1,45 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-auth](./foundation-auth.md) &gt; [getAuthMachine](./foundation-auth.getauthmachine.md)
+
+## getAuthMachine() function
+
+Get AuthMachine from the DI container.
+
+**Signature:**
+
+```typescript
+export declare function getAuthMachine(): AuthMachine;
+```
+**Returns:**
+
+[AuthMachine](./foundation-auth.authmachine.md)
+
+## Remarks
+
+A utility method for host applications that are not using decorators or the DI container.
+
+## Example
+
+
+```ts
+import { getAuthMachine } from '@genesislcap/foundation-auth/machine';
+import { getUser, UserAuthenticationChangeEvent } from '@genesislcap/foundation-auth/user';
+...
+private authMachine = getAuthMachine();
+...
+private user = getUser();
+private unsubscribeUser = this.user.addAuthenticationChangeListener((event: UserAuthenticationChangeEvent) => {
+  console.log('User authenticated?', event.detail); // < boolean === this.user.isAuthenticated
+});
+...
+this.authMachine.send({
+  type: 'login',
+  params: {
+    type: CredentialType.BASIC,
+    username: 'JohnWick',
+    password: '***********',
+  },
+});
+```
+

package/docs/api/foundation-auth.getauthstore.md

@@ -0,0 +1,30 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-auth](./foundation-auth.md) &gt; [getAuthStore](./foundation-auth.getauthstore.md)
+
+## getAuthStore() function
+
+Get AuthStore from the DI container.
+
+**Signature:**
+
+```typescript
+export declare function getAuthStore(): AuthStore;
+```
+**Returns:**
+
+[AuthStore](./foundation-auth.authstore.md)
+
+## Remarks
+
+A utility method for host applications that are not using decorators or the DI container.
+
+## Example
+
+
+```ts
+import { getAuthStore } from '@genesislcap/foundation-auth/store';
+...
+private authStore = getAuthStore();
+```
+

package/docs/api/foundation-auth.md

@@ -34,6 +34,8 @@
 |  --- | --- |
 |  [configure(config)](./foundation-auth.configure.md) | configure. |
 |  [createHTTPHeadersFromDTO(dto, contentType)](./foundation-auth.createhttpheadersfromdto.md) | createHTTPHeadersFromDTO. |
+|  [getAuthMachine()](./foundation-auth.getauthmachine.md) | Get AuthMachine from the DI container. |
+|  [getAuthStore()](./foundation-auth.getauthstore.md) | Get AuthStore from the DI container. |
 |  [getRoutePath(route, hostPath)](./foundation-auth.getroutepath.md) | A utility to get a sub route path taking the host path into account. |
 |  [getUser()](./foundation-auth.getuser.md) | Gets User from the DI container. |
 |  [isChangePasswordParams(params)](./foundation-auth.ischangepasswordparams.md) | isChangePasswordParams. |

package/docs/api-report.md

@@ -1011,6 +1011,12 @@ export const fromDTOStringArray: (arr: string[]) => string[];
 // @public
 export const fromIDPDTO: (dto: IDENTITY_PROVIDER) => IdentityProvider;
 
+// @public
+export function getAuthMachine(): AuthMachine;
+
+// @public
+export function getAuthStore(): AuthStore;
+
 // @public
 export type GetCredentialOptions = CredentialRequestOptions & {};
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-auth",
   "description": "Genesis Foundation Auth",
-  "version": "14.124.0",
+  "version": "14.125.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/foundation-auth.d.ts",
@@ -36,6 +36,10 @@
       "types": "./dist/dts/routes/routing.d.ts",
       "default": "./dist/esm/routes/routing.js"
     },
+    "./store": {
+      "types": "./dist/dts/store/index.d.ts",
+      "default": "./dist/esm/store/index.js"
+    },
     "./user": {
       "types": "./dist/dts/user/index.d.ts",
       "default": "./dist/esm/user/index.js"
@@ -60,6 +64,9 @@
       "routing": [
         "./dist/dts/routes/routing.d.ts"
       ],
+      "store": [
+        "./dist/dts/store/index.d.ts"
+      ],
       "user": [
         "./dist/dts/user/index.d.ts"
       ],
@@ -99,19 +106,19 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.124.0",
-    "@genesislcap/genx": "14.124.0",
+    "@genesislcap/foundation-testing": "14.125.0",
+    "@genesislcap/genx": "14.125.0",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.124.0",
-    "@genesislcap/foundation-events": "14.124.0",
-    "@genesislcap/foundation-logger": "14.124.0",
-    "@genesislcap/foundation-state-machine": "14.124.0",
-    "@genesislcap/foundation-store": "14.124.0",
-    "@genesislcap/foundation-ui": "14.124.0",
-    "@genesislcap/foundation-utils": "14.124.0",
-    "@genesislcap/foundation-zero": "14.124.0",
+    "@genesislcap/foundation-comms": "14.125.0",
+    "@genesislcap/foundation-events": "14.125.0",
+    "@genesislcap/foundation-logger": "14.125.0",
+    "@genesislcap/foundation-state-machine": "14.125.0",
+    "@genesislcap/foundation-store": "14.125.0",
+    "@genesislcap/foundation-ui": "14.125.0",
+    "@genesislcap/foundation-utils": "14.125.0",
+    "@genesislcap/foundation-zero": "14.125.0",
     "@microsoft/fast-components": "^2.21.3",
     "@microsoft/fast-element": "^1.7.0",
     "@microsoft/fast-foundation": "^2.33.2",
@@ -131,5 +138,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ecbf83be72d1f020f8b189282c5199479dd55a3e"
+  "gitHead": "c59496ce3895b80fa7faf7fb4d2b58b5a64355ba"
 }