@cratis/arc 20.54.5 → 20.55.0

package/dist/cjs/identity/IdentityProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityProvider.js","sources":["../../../identity/IdentityProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor, JsonSerializer } from '@cratis/fundamentals';\nimport { IIdentityProvider } from './IIdentityProvider';\nimport { IIdentity } from './IIdentity';\nimport { IdentityProviderResult } from './IdentityProviderResult';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { joinPaths } from '../joinPaths';\n\n/**\n * Represents an implementation of {@link IIdentityProvider}.\n*/\nexport class IdentityProvider extends IIdentityProvider {\n\n    static readonly CookieName = '.cratis-identity';\n    static httpHeadersCallback: GetHttpHeaders | undefined;\n    static apiBasePath: string = '';\n    static origin: string = '';\n\n    /**\n     * Sets the HTTP headers callback.\n     * @param callback Callback to set.\n     */\n    static setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        IdentityProvider.httpHeadersCallback = callback;\n    }\n\n    /**\n     * Sets the API base path.\n     * @param apiBasePath API base path to set.\n     */\n    static setApiBasePath(apiBasePath: string): void {\n        IdentityProvider.apiBasePath = apiBasePath;\n    }\n\n    /**\n     * Sets the origin.\n     * @param origin Origin to set.\n     */\n    static setOrigin(origin: string): void {\n        IdentityProvider.origin = origin;\n    }\n\n    /**\n     * Gets the current identity by optionally specifying the details type.\n     * @param type Optional constructor for the details type to enable type-safe deserialization.\n     * @returns The current identity as {@link IIdentity}.\n     * @remarks The `extends object` constraint is required for compatibility with JsonSerializer.deserializeFromInstance().\n     */\n    static async getCurrent<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        const cookie = this.getCookie();\n        if (cookie.length == 2) {\n            const json = atob(cookie[1]);\n            const result = JSON.parse(json) as IdentityProviderResult;\n            const details = type ? JsonSerializer.deserializeFromInstance(type, result.details) : result.details;\n            return {\n                id: result.id,\n                name: result.name,\n                roles: result.roles || [],\n                details: details as TDetails,\n                isSet: true,\n                isInRole: (role: string) => (result.roles || []).includes(role),\n                refresh: () => IdentityProvider.refresh(type)\n            } as IIdentity<TDetails>;\n        } else {\n            const identity = await this.refresh<TDetails>(type);\n            return identity;\n        }\n    }\n\n    /** @inheritdoc */\n    async getCurrent<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        return IdentityProvider.getCurrent<TDetails>(type);\n    }\n\n    static async refresh<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        IdentityProvider.clearIdentityCookie();\n        const origin = IdentityProvider.origin || Globals.origin || '';\n        const apiBasePath = IdentityProvider.apiBasePath || Globals.apiBasePath || '';\n        const route = joinPaths(apiBasePath, '/.cratis/me');\n        const url = UrlHelpers.createUrlFrom(origin, apiBasePath, route);\n        const response = await fetch(\n            url, {\n            method: 'GET',\n            headers: IdentityProvider.httpHeadersCallback?.() ?? {}\n        });\n\n        if (!response.ok) {\n            return IdentityProvider.notSet(type);\n        }\n\n        const result = await response.json() as IdentityProviderResult;\n        const details = type ? JsonSerializer.deserializeFromInstance(type, result.details) : result.details;\n\n        return {\n            id: result.id,\n            name: result.name,\n            roles: result.roles || [],\n            details: details as TDetails,\n            isSet: true,\n            isInRole: (role: string) => (result.roles || []).includes(role),\n            refresh: () => IdentityProvider.refresh(type)\n        };\n    }\n\n    private static notSet<TDetails extends object = object>(type?: Constructor<TDetails>): IIdentity<TDetails> {\n        return {\n            id: '',\n            name: '',\n            roles: [],\n            details: {} as TDetails,\n            isSet: false,\n            isInRole: () => false,\n            refresh: () => IdentityProvider.refresh(type)\n        };\n    }\n\n    private static getCookie() {\n        if (typeof document === 'undefined') return [];\n        const decoded = decodeURIComponent(document.cookie);\n        const cookies = decoded.split(';').map(_ => _.trim());\n        const cookie = cookies.find(_ => _.indexOf(`${IdentityProvider.CookieName}=`) == 0);\n        if (cookie) {\n            const keyValue = cookie.split('=');\n            return [keyValue[0].trim(), keyValue[1].trim()];\n        }\n        return [];\n    }\n\n    /**\n     * Clears the identity cookie used by Arc to cache the current identity.\n     * Call this when the user logs out to ensure subsequent requests and WebSocket\n     * connections do not carry stale credentials.\n     */\n    static clearIdentityCookie(): void {\n        if (typeof document === 'undefined') return;\n        document.cookie = `${IdentityProvider.CookieName}=;expires=Thu, 01 Jan 1970 00:00:00 GMT`;\n    }\n}\n"],"names":["IIdentityProvider","JsonSerializer","Globals","joinPaths","UrlHelpers"],"mappings":";;;;;;;;AAeM,MAAO,gBAAiB,SAAQA,mCAAiB,CAAA;AAEnD,IAAA,OAAgB,UAAU,GAAG,kBAAkB;IAC/C,OAAO,mBAAmB;AAC1B,IAAA,OAAO,WAAW,GAAW,EAAE;AAC/B,IAAA,OAAO,MAAM,GAAW,EAAE;IAM1B,OAAO,sBAAsB,CAAC,QAAwB,EAAA;AAClD,QAAA,gBAAgB,CAAC,mBAAmB,GAAG,QAAQ;IACnD;IAMA,OAAO,cAAc,CAAC,WAAmB,EAAA;AACrC,QAAA,gBAAgB,CAAC,WAAW,GAAG,WAAW;IAC9C;IAMA,OAAO,SAAS,CAAC,MAAc,EAAA;AAC3B,QAAA,gBAAgB,CAAC,MAAM,GAAG,MAAM;IACpC;AAQA,IAAA,aAAa,UAAU,CAAmC,IAA4B,EAAA;AAClF,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE;AAC/B,QAAA,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B;YACzD,MAAM,OAAO,GAAG,IAAI,GAAGC,2BAAc,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO;YACpG,OAAO;gBACH,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;AACjB,gBAAA,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;AACzB,gBAAA,OAAO,EAAE,OAAmB;AAC5B,gBAAA,KAAK,EAAE,IAAI;AACX,gBAAA,QAAQ,EAAE,CAAC,IAAY,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC;gBAC/D,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI;aACxB;QAC5B;aAAO;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAW,IAAI,CAAC;AACnD,YAAA,OAAO,QAAQ;QACnB;IACJ;IAGA,MAAM,UAAU,CAAmC,IAA4B,EAAA;AAC3E,QAAA,OAAO,gBAAgB,CAAC,UAAU,CAAW,IAAI,CAAC;IACtD;AAEA,IAAA,aAAa,OAAO,CAAmC,IAA4B,EAAA;QAC/E,gBAAgB,CAAC,mBAAmB,EAAE;QACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,IAAIC,eAAO,CAAC,MAAM,IAAI,EAAE;QAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,IAAIA,eAAO,CAAC,WAAW,IAAI,EAAE;QAC7E,MAAM,KAAK,GAAGC,mBAAS,CAAC,WAAW,EAAE,aAAa,CAAC;AACnD,QAAA,MAAM,GAAG,GAAGC,qBAAU,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC;AAChE,QAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CACxB,GAAG,EAAE;AACL,YAAA,MAAM,EAAE,KAAK;AACb,YAAA,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,IAAI,IAAI;AACxD,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AACd,YAAA,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;QACxC;AAEA,QAAA,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA4B;QAC9D,MAAM,OAAO,GAAG,IAAI,GAAGH,2BAAc,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO;QAEpG,OAAO;YACH,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;AACjB,YAAA,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;AACzB,YAAA,OAAO,EAAE,OAAmB;AAC5B,YAAA,KAAK,EAAE,IAAI;AACX,YAAA,QAAQ,EAAE,CAAC,IAAY,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC;YAC/D,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI;SAC/C;IACL;IAEQ,OAAO,MAAM,CAAmC,IAA4B,EAAA;QAChF,OAAO;AACH,YAAA,EAAE,EAAE,EAAE;AACN,YAAA,IAAI,EAAE,EAAE;AACR,YAAA,KAAK,EAAE,EAAE;AACT,YAAA,OAAO,EAAE,EAAc;AACvB,YAAA,KAAK,EAAE,KAAK;AACZ,YAAA,QAAQ,EAAE,MAAM,KAAK;YACrB,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI;SAC/C;IACL;AAEQ,IAAA,OAAO,SAAS,GAAA;QACpB,IAAI,OAAO,QAAQ,KAAK,WAAW;AAAE,YAAA,OAAO,EAAE;QAC9C,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA,EAAG,gBAAgB,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC;QACnF,IAAI,MAAM,EAAE;YACR,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AAClC,YAAA,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD;AACA,QAAA,OAAO,EAAE;IACb;AAOA,IAAA,OAAO,mBAAmB,GAAA;QACtB,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE;QACrC,QAAQ,CAAC,MAAM,GAAG,CAAA,EAAG,gBAAgB,CAAC,UAAU,yCAAyC;IAC7F;;;;;"}
+{"version":3,"file":"IdentityProvider.js","sources":["../../../identity/IdentityProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor, JsonSerializer } from '@cratis/fundamentals';\nimport { IIdentityProvider } from './IIdentityProvider';\nimport { IIdentity } from './IIdentity';\nimport { IdentityProviderResult } from './IdentityProviderResult';\nimport { GetHttpHeaders } from '../GetHttpHeaders';\nimport { Globals } from '../Globals';\nimport { UrlHelpers } from '../UrlHelpers';\nimport { joinPaths } from '../joinPaths';\n\n/**\n * Represents an implementation of {@link IIdentityProvider}.\n*/\nexport class IdentityProvider extends IIdentityProvider {\n\n    static readonly CookieName = '.cratis-identity';\n    static httpHeadersCallback: GetHttpHeaders | undefined;\n    static apiBasePath: string = '';\n    static origin: string = '';\n\n    /**\n     * Sets the HTTP headers callback.\n     * @param callback Callback to set.\n     */\n    static setHttpHeadersCallback(callback: GetHttpHeaders): void {\n        IdentityProvider.httpHeadersCallback = callback;\n    }\n\n    /**\n     * Sets the API base path.\n     * @param apiBasePath API base path to set.\n     */\n    static setApiBasePath(apiBasePath: string): void {\n        IdentityProvider.apiBasePath = apiBasePath;\n    }\n\n    /**\n     * Sets the origin.\n     * @param origin Origin to set.\n     */\n    static setOrigin(origin: string): void {\n        IdentityProvider.origin = origin;\n    }\n\n    /**\n     * Gets the current identity by optionally specifying the details type.\n     * @param type Optional constructor for the details type to enable type-safe deserialization.\n     * @returns The current identity as {@link IIdentity}.\n     * @remarks The `extends object` constraint is required for compatibility with JsonSerializer.deserializeFromInstance().\n     */\n    static async getCurrent<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        const cookie = this.getCookie();\n        if (cookie.length == 2) {\n            const json = atob(cookie[1]);\n            const result = JSON.parse(json) as IdentityProviderResult;\n            const details = type ? JsonSerializer.deserializeFromInstance(type, result.details) : result.details;\n            return {\n                id: result.id,\n                name: result.name,\n                roles: result.roles || [],\n                details: details as TDetails,\n                isSet: true,\n                isInRole: (role: string) => (result.roles || []).includes(role),\n                refresh: () => IdentityProvider.refresh(type)\n            } as IIdentity<TDetails>;\n        } else {\n            const identity = await this.refresh<TDetails>(type);\n            return identity;\n        }\n    }\n\n    /** @inheritdoc */\n    async getCurrent<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        return IdentityProvider.getCurrent<TDetails>(type);\n    }\n\n    static async refresh<TDetails extends object = object>(type?: Constructor<TDetails>): Promise<IIdentity<TDetails>> {\n        IdentityProvider.clearIdentityCookie();\n        const origin = IdentityProvider.origin || Globals.origin || '';\n        const apiBasePath = IdentityProvider.apiBasePath || Globals.apiBasePath || '';\n        const route = joinPaths(apiBasePath, '/.cratis/me');\n        const url = UrlHelpers.createUrlFrom(origin, apiBasePath, route);\n        const response = await fetch(\n            url, {\n            method: 'GET',\n            headers: IdentityProvider.httpHeadersCallback?.() ?? {}\n        });\n\n        if (!response.ok) {\n            return IdentityProvider.notSet(type);\n        }\n\n        const result = await response.json() as IdentityProviderResult;\n        const details = type ? JsonSerializer.deserializeFromInstance(type, result.details) : result.details;\n\n        return {\n            id: result.id,\n            name: result.name,\n            roles: result.roles || [],\n            details: details as TDetails,\n            isSet: true,\n            isInRole: (role: string) => (result.roles || []).includes(role),\n            refresh: () => IdentityProvider.refresh(type)\n        };\n    }\n\n    private static notSet<TDetails extends object = object>(type?: Constructor<TDetails>): IIdentity<TDetails> {\n        return {\n            id: '',\n            name: '',\n            roles: [],\n            details: {} as TDetails,\n            isSet: false,\n            isInRole: () => false,\n            refresh: () => IdentityProvider.refresh(type)\n        };\n    }\n\n    private static getCookie() {\n        if (typeof document === 'undefined') return [];\n        const decoded = decodeURIComponent(document.cookie);\n        const cookies = decoded.split(';').map(_ => _.trim());\n        const cookie = cookies.find(_ => _.indexOf(`${IdentityProvider.CookieName}=`) == 0);\n        if (cookie) {\n            const keyValue = cookie.split('=');\n            return [keyValue[0].trim(), keyValue[1].trim()];\n        }\n        return [];\n    }\n\n    /**\n     * Clears the identity cookie used by Arc to cache the current identity.\n     * Call this when the user logs out to ensure subsequent requests and WebSocket\n     * connections do not carry stale credentials.\n     */\n    static clearIdentityCookie(): void {\n        if (typeof document === 'undefined') return;\n        document.cookie = `${IdentityProvider.CookieName}=;expires=Thu, 01 Jan 1970 00:00:00 GMT`;\n    }\n}\n"],"names":["IdentityProvider","IIdentityProvider","CookieName","httpHeadersCallback","apiBasePath","origin","setHttpHeadersCallback","callback","setApiBasePath","setOrigin","getCurrent","type","cookie","getCookie","length","json","atob","result","JSON","parse","details","JsonSerializer","deserializeFromInstance","id","name","roles","isSet","isInRole","role","includes","refresh","identity","clearIdentityCookie","Globals","route","joinPaths","url","UrlHelpers","createUrlFrom","response","fetch","method","headers","ok","notSet","document","decoded","decodeURIComponent","cookies","split","map","_","trim","find","indexOf","keyValue"],"mappings":"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"}

