@privateaim/messenger-kit 0.7.5 → 0.7.7

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.7.7](https://github.com/PrivateAIM/hub/compare/v0.7.6...v0.7.7) (2025-03-04)
+
+
+### Features
+
+* realtime library/service split ([#474](https://github.com/PrivateAIM/hub/issues/474)) ([43c2dfa](https://github.com/PrivateAIM/hub/commit/43c2dfad654cc61ca9784914cbad56c684434088))
+* validate client-to-server messaging message ([a37cbc4](https://github.com/PrivateAIM/hub/commit/a37cbc4582ac66190aa4aad9a78aca58d34526f4))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/core-kit bumped from ^0.8.5 to ^0.8.6
+  * peerDependencies
+    * @privateaim/core-kit bumped from ^0.8.5 to ^0.8.6
+
+## [0.7.6](https://github.com/PrivateAIM/hub/compare/v0.7.5...v0.7.6) (2025-01-22)
+
+
+### Features
+
+* realtime library/service split ([#474](https://github.com/PrivateAIM/hub/issues/474)) ([43c2dfa](https://github.com/PrivateAIM/hub/commit/43c2dfad654cc61ca9784914cbad56c684434088))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/core-kit bumped from ^0.8.4 to ^0.8.5
+  * peerDependencies
+    * @privateaim/core-kit bumped from ^0.8.4 to ^0.8.5
+
 ## [0.7.5](https://github.com/PrivateAIM/hub/compare/v0.7.4...v0.7.5) (2024-10-24)
 
 

package/dist/index.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var zod = require('zod');
+var adapterZod = require('@validup/adapter-zod');
+var validup = require('validup');
+
 /*
  * Copyright (c) 2024.
  * Author Peter Placzek (tada5hi)
@@ -36,6 +40,74 @@ var CTSMessagingEventName = /*#__PURE__*/ function(CTSMessagingEventName) {
     return CTSMessagingEventName;
 }({});
 
+class CTSMessagingPartyValidator extends validup.Container {
+    initialize() {
+        super.initialize();
+        this.mount('id', adapterZod.createValidator(zod.z.string().uuid()));
+        this.mount('type', adapterZod.createValidator(zod.z.enum([
+            'user',
+            'robot',
+            'client'
+        ])));
+    }
+}
+
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+class CTSMessagingMessageValidator extends validup.Container {
+    initialize() {
+        super.initialize();
+        this.mount('data', adapterZod.createValidator(zod.z.object({}).passthrough().or(zod.z.string()).or(zod.z.null()).or(zod.z.undefined()).optional()));
+        this.mount('metadata', adapterZod.createValidator(zod.z.object({}).passthrough().or(zod.z.null()).or(zod.z.undefined()).optional()));
+        const partyValidator = new CTSMessagingPartyValidator();
+        this.mount('to', /*#__PURE__*/ function() {
+            var _ref = _async_to_generator(function*(ctx) {
+                const validator = adapterZod.createValidator(zod.z.array(zod.z.object({}).passthrough()));
+                const output = yield validator(ctx);
+                return Promise.all(output.map((el)=>partyValidator.run(el, {
+                        path: ctx.pathAbsolute,
+                        group: ctx.group
+                    })));
+            });
+            return function(ctx) {
+                return _ref.apply(this, arguments);
+            };
+        }());
+    }
+}
+
 /*
  * Copyright (c) 2021-2024.
  * Author Peter Placzek (tada5hi)
@@ -53,6 +125,8 @@ function isEventTarget(input) {
 
 exports.CTSConnectionEventName = CTSConnectionEventName;
 exports.CTSMessagingEventName = CTSMessagingEventName;
+exports.CTSMessagingMessageValidator = CTSMessagingMessageValidator;
+exports.CTSMessagingPartyValidator = CTSMessagingPartyValidator;
 exports.STCConnectionEventName = STCConnectionEventName;
 exports.STCMessagingEventName = STCMessagingEventName;
 exports.isEventCallback = isEventCallback;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/connection/constants.ts","../src/messaging/constants.ts","../src/utils.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCConnectionEventName {\n    USER_CONNECTED = 'userConnected',\n    USER_DISCONNECTED = 'userDisconnected',\n\n    ROBOT_CONNECTED = 'robotConnected',\n    ROBOT_DISCONNECTED = 'robotDisconnected',\n}\n\nexport enum CTSConnectionEventName {\n    USER_CONNECTIONS = 'userConnections',\n    USER_CONNECTION_SUBSCRIBE = 'userConnectionSubscribe',\n    USER_CONNECTION_UNSUBSCRIBE = 'userConnectionUnsubscribe',\n\n    ROBOT_CONNECTIONS = 'robotConnections',\n    ROBOT_CONNECTION_SUBSCRIBE = 'robotConnectionSubscribe',\n    ROBOT_CONNECTION_UNSUBSCRIBE = 'robotConnectionUnsubscribe',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCMessagingEventName {\n    SEND = 'send',\n}\n\nexport enum CTSMessagingEventName {\n    SEND = 'send',\n}\n","/*\n * Copyright (c) 2021-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { EventCallback } from './types';\n\nexport function isEventCallback(\n    input: unknown,\n    fnArgs?: number,\n) : input is EventCallback {\n    if (typeof fnArgs === 'undefined') {\n        return typeof input === 'function';\n    }\n\n    return typeof input === 'function' &&\n        input.length >= fnArgs;\n}\n\nexport function isEventTarget(\n    input: unknown,\n) : input is EventTarget {\n    return typeof input === 'number' ||\n        typeof input === 'string' ||\n        typeof input === 'undefined';\n}\n"],"names":["STCConnectionEventName","CTSConnectionEventName","STCMessagingEventName","CTSMessagingEventName","isEventCallback","input","fnArgs","length","isEventTarget"],"mappings":";;AAAA;;;;;IAOO,IAAKA,sBAAAA,iBAAAA,SAAAA,sBAAAA,EAAAA;;;;;AAAAA,IAAAA,OAAAA,sBAAAA,CAAAA;AAMX,CAAA,CAAA,EAAA,EAAA;AAEM,IAAA,sBAAKC,iBAAAA,SAAAA,sBAAAA,EAAAA;;;;;;;AAAAA,IAAAA,OAAAA,sBAAAA,CAAAA;AAQX,CAAA,CAAA,EAAA;;ACvBD;;;;;IAOO,IAAKC,qBAAAA,iBAAAA,SAAAA,qBAAAA,EAAAA;;AAAAA,IAAAA,OAAAA,qBAAAA,CAAAA;AAEX,CAAA,CAAA,EAAA,EAAA;AAEM,IAAA,qBAAKC,iBAAAA,SAAAA,qBAAAA,EAAAA;;AAAAA,IAAAA,OAAAA,qBAAAA,CAAAA;AAEX,CAAA,CAAA,EAAA;;ACbD;;;;;AAKC,IAIM,SAASC,eACZC,CAAAA,KAAc,EACdC,MAAe,EAAA;IAEf,IAAI,OAAOA,WAAW,WAAa,EAAA;AAC/B,QAAA,OAAO,OAAOD,KAAU,KAAA,UAAA,CAAA;AAC5B,KAAA;AAEA,IAAA,OAAO,OAAOA,KAAAA,KAAU,UACpBA,IAAAA,KAAAA,CAAME,MAAM,IAAID,MAAAA,CAAAA;AACxB,CAAA;AAEO,SAASE,cACZH,KAAc,EAAA;AAEd,IAAA,OAAO,OAAOA,KAAU,KAAA,QAAA,IACpB,OAAOA,KAAU,KAAA,QAAA,IACjB,OAAOA,KAAU,KAAA,WAAA,CAAA;AACzB;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../src/connection/constants.ts","../src/messaging/constants.ts","../src/messaging/validators/to.ts","../src/messaging/validators/message.ts","../src/utils.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCConnectionEventName {\n    USER_CONNECTED = 'userConnected',\n    USER_DISCONNECTED = 'userDisconnected',\n\n    ROBOT_CONNECTED = 'robotConnected',\n    ROBOT_DISCONNECTED = 'robotDisconnected',\n}\n\nexport enum CTSConnectionEventName {\n    USER_CONNECTIONS = 'userConnections',\n    USER_CONNECTION_SUBSCRIBE = 'userConnectionSubscribe',\n    USER_CONNECTION_UNSUBSCRIBE = 'userConnectionUnsubscribe',\n\n    ROBOT_CONNECTIONS = 'robotConnections',\n    ROBOT_CONNECTION_SUBSCRIBE = 'robotConnectionSubscribe',\n    ROBOT_CONNECTION_UNSUBSCRIBE = 'robotConnectionUnsubscribe',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCMessagingEventName {\n    SEND = 'send',\n}\n\nexport enum CTSMessagingEventName {\n    SEND = 'send',\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { z } from 'zod';\nimport { createValidator } from '@validup/adapter-zod';\nimport { Container } from 'validup';\nimport type { CTSMessagingParty } from '../types';\n\nexport class CTSMessagingPartyValidator extends Container<CTSMessagingParty> {\n    protected initialize() {\n        super.initialize();\n\n        this.mount(\n            'id',\n            createValidator(\n                z.string().uuid(),\n            ),\n        );\n\n        this.mount(\n            'type',\n            createValidator(\n                z.enum(['user', 'robot', 'client']),\n            ),\n        );\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { z } from 'zod';\nimport { createValidator } from '@validup/adapter-zod';\nimport { Container } from 'validup';\nimport type { CTSMessagingMessage } from '../types';\nimport { CTSMessagingPartyValidator } from './to';\n\nexport class CTSMessagingMessageValidator extends Container<CTSMessagingMessage> {\n    protected initialize() {\n        super.initialize();\n\n        this.mount(\n            'data',\n            createValidator(\n                z.object({})\n                    .passthrough()\n                    .or(z.string())\n                    .or(z.null())\n                    .or(z.undefined())\n                    .optional(),\n            ),\n        );\n\n        this.mount(\n            'metadata',\n            createValidator(\n                z.object({}).passthrough()\n                    .or(z.null())\n                    .or(z.undefined())\n                    .optional(),\n            ),\n        );\n\n        const partyValidator = new CTSMessagingPartyValidator();\n\n        this.mount('to', async (ctx) => {\n            const validator = createValidator(\n                z.array(z.object({}).passthrough()),\n            );\n\n            const output = (await validator(ctx)) as unknown[];\n            return Promise.all(output.map((el) => partyValidator.run(el, {\n                path: ctx.pathAbsolute,\n                group: ctx.group,\n            })));\n        });\n    }\n}\n","/*\n * Copyright (c) 2021-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { EventCallback } from './types';\n\nexport function isEventCallback(\n    input: unknown,\n    fnArgs?: number,\n) : input is EventCallback {\n    if (typeof fnArgs === 'undefined') {\n        return typeof input === 'function';\n    }\n\n    return typeof input === 'function' &&\n        input.length >= fnArgs;\n}\n\nexport function isEventTarget(\n    input: unknown,\n) : input is EventTarget {\n    return typeof input === 'number' ||\n        typeof input === 'string' ||\n        typeof input === 'undefined';\n}\n"],"names":["STCConnectionEventName","CTSConnectionEventName","STCMessagingEventName","CTSMessagingEventName","CTSMessagingPartyValidator","Container","initialize","mount","createValidator","z","string","uuid","enum","CTSMessagingMessageValidator","object","passthrough","or","null","undefined","optional","partyValidator","ctx","validator","array","output","Promise","all","map","el","run","path","pathAbsolute","group","isEventCallback","input","fnArgs","length","isEventTarget"],"mappings":"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"}

package/dist/index.mjs

@@ -1,3 +1,7 @@
+import { z } from 'zod';
+import { createValidator } from '@validup/adapter-zod';
+import { Container } from 'validup';
+
 /*
  * Copyright (c) 2024.
  * Author Peter Placzek (tada5hi)
@@ -34,6 +38,74 @@ var CTSMessagingEventName = /*#__PURE__*/ function(CTSMessagingEventName) {
     return CTSMessagingEventName;
 }({});
 
+class CTSMessagingPartyValidator extends Container {
+    initialize() {
+        super.initialize();
+        this.mount('id', createValidator(z.string().uuid()));
+        this.mount('type', createValidator(z.enum([
+            'user',
+            'robot',
+            'client'
+        ])));
+    }
+}
+
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+class CTSMessagingMessageValidator extends Container {
+    initialize() {
+        super.initialize();
+        this.mount('data', createValidator(z.object({}).passthrough().or(z.string()).or(z.null()).or(z.undefined()).optional()));
+        this.mount('metadata', createValidator(z.object({}).passthrough().or(z.null()).or(z.undefined()).optional()));
+        const partyValidator = new CTSMessagingPartyValidator();
+        this.mount('to', /*#__PURE__*/ function() {
+            var _ref = _async_to_generator(function*(ctx) {
+                const validator = createValidator(z.array(z.object({}).passthrough()));
+                const output = yield validator(ctx);
+                return Promise.all(output.map((el)=>partyValidator.run(el, {
+                        path: ctx.pathAbsolute,
+                        group: ctx.group
+                    })));
+            });
+            return function(ctx) {
+                return _ref.apply(this, arguments);
+            };
+        }());
+    }
+}
+
 /*
  * Copyright (c) 2021-2024.
  * Author Peter Placzek (tada5hi)
@@ -49,5 +121,5 @@ function isEventTarget(input) {
     return typeof input === 'number' || typeof input === 'string' || typeof input === 'undefined';
 }
 
-export { CTSConnectionEventName, CTSMessagingEventName, STCConnectionEventName, STCMessagingEventName, isEventCallback, isEventTarget };
+export { CTSConnectionEventName, CTSMessagingEventName, CTSMessagingMessageValidator, CTSMessagingPartyValidator, STCConnectionEventName, STCMessagingEventName, isEventCallback, isEventTarget };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/connection/constants.ts","../src/messaging/constants.ts","../src/utils.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCConnectionEventName {\n    USER_CONNECTED = 'userConnected',\n    USER_DISCONNECTED = 'userDisconnected',\n\n    ROBOT_CONNECTED = 'robotConnected',\n    ROBOT_DISCONNECTED = 'robotDisconnected',\n}\n\nexport enum CTSConnectionEventName {\n    USER_CONNECTIONS = 'userConnections',\n    USER_CONNECTION_SUBSCRIBE = 'userConnectionSubscribe',\n    USER_CONNECTION_UNSUBSCRIBE = 'userConnectionUnsubscribe',\n\n    ROBOT_CONNECTIONS = 'robotConnections',\n    ROBOT_CONNECTION_SUBSCRIBE = 'robotConnectionSubscribe',\n    ROBOT_CONNECTION_UNSUBSCRIBE = 'robotConnectionUnsubscribe',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCMessagingEventName {\n    SEND = 'send',\n}\n\nexport enum CTSMessagingEventName {\n    SEND = 'send',\n}\n","/*\n * Copyright (c) 2021-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { EventCallback } from './types';\n\nexport function isEventCallback(\n    input: unknown,\n    fnArgs?: number,\n) : input is EventCallback {\n    if (typeof fnArgs === 'undefined') {\n        return typeof input === 'function';\n    }\n\n    return typeof input === 'function' &&\n        input.length >= fnArgs;\n}\n\nexport function isEventTarget(\n    input: unknown,\n) : input is EventTarget {\n    return typeof input === 'number' ||\n        typeof input === 'string' ||\n        typeof input === 'undefined';\n}\n"],"names":["STCConnectionEventName","CTSConnectionEventName","STCMessagingEventName","CTSMessagingEventName","isEventCallback","input","fnArgs","length","isEventTarget"],"mappings":"AAAA;;;;;IAOO,IAAKA,sBAAAA,iBAAAA,SAAAA,sBAAAA,EAAAA;;;;;AAAAA,IAAAA,OAAAA,sBAAAA,CAAAA;AAMX,CAAA,CAAA,EAAA,EAAA;AAEM,IAAA,sBAAKC,iBAAAA,SAAAA,sBAAAA,EAAAA;;;;;;;AAAAA,IAAAA,OAAAA,sBAAAA,CAAAA;AAQX,CAAA,CAAA,EAAA;;ACvBD;;;;;IAOO,IAAKC,qBAAAA,iBAAAA,SAAAA,qBAAAA,EAAAA;;AAAAA,IAAAA,OAAAA,qBAAAA,CAAAA;AAEX,CAAA,CAAA,EAAA,EAAA;AAEM,IAAA,qBAAKC,iBAAAA,SAAAA,qBAAAA,EAAAA;;AAAAA,IAAAA,OAAAA,qBAAAA,CAAAA;AAEX,CAAA,CAAA,EAAA;;ACbD;;;;;AAKC,IAIM,SAASC,eACZC,CAAAA,KAAc,EACdC,MAAe,EAAA;IAEf,IAAI,OAAOA,WAAW,WAAa,EAAA;AAC/B,QAAA,OAAO,OAAOD,KAAU,KAAA,UAAA,CAAA;AAC5B,KAAA;AAEA,IAAA,OAAO,OAAOA,KAAAA,KAAU,UACpBA,IAAAA,KAAAA,CAAME,MAAM,IAAID,MAAAA,CAAAA;AACxB,CAAA;AAEO,SAASE,cACZH,KAAc,EAAA;AAEd,IAAA,OAAO,OAAOA,KAAU,KAAA,QAAA,IACpB,OAAOA,KAAU,KAAA,QAAA,IACjB,OAAOA,KAAU,KAAA,WAAA,CAAA;AACzB;;;;"}
+{"version":3,"file":"index.mjs","sources":["../src/connection/constants.ts","../src/messaging/constants.ts","../src/messaging/validators/to.ts","../src/messaging/validators/message.ts","../src/utils.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCConnectionEventName {\n    USER_CONNECTED = 'userConnected',\n    USER_DISCONNECTED = 'userDisconnected',\n\n    ROBOT_CONNECTED = 'robotConnected',\n    ROBOT_DISCONNECTED = 'robotDisconnected',\n}\n\nexport enum CTSConnectionEventName {\n    USER_CONNECTIONS = 'userConnections',\n    USER_CONNECTION_SUBSCRIBE = 'userConnectionSubscribe',\n    USER_CONNECTION_UNSUBSCRIBE = 'userConnectionUnsubscribe',\n\n    ROBOT_CONNECTIONS = 'robotConnections',\n    ROBOT_CONNECTION_SUBSCRIBE = 'robotConnectionSubscribe',\n    ROBOT_CONNECTION_UNSUBSCRIBE = 'robotConnectionUnsubscribe',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum STCMessagingEventName {\n    SEND = 'send',\n}\n\nexport enum CTSMessagingEventName {\n    SEND = 'send',\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { z } from 'zod';\nimport { createValidator } from '@validup/adapter-zod';\nimport { Container } from 'validup';\nimport type { CTSMessagingParty } from '../types';\n\nexport class CTSMessagingPartyValidator extends Container<CTSMessagingParty> {\n    protected initialize() {\n        super.initialize();\n\n        this.mount(\n            'id',\n            createValidator(\n                z.string().uuid(),\n            ),\n        );\n\n        this.mount(\n            'type',\n            createValidator(\n                z.enum(['user', 'robot', 'client']),\n            ),\n        );\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { z } from 'zod';\nimport { createValidator } from '@validup/adapter-zod';\nimport { Container } from 'validup';\nimport type { CTSMessagingMessage } from '../types';\nimport { CTSMessagingPartyValidator } from './to';\n\nexport class CTSMessagingMessageValidator extends Container<CTSMessagingMessage> {\n    protected initialize() {\n        super.initialize();\n\n        this.mount(\n            'data',\n            createValidator(\n                z.object({})\n                    .passthrough()\n                    .or(z.string())\n                    .or(z.null())\n                    .or(z.undefined())\n                    .optional(),\n            ),\n        );\n\n        this.mount(\n            'metadata',\n            createValidator(\n                z.object({}).passthrough()\n                    .or(z.null())\n                    .or(z.undefined())\n                    .optional(),\n            ),\n        );\n\n        const partyValidator = new CTSMessagingPartyValidator();\n\n        this.mount('to', async (ctx) => {\n            const validator = createValidator(\n                z.array(z.object({}).passthrough()),\n            );\n\n            const output = (await validator(ctx)) as unknown[];\n            return Promise.all(output.map((el) => partyValidator.run(el, {\n                path: ctx.pathAbsolute,\n                group: ctx.group,\n            })));\n        });\n    }\n}\n","/*\n * Copyright (c) 2021-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { EventCallback } from './types';\n\nexport function isEventCallback(\n    input: unknown,\n    fnArgs?: number,\n) : input is EventCallback {\n    if (typeof fnArgs === 'undefined') {\n        return typeof input === 'function';\n    }\n\n    return typeof input === 'function' &&\n        input.length >= fnArgs;\n}\n\nexport function isEventTarget(\n    input: unknown,\n) : input is EventTarget {\n    return typeof input === 'number' ||\n        typeof input === 'string' ||\n        typeof input === 'undefined';\n}\n"],"names":["STCConnectionEventName","CTSConnectionEventName","STCMessagingEventName","CTSMessagingEventName","CTSMessagingPartyValidator","Container","initialize","mount","createValidator","z","string","uuid","enum","CTSMessagingMessageValidator","object","passthrough","or","null","undefined","optional","partyValidator","ctx","validator","array","output","Promise","all","map","el","run","path","pathAbsolute","group","isEventCallback","input","fnArgs","length","isEventTarget"],"mappings":"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"}

package/dist/messaging/index.d.ts

@@ -1,3 +1,4 @@
 export * from './constants';
 export * from './types';
+export * from './validators';
 //# sourceMappingURL=index.d.ts.map

package/dist/messaging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAOA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/messaging/types.d.ts

@@ -1,23 +1,23 @@
 import type { EventCallback } from '../types';
 import type { CTSMessagingEventName, STCMessagingEventName } from './constants';
-export type MessagingParty = {
+export type CTSMessagingParty = {
     type: 'user' | 'robot';
     id: string;
 };
-export type Message = {
-    to: MessagingParty[];
-    data: Record<string, any>;
-    metadata: Record<string, any>;
+export type CTSMessagingMessage = {
+    to: CTSMessagingParty[];
+    data?: Record<string, any> | string | null;
+    metadata?: Record<string, any> | null;
 };
 export type STCMessagingMessage = {
-    from: MessagingParty;
-    data: Record<string, any>;
-    metadata: Record<string, any>;
+    from: CTSMessagingParty;
+    data?: Record<string, any> | string | null;
+    metadata?: Record<string, any> | null;
 };
 export type STCMessagingEvents = {
     [STCMessagingEventName.SEND]: (data: STCMessagingMessage) => void;
 };
 export type CTSMessagingEvents = {
-    [CTSMessagingEventName.SEND]: (data: Message, cb?: EventCallback) => void;
+    [CTSMessagingEventName.SEND]: (data: CTSMessagingMessage, cb?: EventCallback) => void;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/messaging/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messaging/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAA;CACb,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAClB,EAAE,EAAE,cAAc,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACpE,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7E,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messaging/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAA;CACb,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,EAAE,EAAE,iBAAiB,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;CACxC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;CACxC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACpE,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CACzF,CAAC"}

package/dist/messaging/validators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './message';
+export * from './to';
+//# sourceMappingURL=index.d.ts.map

package/dist/messaging/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/messaging/validators/index.ts"],"names":[],"mappings":"AAOA,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC"}

package/dist/messaging/validators/message.d.ts

@@ -0,0 +1,6 @@
+import { Container } from 'validup';
+import type { CTSMessagingMessage } from '../types';
+export declare class CTSMessagingMessageValidator extends Container<CTSMessagingMessage> {
+    protected initialize(): void;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/messaging/validators/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/messaging/validators/message.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,qBAAa,4BAA6B,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IAC5E,SAAS,CAAC,UAAU;CAuCvB"}

package/dist/messaging/validators/to.d.ts

@@ -0,0 +1,6 @@
+import { Container } from 'validup';
+import type { CTSMessagingParty } from '../types';
+export declare class CTSMessagingPartyValidator extends Container<CTSMessagingParty> {
+    protected initialize(): void;
+}
+//# sourceMappingURL=to.d.ts.map

package/dist/messaging/validators/to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to.d.ts","sourceRoot":"","sources":["../../../src/messaging/validators/to.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,qBAAa,0BAA2B,SAAQ,SAAS,CAAC,iBAAiB,CAAC;IACxE,SAAS,CAAC,UAAU;CAiBvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@privateaim/messenger-kit",
-    "version": "0.7.5",
+    "version": "0.7.7",
     "license": "Apache-2.0",
     "description": "",
     "exports": {
@@ -23,13 +23,20 @@
         "build:types": "tsc --emitDeclarationOnly -p tsconfig.build.json",
         "build:js": "rollup -c",
         "build": "rimraf ./dist && cross-env NODE_ENV=production npm run build:js && npm run build:types",
-        "build-watch": "rimraf ./dist && tsc -p tsconfig.build.json --watch"
+        "build-watch": "rimraf ./dist && tsc -p tsconfig.build.json --watch",
+        "test": "cross-env NODE_ENV=test jest --config ./test/jest.config.js",
+        "test:coverage": "npm run test -- --coverage"
+    },
+    "dependencies": {
+        "@validup/adapter-zod": "^0.1.8",
+        "validup": "^0.1.8",
+        "zod": "^3.24.1"
     },
     "devDependencies": {
-        "@privateaim/core-kit": "^0.8.4"
+        "@privateaim/core-kit": "^0.8.6"
     },
     "peerDependencies": {
-        "@privateaim/core-kit": "^0.8.4"
+        "@privateaim/core-kit": "^0.8.6"
     },
     "publishConfig": {
         "access": "public"

package/src/messaging/index.ts

@@ -7,3 +7,4 @@
 
 export * from './constants';
 export * from './types';
+export * from './validators';

package/src/messaging/types.ts

@@ -1,21 +1,21 @@
 import type { EventCallback } from '../types';
 import type { CTSMessagingEventName, STCMessagingEventName } from './constants';
 
-export type MessagingParty = {
+export type CTSMessagingParty = {
     type: 'user' | 'robot',
     id: string
 };
 
-export type Message = {
-    to: MessagingParty[],
-    data: Record<string, any>,
-    metadata: Record<string, any>
+export type CTSMessagingMessage = {
+    to: CTSMessagingParty[],
+    data?: Record<string, any> | string | null,
+    metadata?: Record<string, any> | null
 };
 
 export type STCMessagingMessage = {
-    from: MessagingParty,
-    data: Record<string, any>,
-    metadata: Record<string, any>
+    from: CTSMessagingParty,
+    data?: Record<string, any> | string | null,
+    metadata?: Record<string, any> | null
 };
 
 export type STCMessagingEvents = {
@@ -23,5 +23,5 @@ export type STCMessagingEvents = {
 };
 
 export type CTSMessagingEvents = {
-    [CTSMessagingEventName.SEND]: (data: Message, cb?: EventCallback) => void;
+    [CTSMessagingEventName.SEND]: (data: CTSMessagingMessage, cb?: EventCallback) => void;
 };

package/src/messaging/validators/index.ts

@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export * from './message';
+export * from './to';

package/src/messaging/validators/message.ts

@@ -0,0 +1,54 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { z } from 'zod';
+import { createValidator } from '@validup/adapter-zod';
+import { Container } from 'validup';
+import type { CTSMessagingMessage } from '../types';
+import { CTSMessagingPartyValidator } from './to';
+
+export class CTSMessagingMessageValidator extends Container<CTSMessagingMessage> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'data',
+            createValidator(
+                z.object({})
+                    .passthrough()
+                    .or(z.string())
+                    .or(z.null())
+                    .or(z.undefined())
+                    .optional(),
+            ),
+        );
+
+        this.mount(
+            'metadata',
+            createValidator(
+                z.object({}).passthrough()
+                    .or(z.null())
+                    .or(z.undefined())
+                    .optional(),
+            ),
+        );
+
+        const partyValidator = new CTSMessagingPartyValidator();
+
+        this.mount('to', async (ctx) => {
+            const validator = createValidator(
+                z.array(z.object({}).passthrough()),
+            );
+
+            const output = (await validator(ctx)) as unknown[];
+            return Promise.all(output.map((el) => partyValidator.run(el, {
+                path: ctx.pathAbsolute,
+                group: ctx.group,
+            })));
+        });
+    }
+}

package/src/messaging/validators/to.ts

@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { z } from 'zod';
+import { createValidator } from '@validup/adapter-zod';
+import { Container } from 'validup';
+import type { CTSMessagingParty } from '../types';
+
+export class CTSMessagingPartyValidator extends Container<CTSMessagingParty> {
+    protected initialize() {
+        super.initialize();
+
+        this.mount(
+            'id',
+            createValidator(
+                z.string().uuid(),
+            ),
+        );
+
+        this.mount(
+            'type',
+            createValidator(
+                z.enum(['user', 'robot', 'client']),
+            ),
+        );
+    }
+}

package/test/jest.config.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+module.exports = {
+    testEnvironment: 'node',
+    transform: {
+        '^.+\\.tsx?$': 'ts-jest',
+    },
+    moduleFileExtensions: [
+        'ts',
+        'tsx',
+        'js',
+        'jsx',
+        'json',
+        'node',
+    ],
+    testRegex: '(/unit/.*|(\\.|/)(test|spec))\\.(ts|js)x?$',
+    testPathIgnorePatterns: [
+        'writable',
+        'dist',
+        '/unit/mock-util.ts',
+    ],
+    coverageDirectory: 'writable/coverage',
+    collectCoverageFrom: [
+        'src/**/*.{ts,tsx,js,jsx}',
+    ],
+    rootDir: '../',
+    verbose: true,
+};

package/test/unit/messaging.spec.ts

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import { buildErrorMessageForAttribute } from 'validup';
+import type { CTSMessagingMessage } from '../../src';
+import { CTSMessagingMessageValidator } from '../../src';
+
+describe('messaging > validator', () => {
+    it('should validate message', async () => {
+        const validator = new CTSMessagingMessageValidator();
+
+        const message : CTSMessagingMessage = {
+            data: {},
+            to: [
+                { type: 'user', id: '92b27b20-4c24-4897-ac68-daba7f306a08' },
+            ],
+        };
+
+        const output = await validator.run(message);
+        expect(output).toBeDefined();
+    });
+
+    it('should validate message with string data', async () => {
+        const validator = new CTSMessagingMessageValidator();
+
+        const message : CTSMessagingMessage = {
+            data: 'xxx',
+            to: [
+                { type: 'user', id: '92b27b20-4c24-4897-ac68-daba7f306a08' },
+            ],
+        };
+
+        const output = await validator.run(message);
+        expect(output).toBeDefined();
+    });
+
+    it('should not validate message due invalid recipient format (type)', async () => {
+        const validator = new CTSMessagingMessageValidator();
+
+        const message : CTSMessagingMessage = {
+            data: 'xxx',
+            to: [
+                { type: 'boxer' as 'user', id: '92b27b20-4c24-4897-ac68-daba7f306a08' },
+            ],
+        };
+
+        await expect(validator.run(message)).rejects.toThrow(buildErrorMessageForAttribute('to'));
+    });
+
+    it('should not validate message due invalid recipient format (id)', async () => {
+        const validator = new CTSMessagingMessageValidator();
+
+        const message : CTSMessagingMessage = {
+            data: 'xxx',
+            to: [
+                { type: 'user', id: '1' },
+            ],
+        };
+
+        await expect(validator.run(message)).rejects.toThrow(buildErrorMessageForAttribute('to'));
+    });
+});