package/dist/cjs/identity/index.js

@@ -3,7 +3,8 @@
 var IdentityProvider = require('./IdentityProvider.js');
 var IIdentityProvider = require('./IIdentityProvider.js');
 
-
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 exports.IdentityProvider = IdentityProvider.IdentityProvider;
 exports.IIdentityProvider = IIdentityProvider.IIdentityProvider;

package/dist/cjs/identity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../identity/index.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nexport * from './IdentityProvider';\nexport * from './IdentityProviderResult';\nexport * from './IIdentityProvider';\nexport * from './IIdentity';\n"],"names":[],"mappings":";;;;;AAAA;AACA;;;;;"}

package/dist/cjs/index.js

@@ -22,8 +22,5 @@ exports.reflection = index$4;
 exports.joinPaths = joinPaths.joinPaths;
 exports.deepEqual = deepEqual.deepEqual;
 exports.Globals = Globals.Globals;
-Object.defineProperty(exports, "ObservableQueryTransferMode", {
-    enumerable: true,
-    get: function () { return Globals.ObservableQueryTransferMode; }
-});
+exports.ObservableQueryTransferMode = Globals.ObservableQueryTransferMode;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/joinPaths.js

@@ -1,5 +1,7 @@
 'use strict';
 
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 function joinPaths(...paths) {
     const joined = paths.join('/');
     return joined.replace('//', '/');

package/dist/cjs/joinPaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"joinPaths.js","sources":["../../joinPaths.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nexport function joinPaths(...paths) {\n    const joined = paths.join('/');\n    return joined.replace('//', '/');\n}"],"names":[],"mappings":";;AAGM,SAAU,SAAS,CAAC,GAAG,KAAK,EAAA;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;AACpC;;;;"}
+{"version":3,"file":"joinPaths.js","sources":["../../joinPaths.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nexport function joinPaths(...paths) {\n    const joined = paths.join('/');\n    return joined.replace('//', '/');\n}"],"names":["joinPaths","paths","joined","join","replace"],"mappings":";;AAAA;AACA;AAEO,SAASA,SAAAA,CAAU,GAAGC,KAAK,EAAA;IAC9B,MAAMC,MAAAA,GAASD,KAAAA,CAAME,IAAI,CAAC,GAAA,CAAA;IAC1B,OAAOD,MAAAA,CAAOE,OAAO,CAAC,IAAA,EAAM,GAAA,CAAA;AAChC;;;;"}

package/dist/cjs/messaging/IMessenger.js

@@ -1,6 +1,10 @@
 'use strict';
 
-class IMessenger {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Defines a system for publishing and subscribing to messages.
+ */ class IMessenger {
 }
 
 exports.IMessenger = IMessenger;

package/dist/cjs/messaging/IMessenger.js.map

@@ -1 +1 @@
-{"version":3,"file":"IMessenger.js","sources":["../../../messaging/IMessenger.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { Subscription } from 'rxjs';\n\n/**\n * Represents a message handler.\n */\nexport type MessageHandler<T> = (message: T) => void;\n\n/**\n * Defines a system for publishing and subscribing to messages.\n */\nexport abstract class IMessenger {\n\n    /**\n     * Gets or sets whether published messages should bubble to the parent messenger.\n     * Defaults to false.\n     */\n    abstract bubbleToParent: boolean;\n\n    /**\n     * Gets or sets whether messages should trickle down to child messengers.\n     * Defaults to true.\n     */\n    abstract trickleDownToChildren: boolean;\n\n    /**\n     * Publish a message.\n     * @param {*} message Message to publish.\n     */\n    abstract publish<TMessage extends object>(message: TMessage): void;\n\n    /**\n     * Subscribe to a specific message type.\n     * @param {MessageHandler} callback Callback that gets called when message arrives.\n     */\n    abstract subscribe<TMessage extends object>(type: Constructor<TMessage>, callback: MessageHandler<TMessage>): Subscription;\n}\n"],"names":[],"mappings":";;MAcsB,UAAU,CAAA;AAyB/B;;;;"}
+{"version":3,"file":"IMessenger.js","sources":["../../../messaging/IMessenger.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { Subscription } from 'rxjs';\n\n/**\n * Represents a message handler.\n */\nexport type MessageHandler<T> = (message: T) => void;\n\n/**\n * Defines a system for publishing and subscribing to messages.\n */\nexport abstract class IMessenger {\n\n    /**\n     * Gets or sets whether published messages should bubble to the parent messenger.\n     * Defaults to false.\n     */\n    abstract bubbleToParent: boolean;\n\n    /**\n     * Gets or sets whether messages should trickle down to child messengers.\n     * Defaults to true.\n     */\n    abstract trickleDownToChildren: boolean;\n\n    /**\n     * Publish a message.\n     * @param {*} message Message to publish.\n     */\n    abstract publish<TMessage extends object>(message: TMessage): void;\n\n    /**\n     * Subscribe to a specific message type.\n     * @param {MessageHandler} callback Callback that gets called when message arrives.\n     */\n    abstract subscribe<TMessage extends object>(type: Constructor<TMessage>, callback: MessageHandler<TMessage>): Subscription;\n}\n"],"names":["IMessenger"],"mappings":";;AAAA;AACA;AAUA;;AAEC,IACM,MAAeA,UAAAA,CAAAA;AAyBtB;;;;"}

package/dist/cjs/messaging/Message.js

@@ -1,9 +1,17 @@
 'use strict';
 
-class Message {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a message published on the {@link Messenger}.
+ */ class Message {
     type;
     content;
-    constructor(type, content) {
+    /**
+     * Initializes a new instance of {@link Message}.
+     * @param {Constructor} type Type of the content in the message.
+     * @param {*} content The actual content.
+     */ constructor(type, content){
         this.type = type;
         this.content = content;
     }

package/dist/cjs/messaging/Message.js.map

@@ -1 +1 @@
-{"version":3,"file":"Message.js","sources":["../../../messaging/Message.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\n\n/**\n * Represents a message published on the {@link Messenger}.\n */\nexport class Message {\n\n    /**\n     * Initializes a new instance of {@link Message}.\n     * @param {Constructor} type Type of the content in the message.\n     * @param {*} content The actual content.\n     */\n    constructor(readonly type: Constructor, readonly content: object) {\n    }\n}\n"],"names":[],"mappings":";;MAQa,OAAO,CAAA;AAOK,IAAA,IAAA;AAA4B,IAAA,OAAA;IAAjD,WAAA,CAAqB,IAAiB,EAAW,OAAe,EAAA;QAA3C,IAAA,CAAA,IAAI,GAAJ,IAAI;QAAwB,IAAA,CAAA,OAAO,GAAP,OAAO;IACxD;AACH;;;;"}
+{"version":3,"file":"Message.js","sources":["../../../messaging/Message.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\n\n/**\n * Represents a message published on the {@link Messenger}.\n */\nexport class Message {\n\n    /**\n     * Initializes a new instance of {@link Message}.\n     * @param {Constructor} type Type of the content in the message.\n     * @param {*} content The actual content.\n     */\n    constructor(readonly type: Constructor, readonly content: object) {\n    }\n}\n"],"names":["Message","content","type"],"mappings":";;AAAA;AACA;AAIA;;AAEC,IACM,MAAMA,OAAAA,CAAAA;;;AAET;;;;AAIC,QACD,YAAY,IAA0B,EAAWC,OAAe,CAAE;aAA7CC,IAAAA,GAAAA,IAAAA;aAA4BD,OAAAA,GAAAA,OAAAA;AACjD,IAAA;AACJ;;;;"}

package/dist/cjs/messaging/Messenger.js

@@ -4,26 +4,31 @@ var rxjs = require('rxjs');
 var IMessenger = require('./IMessenger.js');
 var Message = require('./Message.js');
 
-class Messenger extends IMessenger.IMessenger {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents an implementation of {@link IMessenger}.
+ */ class Messenger extends IMessenger.IMessenger {
     _parent;
     bubbleToParent = false;
     trickleDownToChildren = true;
     _messages = new rxjs.Subject();
     _children = new Set();
-    constructor(_parent) {
-        super();
-        this._parent = _parent;
+    constructor(_parent){
+        super(), this._parent = _parent;
         this._parent?._children.add(this);
     }
-    dispose() {
+    /**
+     * Dispose this messenger and remove it from its parent.
+     */ dispose() {
         this._parent?._children.delete(this);
     }
-    publish(message) {
+    /** @inheritdoc */ publish(message) {
         this._publishFromSelf(message);
     }
-    subscribe(type, callback) {
-        const observable = this._messages.pipe(rxjs.filter(m => m.type === type));
-        const subscription = observable.subscribe(m => callback(m.content));
+    /** @inheritdoc */ subscribe(type, callback) {
+        const observable = this._messages.pipe(rxjs.filter((m)=>m.type === type));
+        const subscription = observable.subscribe((m)=>callback(m.content));
         return subscription;
     }
     _publishFromSelf(message) {
@@ -54,7 +59,7 @@ class Messenger extends IMessenger.IMessenger {
         this._messages.next(new Message.Message(message.constructor, message));
     }
     _publishToChildren(message, excludedChild) {
-        this._children.forEach(child => {
+        this._children.forEach((child)=>{
             if (child === excludedChild) {
                 return;
             }

package/dist/cjs/messaging/Messenger.js.map

@@ -1 +1 @@
-{"version":3,"file":"Messenger.js","sources":["../../../messaging/Messenger.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { filter, Subject, Subscription } from 'rxjs';\nimport { IMessenger } from './IMessenger';\nimport { Message } from './Message';\n\n/**\n * Represents an implementation of {@link IMessenger}.\n */\nexport class Messenger extends IMessenger {\n    bubbleToParent = false;\n    trickleDownToChildren = true;\n\n    private readonly _messages = new Subject<Message>();\n    private readonly _children = new Set<Messenger>();\n\n    constructor(private readonly _parent?: Messenger) {\n        super();\n        this._parent?._children.add(this);\n    }\n\n    /**\n     * Dispose this messenger and remove it from its parent.\n     */\n    dispose() {\n        this._parent?._children.delete(this);\n    }\n\n    /** @inheritdoc */\n    publish<TMessage extends object>(message: TMessage): void {\n        this._publishFromSelf(message);\n    }\n\n    /** @inheritdoc */\n    subscribe<TMessage extends object>(type: Constructor<TMessage>, callback: (message: TMessage) => void): Subscription {\n        const observable = this._messages.pipe(filter(m => m.type === type));\n        const subscription = observable.subscribe(m => callback(m.content as TMessage));\n        return subscription;\n    }\n\n    private _publishFromSelf<TMessage extends object>(message: TMessage) {\n        this._publishLocally(message);\n\n        if (this.bubbleToParent && this._parent) {\n            this._parent._publishFromChild(message, this);\n        }\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message);\n        }\n    }\n\n    private _publishFromParent<TMessage extends object>(message: TMessage) {\n        this._publishLocally(message);\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message);\n        }\n    }\n\n    private _publishFromChild<TMessage extends object>(message: TMessage, child: Messenger) {\n        this._publishLocally(message);\n\n        if (this.bubbleToParent && this._parent) {\n            this._parent._publishFromChild(message, this);\n        }\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message, child);\n        }\n    }\n\n    private _publishLocally<TMessage extends object>(message: TMessage) {\n        this._messages.next(new Message(message.constructor as Constructor, message));\n    }\n\n    private _publishToChildren<TMessage extends object>(message: TMessage, excludedChild?: Messenger) {\n        this._children.forEach(child => {\n            if (child === excludedChild) {\n                return;\n            }\n            child._publishFromParent(message);\n        });\n    }\n}\n"],"names":["IMessenger","Subject","filter","Message"],"mappings":";;;;;;AAWM,MAAO,SAAU,SAAQA,qBAAU,CAAA;AAOR,IAAA,OAAA;IAN7B,cAAc,GAAG,KAAK;IACtB,qBAAqB,GAAG,IAAI;AAEX,IAAA,SAAS,GAAG,IAAIC,YAAO,EAAW;AAClC,IAAA,SAAS,GAAG,IAAI,GAAG,EAAa;AAEjD,IAAA,WAAA,CAA6B,OAAmB,EAAA;AAC5C,QAAA,KAAK,EAAE;QADkB,IAAA,CAAA,OAAO,GAAP,OAAO;QAEhC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;IACrC;IAKA,OAAO,GAAA;QACH,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;IACxC;AAGA,IAAA,OAAO,CAA0B,OAAiB,EAAA;AAC9C,QAAA,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;IAClC;IAGA,SAAS,CAA0B,IAA2B,EAAE,QAAqC,EAAA;QACjG,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAACC,WAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpE,QAAA,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAmB,CAAC,CAAC;AAC/E,QAAA,OAAO,YAAY;IACvB;AAEQ,IAAA,gBAAgB,CAA0B,OAAiB,EAAA;AAC/D,QAAA,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAE7B,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC;QACjD;AAEA,QAAA,IAAI,IAAI,CAAC,qBAAqB,EAAE;AAC5B,YAAA,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;QACpC;IACJ;AAEQ,IAAA,kBAAkB,CAA0B,OAAiB,EAAA;AACjE,QAAA,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;AAE7B,QAAA,IAAI,IAAI,CAAC,qBAAqB,EAAE;AAC5B,YAAA,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;QACpC;IACJ;IAEQ,iBAAiB,CAA0B,OAAiB,EAAE,KAAgB,EAAA;AAClF,QAAA,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAE7B,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC;QACjD;AAEA,QAAA,IAAI,IAAI,CAAC,qBAAqB,EAAE;AAC5B,YAAA,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC;QAC3C;IACJ;AAEQ,IAAA,eAAe,CAA0B,OAAiB,EAAA;AAC9D,QAAA,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAIC,eAAO,CAAC,OAAO,CAAC,WAA0B,EAAE,OAAO,CAAC,CAAC;IACjF;IAEQ,kBAAkB,CAA0B,OAAiB,EAAE,aAAyB,EAAA;AAC5F,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAG;AAC3B,YAAA,IAAI,KAAK,KAAK,aAAa,EAAE;gBACzB;YACJ;AACA,YAAA,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC;AACrC,QAAA,CAAC,CAAC;IACN;AACH;;;;"}
+{"version":3,"file":"Messenger.js","sources":["../../../messaging/Messenger.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { filter, Subject, Subscription } from 'rxjs';\nimport { IMessenger } from './IMessenger';\nimport { Message } from './Message';\n\n/**\n * Represents an implementation of {@link IMessenger}.\n */\nexport class Messenger extends IMessenger {\n    bubbleToParent = false;\n    trickleDownToChildren = true;\n\n    private readonly _messages = new Subject<Message>();\n    private readonly _children = new Set<Messenger>();\n\n    constructor(private readonly _parent?: Messenger) {\n        super();\n        this._parent?._children.add(this);\n    }\n\n    /**\n     * Dispose this messenger and remove it from its parent.\n     */\n    dispose() {\n        this._parent?._children.delete(this);\n    }\n\n    /** @inheritdoc */\n    publish<TMessage extends object>(message: TMessage): void {\n        this._publishFromSelf(message);\n    }\n\n    /** @inheritdoc */\n    subscribe<TMessage extends object>(type: Constructor<TMessage>, callback: (message: TMessage) => void): Subscription {\n        const observable = this._messages.pipe(filter(m => m.type === type));\n        const subscription = observable.subscribe(m => callback(m.content as TMessage));\n        return subscription;\n    }\n\n    private _publishFromSelf<TMessage extends object>(message: TMessage) {\n        this._publishLocally(message);\n\n        if (this.bubbleToParent && this._parent) {\n            this._parent._publishFromChild(message, this);\n        }\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message);\n        }\n    }\n\n    private _publishFromParent<TMessage extends object>(message: TMessage) {\n        this._publishLocally(message);\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message);\n        }\n    }\n\n    private _publishFromChild<TMessage extends object>(message: TMessage, child: Messenger) {\n        this._publishLocally(message);\n\n        if (this.bubbleToParent && this._parent) {\n            this._parent._publishFromChild(message, this);\n        }\n\n        if (this.trickleDownToChildren) {\n            this._publishToChildren(message, child);\n        }\n    }\n\n    private _publishLocally<TMessage extends object>(message: TMessage) {\n        this._messages.next(new Message(message.constructor as Constructor, message));\n    }\n\n    private _publishToChildren<TMessage extends object>(message: TMessage, excludedChild?: Messenger) {\n        this._children.forEach(child => {\n            if (child === excludedChild) {\n                return;\n            }\n            child._publishFromParent(message);\n        });\n    }\n}\n"],"names":["Messenger","IMessenger","bubbleToParent","trickleDownToChildren","_messages","Subject","_children","Set","_parent","add","dispose","delete","publish","message","_publishFromSelf","subscribe","type","callback","observable","pipe","filter","m","subscription","content","_publishLocally","_publishFromChild","_publishToChildren","_publishFromParent","child","next","Message","excludedChild","forEach"],"mappings":"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"}

package/dist/cjs/messaging/index.js

@@ -4,7 +4,8 @@ var IMessenger = require('./IMessenger.js');
 var Message = require('./Message.js');
 var Messenger = require('./Messenger.js');
 
-
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 exports.IMessenger = IMessenger.IMessenger;
 exports.Message = Message.Message;

package/dist/cjs/messaging/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../messaging/index.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nexport * from './IMessenger';\nexport * from './Message';\nexport * from './Messenger';\n"],"names":[],"mappings":";;;;;;AAAA;AACA;;;;;;"}

package/dist/cjs/queries/HubConnectionKeepAlive.js

@@ -1,32 +1,67 @@
 'use strict';
 
-class HubConnectionKeepAlive {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Manages keep-alive behavior for hub connections (both WebSocket and Server-Sent Events).
+ *
+ * Records connection activity (any message received or sent). An interval fires every
+ * {@link intervalMs} milliseconds; if no activity has been recorded since the last
+ * {@link idleThresholdMs} milliseconds the provided {@link onIdle} callback is invoked —
+ * the caller decides whether to send a ping, trigger a reconnect, or take some other action.
+ *
+ * The idle threshold defaults to the check interval but can be set higher to tolerate
+ * network latency between the server's keep-alive ping and the client's idle check.
+ * For SSE connections, where the idle callback triggers a reconnect, a tolerance of
+ * 1.5× the server's keep-alive interval prevents spurious reconnects caused by the
+ * client's timer firing just before the server's ping arrives.
+ *
+ * Both {@link WebSocketHubConnection} and {@link ServerSentEventHubConnection} own one instance
+ * of this class so the keep-alive logic is written once and behaves identically for both
+ * transports.
+ */ class HubConnectionKeepAlive {
     _intervalMs;
     _onIdle;
     _lastActivityTime = Date.now();
     _timer;
     _idleThresholdMs;
-    constructor(_intervalMs, _onIdle, idleThresholdMs) {
+    /**
+     * Initializes a new instance of {@link HubConnectionKeepAlive}.
+     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.
+     * @param {() => void} onIdle Callback invoked when the interval fires and no activity has
+     *   been recorded within the idle threshold.
+     * @param {number} idleThresholdMs Optional. How long (in milliseconds) without activity
+     *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this
+     *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar
+     *   cadence to account for network latency and timer jitter.
+     */ constructor(_intervalMs, _onIdle, idleThresholdMs){
         this._intervalMs = _intervalMs;
         this._onIdle = _onIdle;
         this._idleThresholdMs = idleThresholdMs ?? _intervalMs;
     }
-    start() {
+    /**
+     * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.
+     */ start() {
         this.stop();
         this._lastActivityTime = Date.now();
-        this._timer = setInterval(() => {
+        this._timer = setInterval(()=>{
             if (Date.now() - this._lastActivityTime >= this._idleThresholdMs) {
                 this._onIdle();
             }
         }, this._intervalMs);
     }
-    stop() {
+    /**
+     * Stop the keep-alive timer.
+     */ stop() {
         if (this._timer !== undefined) {
             clearInterval(this._timer);
             this._timer = undefined;
         }
     }
-    recordActivity() {
+    /**
+     * Record that the connection has been active (message sent or received).
+     * Resets the idle timer so that a keep-alive is not sent while data is already flowing.
+     */ recordActivity() {
         this._lastActivityTime = Date.now();
     }
 }

package/dist/cjs/queries/HubConnectionKeepAlive.js.map

@@ -1 +1 @@
-{"version":3,"file":"HubConnectionKeepAlive.js","sources":["../../../queries/HubConnectionKeepAlive.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Manages keep-alive behavior for hub connections (both WebSocket and Server-Sent Events).\n *\n * Records connection activity (any message received or sent). An interval fires every\n * {@link intervalMs} milliseconds; if no activity has been recorded since the last\n * {@link idleThresholdMs} milliseconds the provided {@link onIdle} callback is invoked —\n * the caller decides whether to send a ping, trigger a reconnect, or take some other action.\n *\n * The idle threshold defaults to the check interval but can be set higher to tolerate\n * network latency between the server's keep-alive ping and the client's idle check.\n * For SSE connections, where the idle callback triggers a reconnect, a tolerance of\n * 1.5× the server's keep-alive interval prevents spurious reconnects caused by the\n * client's timer firing just before the server's ping arrives.\n *\n * Both {@link WebSocketHubConnection} and {@link ServerSentEventHubConnection} own one instance\n * of this class so the keep-alive logic is written once and behaves identically for both\n * transports.\n */\nexport class HubConnectionKeepAlive {\n    private _lastActivityTime = Date.now();\n    private _timer?: ReturnType<typeof setInterval>;\n    private readonly _idleThresholdMs: number;\n\n    /**\n     * Initializes a new instance of {@link HubConnectionKeepAlive}.\n     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.\n     * @param {() => void} onIdle Callback invoked when the interval fires and no activity has\n     *   been recorded within the idle threshold.\n     * @param {number} idleThresholdMs Optional. How long (in milliseconds) without activity\n     *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this\n     *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar\n     *   cadence to account for network latency and timer jitter.\n     */\n    constructor(\n        private readonly _intervalMs: number,\n        private readonly _onIdle: () => void,\n        idleThresholdMs?: number,\n    ) {\n        this._idleThresholdMs = idleThresholdMs ?? _intervalMs;\n    }\n\n    /**\n     * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.\n     */\n    start(): void {\n        this.stop();\n        this._lastActivityTime = Date.now();\n        this._timer = setInterval(() => {\n            if (Date.now() - this._lastActivityTime >= this._idleThresholdMs) {\n                this._onIdle();\n            }\n        }, this._intervalMs);\n    }\n\n    /**\n     * Stop the keep-alive timer.\n     */\n    stop(): void {\n        if (this._timer !== undefined) {\n            clearInterval(this._timer);\n            this._timer = undefined;\n        }\n    }\n\n    /**\n     * Record that the connection has been active (message sent or received).\n     * Resets the idle timer so that a keep-alive is not sent while data is already flowing.\n     */\n    recordActivity(): void {\n        this._lastActivityTime = Date.now();\n    }\n}\n"],"names":[],"mappings":";;MAqBa,sBAAsB,CAAA;AAgBV,IAAA,WAAA;AACA,IAAA,OAAA;AAhBb,IAAA,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE;AAC9B,IAAA,MAAM;AACG,IAAA,gBAAgB;AAYjC,IAAA,WAAA,CACqB,WAAmB,EACnB,OAAmB,EACpC,eAAwB,EAAA;QAFP,IAAA,CAAA,WAAW,GAAX,WAAW;QACX,IAAA,CAAA,OAAO,GAAP,OAAO;AAGxB,QAAA,IAAI,CAAC,gBAAgB,GAAG,eAAe,IAAI,WAAW;IAC1D;IAKA,KAAK,GAAA;QACD,IAAI,CAAC,IAAI,EAAE;AACX,QAAA,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE;AACnC,QAAA,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,MAAK;AAC3B,YAAA,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,gBAAgB,EAAE;gBAC9D,IAAI,CAAC,OAAO,EAAE;YAClB;AACJ,QAAA,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC;IACxB;IAKA,IAAI,GAAA;AACA,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE;AAC3B,YAAA,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;AAC1B,YAAA,IAAI,CAAC,MAAM,GAAG,SAAS;QAC3B;IACJ;IAMA,cAAc,GAAA;AACV,QAAA,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE;IACvC;AACH;;;;"}
+{"version":3,"file":"HubConnectionKeepAlive.js","sources":["../../../queries/HubConnectionKeepAlive.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Manages keep-alive behavior for hub connections (both WebSocket and Server-Sent Events).\n *\n * Records connection activity (any message received or sent). An interval fires every\n * {@link intervalMs} milliseconds; if no activity has been recorded since the last\n * {@link idleThresholdMs} milliseconds the provided {@link onIdle} callback is invoked —\n * the caller decides whether to send a ping, trigger a reconnect, or take some other action.\n *\n * The idle threshold defaults to the check interval but can be set higher to tolerate\n * network latency between the server's keep-alive ping and the client's idle check.\n * For SSE connections, where the idle callback triggers a reconnect, a tolerance of\n * 1.5× the server's keep-alive interval prevents spurious reconnects caused by the\n * client's timer firing just before the server's ping arrives.\n *\n * Both {@link WebSocketHubConnection} and {@link ServerSentEventHubConnection} own one instance\n * of this class so the keep-alive logic is written once and behaves identically for both\n * transports.\n */\nexport class HubConnectionKeepAlive {\n    private _lastActivityTime = Date.now();\n    private _timer?: ReturnType<typeof setInterval>;\n    private readonly _idleThresholdMs: number;\n\n    /**\n     * Initializes a new instance of {@link HubConnectionKeepAlive}.\n     * @param {number} intervalMs How often (in milliseconds) to check for idle connections.\n     * @param {() => void} onIdle Callback invoked when the interval fires and no activity has\n     *   been recorded within the idle threshold.\n     * @param {number} idleThresholdMs Optional. How long (in milliseconds) without activity\n     *   before the connection is considered idle. Defaults to {@link intervalMs}. Set this\n     *   higher than {@link intervalMs} when the peer sends keep-alive messages on a similar\n     *   cadence to account for network latency and timer jitter.\n     */\n    constructor(\n        private readonly _intervalMs: number,\n        private readonly _onIdle: () => void,\n        idleThresholdMs?: number,\n    ) {\n        this._idleThresholdMs = idleThresholdMs ?? _intervalMs;\n    }\n\n    /**\n     * Start the keep-alive timer. Safe to call multiple times — a running timer is stopped first.\n     */\n    start(): void {\n        this.stop();\n        this._lastActivityTime = Date.now();\n        this._timer = setInterval(() => {\n            if (Date.now() - this._lastActivityTime >= this._idleThresholdMs) {\n                this._onIdle();\n            }\n        }, this._intervalMs);\n    }\n\n    /**\n     * Stop the keep-alive timer.\n     */\n    stop(): void {\n        if (this._timer !== undefined) {\n            clearInterval(this._timer);\n            this._timer = undefined;\n        }\n    }\n\n    /**\n     * Record that the connection has been active (message sent or received).\n     * Resets the idle timer so that a keep-alive is not sent while data is already flowing.\n     */\n    recordActivity(): void {\n        this._lastActivityTime = Date.now();\n    }\n}\n"],"names":["HubConnectionKeepAlive","_lastActivityTime","Date","now","_timer","_idleThresholdMs","idleThresholdMs","_intervalMs","_onIdle","start","stop","setInterval","undefined","clearInterval","recordActivity"],"mappings":";;AAAA;AACA;AAEA;;;;;;;;;;;;;;;;;AAiBC,IACM,MAAMA,sBAAAA,CAAAA;;;IACDC,iBAAAA,GAAoBC,IAAAA,CAAKC,GAAG,EAAA;IAC5BC,MAAAA;IACSC,gBAAAA;AAEjB;;;;;;;;;QAUA,WAAA,CACI,WAAoC,EACpC,OAAoC,EACpCC,eAAwB,CAC1B;aAHmBC,WAAAA,GAAAA,WAAAA;aACAC,OAAAA,GAAAA,OAAAA;QAGjB,IAAI,CAACH,gBAAgB,GAAGC,eAAAA,IAAmBC,WAAAA;AAC/C,IAAA;AAEA;;AAEC,QACDE,KAAAA,GAAc;AACV,QAAA,IAAI,CAACC,IAAI,EAAA;AACT,QAAA,IAAI,CAACT,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;QACjC,IAAI,CAACC,MAAM,GAAGO,WAAAA,CAAY,IAAA;YACtB,IAAIT,IAAAA,CAAKC,GAAG,EAAA,GAAK,IAAI,CAACF,iBAAiB,IAAI,IAAI,CAACI,gBAAgB,EAAE;AAC9D,gBAAA,IAAI,CAACG,OAAO,EAAA;AAChB,YAAA;QACJ,CAAA,EAAG,IAAI,CAACD,WAAW,CAAA;AACvB,IAAA;AAEA;;AAEC,QACDG,IAAAA,GAAa;AACT,QAAA,IAAI,IAAI,CAACN,MAAM,KAAKQ,SAAAA,EAAW;YAC3BC,aAAAA,CAAc,IAAI,CAACT,MAAM,CAAA;YACzB,IAAI,CAACA,MAAM,GAAGQ,SAAAA;AAClB,QAAA;AACJ,IAAA;AAEA;;;AAGC,QACDE,cAAAA,GAAuB;AACnB,QAAA,IAAI,CAACb,iBAAiB,GAAGC,IAAAA,CAAKC,GAAG,EAAA;AACrC,IAAA;AACJ;;;;"}

package/dist/cjs/queries/IQueryProvider.js

@@ -1,6 +1,10 @@
 'use strict';
 
-class IQueryProvider {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Defines the provider for queries.
+ */ class IQueryProvider {
 }
 
 exports.IQueryProvider = IQueryProvider;

package/dist/cjs/queries/IQueryProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"IQueryProvider.js","sources":["../../../queries/IQueryProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { IQuery } from './IQuery';\n\n/**\n * Defines the provider for queries.\n */\nexport abstract class IQueryProvider {\n\n    /**\n     * Gets a new instance of a specific query type.\n     * @param {Constructor} queryType Type of query to get an instance of.\n     */\n    abstract get<T extends IQuery>(queryType: Constructor<T>): T;\n}"],"names":[],"mappings":";;MASsB,cAAc,CAAA;AAOnC;;;;"}
+{"version":3,"file":"IQueryProvider.js","sources":["../../../queries/IQueryProvider.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Constructor } from '@cratis/fundamentals';\nimport { IQuery } from './IQuery';\n\n/**\n * Defines the provider for queries.\n */\nexport abstract class IQueryProvider {\n\n    /**\n     * Gets a new instance of a specific query type.\n     * @param {Constructor} queryType Type of query to get an instance of.\n     */\n    abstract get<T extends IQuery>(queryType: Constructor<T>): T;\n}"],"names":["IQueryProvider"],"mappings":";;AAAA;AACA;AAKA;;AAEC,IACM,MAAeA,cAAAA,CAAAA;AAOtB;;;;"}

package/dist/cjs/queries/NullObservableQueryConnection.js

@@ -2,22 +2,28 @@
 
 var QueryResult = require('./QueryResult.js');
 
-class NullObservableQueryConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.
+ */ class NullObservableQueryConnection {
     defaultValue;
-    constructor(defaultValue) {
+    /**
+     * Initializes a new instance of the {@link NullObservableQueryConnection} class.
+     * @param {TDataType} defaultValue The default value to serve.
+     */ constructor(defaultValue){
         this.defaultValue = defaultValue;
     }
-    get lastPingLatency() {
+    /** @inheritdoc */ get lastPingLatency() {
         return 0;
     }
-    get averageLatency() {
+    /** @inheritdoc */ get averageLatency() {
         return 0;
     }
-    connect(dataReceived) {
+    /** @inheritdoc */ connect(dataReceived) {
         dataReceived(QueryResult.QueryResult.empty(this.defaultValue));
     }
-    disconnect() {
-    }
+    /** @inheritdoc */ /* eslint-disable @typescript-eslint/no-empty-function */ disconnect() {}
 }
 
 exports.NullObservableQueryConnection = NullObservableQueryConnection;

package/dist/cjs/queries/NullObservableQueryConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["QueryResult"],"mappings":";;;;MAWa,6BAA6B,CAAA;AAKjB,IAAA,YAAA;AAArB,IAAA,WAAA,CAAqB,YAAuB,EAAA;QAAvB,IAAA,CAAA,YAAY,GAAZ,YAAY;IACjC;AAGA,IAAA,IAAI,eAAe,GAAA;AACf,QAAA,OAAO,CAAC;IACZ;AAGA,IAAA,IAAI,cAAc,GAAA;AACd,QAAA,OAAO,CAAC;IACZ;AAGA,IAAA,OAAO,CAAC,YAAqC,EAAA;QACzC,YAAY,CAACA,uBAAW,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD;IAIA,UAAU,GAAA;IACV;AACH;;;;"}
+{"version":3,"file":"NullObservableQueryConnection.js","sources":["../../../queries/NullObservableQueryConnection.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { DataReceived } from './ObservableQueryConnection';\nimport { IObservableQueryConnection } from './IObservableQueryConnection';\nimport { QueryResult } from './QueryResult';\n\n/**\n * Represents a {@link IObservableQueryConnection} when for instance one can't establish a connection.\n */\n\nexport class NullObservableQueryConnection<TDataType> implements IObservableQueryConnection<TDataType> {\n    /**\n     * Initializes a new instance of the {@link NullObservableQueryConnection} class.\n     * @param {TDataType} defaultValue The default value to serve.\n     */\n    constructor(readonly defaultValue: TDataType) {\n    }\n\n    /** @inheritdoc */\n    get lastPingLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    get averageLatency(): number {\n        return 0;\n    }\n\n    /** @inheritdoc */\n    connect(dataReceived: DataReceived<TDataType>) {\n        dataReceived(QueryResult.empty(this.defaultValue));\n    }\n\n    /** @inheritdoc */\n    /* eslint-disable @typescript-eslint/no-empty-function */\n    disconnect() {\n    }\n}\n"],"names":["NullObservableQueryConnection","defaultValue","lastPingLatency","averageLatency","connect","dataReceived","QueryResult","empty","disconnect"],"mappings":";;;;AAAA;AACA;AAMA;;AAEC,IAEM,MAAMA,6BAAAA,CAAAA;;AACT;;;QAIA,WAAA,CAAY,YAAgC,CAAE;aAAzBC,YAAAA,GAAAA,YAAAA;AACrB,IAAA;uBAGA,IAAIC,eAAAA,GAA0B;QAC1B,OAAO,CAAA;AACX,IAAA;uBAGA,IAAIC,cAAAA,GAAyB;QACzB,OAAO,CAAA;AACX,IAAA;uBAGAC,OAAAA,CAAQC,YAAqC,EAAE;AAC3CA,QAAAA,YAAAA,CAAaC,uBAAAA,CAAYC,KAAK,CAAC,IAAI,CAACN,YAAY,CAAA,CAAA;AACpD,IAAA;AAEA,iFAEAO,UAAAA,GAAa,CACb;AACJ;;;;"}

package/dist/cjs/queries/ObservableQueryConnection.js

@@ -4,7 +4,11 @@ var Globals = require('../Globals.js');
 var ReconnectPolicy = require('./ReconnectPolicy.js');
 var WebSocketMessage = require('./WebSocketMessage.js');
 
-class ObservableQueryConnection {
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the connection for an observable query.
+ */ class ObservableQueryConnection {
     _microservice;
     _reconnectPolicy;
     _socket;
@@ -16,7 +20,13 @@ class ObservableQueryConnection {
     _lastPongLatency = 0;
     _latencySamples = [];
     _connectionStartTime;
-    constructor(url, _microservice, pingIntervalMs = 10000, _reconnectPolicy = new ReconnectPolicy.ReconnectPolicy()) {
+    /**
+     * Initializes a new instance of the {@link ObservableQueryConnection<TDataType>} class.
+     * @param {Url} url The fully qualified Url.
+     * @param {string} _microservice The microservice name.
+     * @param {number} pingIntervalMs The ping interval in milliseconds (default: 10000).
+     * @param {IReconnectPolicy} reconnectPolicy The reconnect policy to use (default: {@link ReconnectPolicy}).
+     */ constructor(url, _microservice, pingIntervalMs = 10000, _reconnectPolicy = new ReconnectPolicy.ReconnectPolicy()){
         this._microservice = _microservice;
         this._reconnectPolicy = _reconnectPolicy;
         this._pingIntervalMs = pingIntervalMs;
@@ -26,62 +36,63 @@ class ObservableQueryConnection {
             const microserviceParam = `${Globals.Globals.microserviceWSQueryArgument}=${this._microservice}`;
             if (this._url.indexOf('?') > 0) {
                 this._url = `${this._url}&${microserviceParam}`;
-            }
-            else {
+            } else {
                 this._url = `${this._url}?${microserviceParam}`;
             }
         }
     }
-    dispose() {
+    /**
+     * Disposes the connection.
+     */ dispose() {
         this.disconnect();
     }
-    get lastPingLatency() {
+    /**
+     * Gets the latency of the last ping/pong sequence in milliseconds.
+     */ get lastPingLatency() {
         return this._lastPongLatency;
     }
-    get averageLatency() {
+    /**
+     * Gets the average latency since the connection started in milliseconds.
+     */ get averageLatency() {
         if (this._latencySamples.length === 0) {
             return 0;
         }
-        const sum = this._latencySamples.reduce((acc, val) => acc + val, 0);
+        const sum = this._latencySamples.reduce((acc, val)=>acc + val, 0);
         return sum / this._latencySamples.length;
     }
-    connect(dataReceived, queryArguments) {
+    /** @inheritdoc */ connect(dataReceived, queryArguments) {
         let url = this._url;
         if (queryArguments) {
             if (url.indexOf('?') < 0) {
                 url = `${url}?`;
-            }
-            else {
+            } else {
                 url = `${url}&`;
             }
-            const query = Object.keys(queryArguments).map(key => `${key}=${queryArguments[key]}`).join('&');
+            const query = Object.keys(queryArguments).map((key)=>`${key}=${queryArguments[key]}`).join('&');
             url = `${url}${query}`;
         }
-        const connectSocket = () => {
+        const connectSocket = ()=>{
             this._socket = new WebSocket(url);
-            this._socket.onopen = () => {
-                if (this._disconnected)
-                    return;
+            this._socket.onopen = ()=>{
+                if (this._disconnected) return;
                 console.log(`Connection for '${url}' established`);
                 this._reconnectPolicy.reset();
                 this._connectionStartTime = Date.now();
                 this.startPinging();
             };
-            this._socket.onclose = () => {
-                if (this._disconnected)
-                    return;
+            this._socket.onclose = ()=>{
+                if (this._disconnected) return;
                 console.log(`Unexpected connection closed for route '${url}'`);
                 this.stopPinging();
                 this._reconnectPolicy.schedule(connectSocket, url);
             };
-            this._socket.onerror = (error) => {
-                if (this._disconnected)
-                    return;
+            this._socket.onerror = (error)=>{
+                if (this._disconnected) return;
                 console.log(`Error with connection for '${url}' - ${error}`);
                 this.stopPinging();
                 this._reconnectPolicy.schedule(connectSocket, url);
             };
-            this._socket.onmessage = (ev) => {
+            this._socket.onmessage = (ev)=>{
                 if (this._disconnected) {
                     console.log('Received message after closing connection');
                     return;
@@ -89,11 +100,10 @@ class ObservableQueryConnection {
                 this.handleMessage(ev.data, dataReceived);
             };
         };
-        if (this._disconnected)
-            return;
+        if (this._disconnected) return;
         connectSocket();
     }
-    disconnect() {
+    /** @inheritdoc */ disconnect() {
         if (this._disconnected) {
             return;
         }
@@ -107,7 +117,7 @@ class ObservableQueryConnection {
     }
     startPinging() {
         this.stopPinging();
-        this._pingInterval = setInterval(() => {
+        this._pingInterval = setInterval(()=>{
             this.sendPing();
         }, this._pingIntervalMs);
     }
@@ -131,15 +141,16 @@ class ObservableQueryConnection {
     handleMessage(rawData, dataReceived) {
         try {
             const message = JSON.parse(rawData);
+            // Handle messages based on type
             if (message.type === WebSocketMessage.WebSocketMessageType.Pong) {
                 this.handlePong(message);
-            }
-            else if (message.type === WebSocketMessage.WebSocketMessageType.Data || !message.type) {
+            } else if (message.type === WebSocketMessage.WebSocketMessageType.Data || !message.type) {
+                // For new-style messages (type === 'Data') the query result is wrapped in message.data.
+                // For legacy/backward-compatible messages (no type) the entire message IS the query result.
                 const data = message.type === WebSocketMessage.WebSocketMessageType.Data ? message.data : message;
                 dataReceived(data);
             }
-        }
-        catch (error) {
+        } catch (error) {
             console.error('Error parsing WebSocket message:', error);
         }
     }
@@ -148,6 +159,7 @@ class ObservableQueryConnection {
             const latency = Date.now() - message.timestamp;
             this._lastPongLatency = latency;
             this._latencySamples.push(latency);
+            // Keep only the last 100 samples for average calculation
             if (this._latencySamples.length > 100) {
                 this._latencySamples.shift();
             }