@futdevpro/nts-dynamo 1.5.36 → 1.5.38

package/lib/_constants/dynamo-nts-global-settings.d.ts

@@ -0,0 +1,3 @@
+import { DynamoNTS_GlobalSettings } from '../_models/dynamo-nts-global-settings';
+export declare const dynamoNTS_GlobalSettings: DynamoNTS_GlobalSettings;
+//# sourceMappingURL=dynamo-nts-global-settings.d.ts.map

package/lib/_constants/dynamo-nts-global-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-global-settings.d.ts","sourceRoot":"","sources":["../../src/_constants/dynamo-nts-global-settings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,eAAO,MAAM,wBAAwB,EAAE,wBActC,CAAC"}

package/lib/_constants/dynamo-nts-global-settings.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dynamoNTS_GlobalSettings = void 0;
+const dynamo_nts_route_security_enum_1 = require("../_enums/dynamo-nts-route-security.enum");
+const dynamo_nts_socket_security_enum_1 = require("../_enums/dynamo-nts-socket-security.enum");
+exports.dynamoNTS_GlobalSettings = {
+    baseUrl: '/api',
+    defaultRouteSecurity: dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open,
+    defaultSocketSecurity: dynamo_nts_socket_security_enum_1.DynamoNTS_SocketSecurity.open,
+    logSetup: false,
+    logRequest: true,
+    logRequestsContent: true,
+    logResponseContent: false,
+    logMainSocketEvent: true,
+    logAllSocketEvent: false,
+    logEventContent: false,
+};
+//# sourceMappingURL=dynamo-nts-global-settings.js.map

package/lib/_constants/dynamo-nts-global-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-global-settings.js","sourceRoot":"","sources":["../../src/_constants/dynamo-nts-global-settings.ts"],"names":[],"mappings":";;;AACA,6FAAmF;AACnF,+FAAqF;AAGxE,QAAA,wBAAwB,GAA6B;IAChE,OAAO,EAAE,MAAM;IACf,oBAAoB,EAAE,wDAAuB,CAAC,IAAI;IAClD,qBAAqB,EAAE,0DAAwB,CAAC,IAAI;IAEpD,QAAQ,EAAE,KAAK;IAEf,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,KAAK;IAEzB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,KAAK;CACvB,CAAC"}

package/lib/_constants/index.d.ts

@@ -1,2 +1,2 @@
-export * from './dynamo-nts-global.settings';
+export * from './dynamo-nts-global-settings';
 //# sourceMappingURL=index.d.ts.map

package/lib/_constants/index.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./dynamo-nts-global.settings"), exports);
+tslib_1.__exportStar(require("./dynamo-nts-global-settings"), exports);
 //# sourceMappingURL=index.js.map

package/lib/_models/dynamo-nts-socket-service-params.d.ts

@@ -0,0 +1,19 @@
+import { DynamoNTS_SocketSecurity } from '../_enums/dynamo-nts-socket-security.enum';
+/**
+ *
+ */
+export declare class DynamoNTS_SocketServiceParams {
+    name: string;
+    port: number;
+    security?: DynamoNTS_SocketSecurity;
+    groupActiveSocketsBy?: string;
+    getIdFromSubscrioption?: (content: any) => string;
+    constructor(set: {
+        name: string;
+        port: number;
+        security?: DynamoNTS_SocketSecurity;
+        groupActiveSocketsBy?: string;
+        getIdFromSubscrioption?: (content: any) => string;
+    });
+}
+//# sourceMappingURL=dynamo-nts-socket-service-params.d.ts.map

package/lib/_models/dynamo-nts-socket-service-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-socket-service-params.d.ts","sourceRoot":"","sources":["../../src/_models/dynamo-nts-socket-service-params.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF;;GAEG;AACH,qBAAa,6BAA6B;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;gBAGhD,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,wBAAwB,CAAC;QACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;KACnD;CAiBJ"}

package/lib/_models/dynamo-nts-socket-service-params.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoNTS_SocketServiceParams = void 0;
+const _constants_1 = require("../_constants");
+const _services_1 = require("../_services");
+/**
+ *
+ */
+class DynamoNTS_SocketServiceParams {
+    constructor(set) {
+        this.name = set.name;
+        this.port = set.port;
+        this.security = set.security ? set.security : _constants_1.dynamoNTS_GlobalSettings.defaultSocketSecurity;
+        if (set.getIdFromSubscrioption) {
+            this.getIdFromSubscrioption = set.getIdFromSubscrioption;
+            if (set.groupActiveSocketsBy) {
+                _services_1.DynamoNTS_Shared.logError(`setting groupActiveSocketsBy on DynamoNTS_SocketService (${this.name}) won't take effect, ` +
+                    `since getIdFromSubscrioption is also setted, so it will be used instead`);
+            }
+        }
+        else if (set.groupActiveSocketsBy) {
+            this.getIdFromSubscrioption = content => content[set.groupActiveSocketsBy];
+        }
+    }
+}
+exports.DynamoNTS_SocketServiceParams = DynamoNTS_SocketServiceParams;
+//# sourceMappingURL=dynamo-nts-socket-service-params.js.map

package/lib/_models/dynamo-nts-socket-service-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-socket-service-params.js","sourceRoot":"","sources":["../../src/_models/dynamo-nts-socket-service-params.ts"],"names":[],"mappings":";;;AACA,8CAAyD;AAEzD,4CAAgD;AAEhD;;GAEG;AACH,MAAa,6BAA6B;IAQxC,YACE,GAOC;QAED,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,qCAAwB,CAAC,qBAAqB,CAAC;QAE7F,IAAI,GAAG,CAAC,sBAAsB,EAAE;YAC9B,IAAI,CAAC,sBAAsB,GAAG,GAAG,CAAC,sBAAsB,CAAC;YACzD,IAAI,GAAG,CAAC,oBAAoB,EAAE;gBAC5B,4BAAgB,CAAC,QAAQ,CACvB,4DAA4D,IAAI,CAAC,IAAI,uBAAuB;oBAC5F,yEAAyE,CAAC,CAAA;aAC7E;SACF;aAAM,IAAI,GAAG,CAAC,oBAAoB,EAAE;YACnC,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;SAC5E;IACH,CAAC;CACF;AAjCD,sEAiCC"}

package/lib/_models/index.d.ts

@@ -4,5 +4,5 @@ export * from './dynamo-nts-endpoint-params';
 export * from './dynamo-nts-global-settings';
 export * from './dynamo-nts-routing-module-settings';
 export * from './dynamo-nts-socket-event-params';
-export * from './dynamo-nts-socket-module-settings';
+export * from './dynamo-nts-socket-service-params';
 //# sourceMappingURL=index.d.ts.map

package/lib/_models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/_models/index.ts"],"names":[],"mappings":"AAGA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/_models/index.ts"],"names":[],"mappings":"AAGA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}

package/lib/_models/index.js

@@ -8,5 +8,5 @@ tslib_1.__exportStar(require("./dynamo-nts-endpoint-params"), exports);
 tslib_1.__exportStar(require("./dynamo-nts-global-settings"), exports);
 tslib_1.__exportStar(require("./dynamo-nts-routing-module-settings"), exports);
 tslib_1.__exportStar(require("./dynamo-nts-socket-event-params"), exports);
-tslib_1.__exportStar(require("./dynamo-nts-socket-module-settings"), exports);
+tslib_1.__exportStar(require("./dynamo-nts-socket-service-params"), exports);
 //# sourceMappingURL=index.js.map

package/lib/_models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/_models/index.ts"],"names":[],"mappings":";;;AAEA,SAAS;AACT,uEAA6C;AAC7C,kEAAwC;AACxC,uEAA6C;AAC7C,uEAA6C;AAC7C,+EAAqD;AACrD,2EAAiD;AACjD,8EAAoD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/_models/index.ts"],"names":[],"mappings":";;;AAEA,SAAS;AACT,uEAA6C;AAC7C,kEAAwC;AACxC,uEAA6C;AAC7C,uEAA6C;AAC7C,+EAAqD;AACrD,2EAAiD;AACjD,6EAAmD"}

package/lib/_modules/app-extended.index.d.ts

@@ -8,5 +8,5 @@ export * from '../_models/dynamo-nts-endpoint-params';
 export * from '../_models/dynamo-nts-global-settings';
 export * from '../_models/dynamo-nts-routing-module-settings';
 export * from '../_enums/dynamo-nts-route-security.enum';
-export * from '../_constants/dynamo-nts-global.settings';
+export * from '../_constants/dynamo-nts-global-settings';
 //# sourceMappingURL=app-extended.index.d.ts.map

package/lib/_modules/app-extended.index.js

@@ -15,5 +15,5 @@ tslib_1.__exportStar(require("../_models/dynamo-nts-routing-module-settings"), e
 // ENUMS
 tslib_1.__exportStar(require("../_enums/dynamo-nts-route-security.enum"), exports);
 // CONSTANTS
-tslib_1.__exportStar(require("../_constants/dynamo-nts-global.settings"), exports);
+tslib_1.__exportStar(require("../_constants/dynamo-nts-global-settings"), exports);
 //# sourceMappingURL=app-extended.index.js.map

package/lib/_modules/app.index.d.ts

@@ -7,5 +7,5 @@ export * from '../_models/dynamo-nts-endpoint-params';
 export * from '../_models/dynamo-nts-global-settings';
 export * from '../_models/dynamo-nts-routing-module-settings';
 export * from '../_enums/dynamo-nts-route-security.enum';
-export * from '../_constants/dynamo-nts-global.settings';
+export * from '../_constants/dynamo-nts-global-settings';
 //# sourceMappingURL=app.index.d.ts.map

package/lib/_modules/app.index.js

@@ -14,5 +14,5 @@ tslib_1.__exportStar(require("../_models/dynamo-nts-routing-module-settings"), e
 // ENUMS
 tslib_1.__exportStar(require("../_enums/dynamo-nts-route-security.enum"), exports);
 // CONSTANTS
-tslib_1.__exportStar(require("../_constants/dynamo-nts-global.settings"), exports);
+tslib_1.__exportStar(require("../_constants/dynamo-nts-global-settings"), exports);
 //# sourceMappingURL=app.index.js.map

package/lib/_services/dynamo-nts-db.service.d.ts

@@ -63,11 +63,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * @param data
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is greater than OR less than:
-     * { points: { $gte: 2, $lte: 14 } }
+     * @example { points: { $gte: 2, $lte: 14 } }
      * @returns data
      */
     /**
@@ -90,11 +90,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * @param filter
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -109,11 +109,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * find all data by any of its parameters, throws error if not found
      * @param filter
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -128,11 +128,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * find all data by any of its parameters, throws error if not found
      * @param filter
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -158,11 +158,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * @param updateBy
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -172,11 +172,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      *
      * @param update
      * etc.: increase a specific value:
-     * { $inc: { popularity: 15 } }
+     * @example { $inc: { popularity: 15 } }
      * or add element to a list:
-     * { $push: { reactions: this.newReaction }
+     * @example { $push: { reactions: this.newReaction }
      * or all at once
-     * { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
+     * @example { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
      * further tools (syntax matches with $inc):
      * $currentDate: Sets the value of a field to current date, either as a Date or a Timestamp.
      * $min: Only updates the field if the specified value is less than the existing field value.
@@ -190,11 +190,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      * update one parameter by a specific
      * @param updateBy
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -204,11 +204,11 @@ export declare class DynamoNTS_DBService<T extends Metadata> {
      *
      * @param update
      * etc.: increase a specific value:
-     * { $inc: { popularity: 15 } }
+     * @example { $inc: { popularity: 15 } }
      * or add element to a list:
-     * { $push: { reactions: this.newReaction }
+     * @example { $push: { reactions: this.newReaction }
      * or all at once
-     * { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
+     * @example { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
      * further tools (syntax matches with $inc):
      * $currentDate: Sets the value of a field to current date, either as a Date or a Timestamp.
      * $min: Only updates the field if the specified value is less than the existing field value.

package/lib/_services/dynamo-nts-db.service.js

@@ -311,11 +311,11 @@ class DynamoNTS_DBService {
      * @param data
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is greater than OR less than:
-     * { points: { $gte: 2, $lte: 14 } }
+     * @example { points: { $gte: 2, $lte: 14 } }
      * @returns data
      */
     /* async findData(data: T): Promise<T> {
@@ -407,11 +407,11 @@ class DynamoNTS_DBService {
      * @param filter
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -448,11 +448,11 @@ class DynamoNTS_DBService {
      * find all data by any of its parameters, throws error if not found
      * @param filter
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -488,11 +488,11 @@ class DynamoNTS_DBService {
      * find all data by any of its parameters, throws error if not found
      * @param filter
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -569,11 +569,11 @@ class DynamoNTS_DBService {
      * @param updateBy
      * (always use unique parameters for find!)
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -583,11 +583,11 @@ class DynamoNTS_DBService {
      *
      * @param update
      * etc.: increase a specific value:
-     * { $inc: { popularity: 15 } }
+     * @example { $inc: { popularity: 15 } }
      * or add element to a list:
-     * { $push: { reactions: this.newReaction }
+     * @example { $push: { reactions: this.newReaction }
      * or all at once
-     * { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
+     * @example { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
      * further tools (syntax matches with $inc):
      * $currentDate: Sets the value of a field to current date, either as a Date or a Timestamp.
      * $min: Only updates the field if the specified value is less than the existing field value.
@@ -613,11 +613,11 @@ class DynamoNTS_DBService {
      * update one parameter by a specific
      * @param updateBy
      * etc.: by email:
-     * { email: email }
+     * @example { email: email }
      * or by id that is in list:
-     * { userIds: { $in: this.userId } }
+     * @example { userIds: { $in: this.userId } }
      * or by number or Date that is GREATER THAN OR LESS THAN:
-     * { points: { $gt: 2, $lt: 14 } }
+     * @example { points: { $gt: 2, $lt: 14 } }
      * further tools (syntax matches with $gt):
      * $eq: Matches values that are EQUAL to a specified value.
      * $gte: Matches values that are GREATER THAN or EQUAL to a specified value.
@@ -627,11 +627,11 @@ class DynamoNTS_DBService {
      *
      * @param update
      * etc.: increase a specific value:
-     * { $inc: { popularity: 15 } }
+     * @example { $inc: { popularity: 15 } }
      * or add element to a list:
-     * { $push: { reactions: this.newReaction }
+     * @example { $push: { reactions: this.newReaction }
      * or all at once
-     * { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
+     * @example { $inc: { popularity: this.newVote.amount }, emailVerified: true, $push: { reactions: this.newReaction } }
      * further tools (syntax matches with $inc):
      * $currentDate: Sets the value of a field to current date, either as a Date or a Timestamp.
      * $min: Only updates the field if the specified value is less than the existing field value.

package/lib/_services/dynamo-nts-routing-module.service.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamoNTS_RoutingModule = void 0;
 const express_1 = require("express");
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const dynamo_nts_global_settings_1 = require("../_constants/dynamo-nts-global.settings");
+const dynamo_nts_global_settings_1 = require("../_constants/dynamo-nts-global-settings");
 const dynamo_nts_route_security_enum_1 = require("../_enums/dynamo-nts-route-security.enum");
 const http_call_type_enum_1 = require("../_enums/http/http-call-type.enum");
 const dynamo_nts_shared_service_1 = require("./dynamo-nts-shared.service");

package/lib/_services/dynamo-nts-socket.service.d.ts

@@ -1,5 +1,5 @@
 import * as SocketIO from 'socket.io';
-import { DynamoNTS_SocketServiceSettings } from '../_models';
+import { DynamoNTS_SocketServiceParams } from '../_models';
 import { DynamoNTS_SingletonService } from './dynamo-nts-singleton.service';
 import { DynamoNTS_SocketEventParams } from '../_models/dynamo-nts-socket-event-params';
 import { DynamoNTS_SocketSecurity } from '../_enums';
@@ -11,13 +11,13 @@ export interface DynamoNTS_SocketDictionary {
  *
  */
 export declare abstract class DynamoNTS_SocketService extends DynamoNTS_SingletonService {
-    protected params: DynamoNTS_SocketServiceSettings;
+    protected params: DynamoNTS_SocketServiceParams;
     get name(): string;
-    get security(): DynamoNTS_SocketSecurity;
     get port(): number;
+    get security(): DynamoNTS_SocketSecurity;
     protected socketServer: SocketIO.Server;
     private connectEvent;
-    protected events: DynamoNTS_SocketEventParams<any>[];
+    protected incomingEvents: DynamoNTS_SocketEventParams<any>[];
     private subscriptionEvent;
     private getIdFromSubscrioption?;
     private activeSockets;
@@ -28,11 +28,13 @@ export declare abstract class DynamoNTS_SocketService extends DynamoNTS_Singleto
      * You must setup events and required services for this function
      */
     private prepareEvents;
-    setupSocketServer(newSocketServer: SocketIO.Server): void;
+    setupSocketServer(newSocketServer: SocketIO.Server): Promise<void>;
     private socketSubscription;
     private removeSubscriptionOnDisconnect;
     emitEvent(event: string, content: any): void;
-    emitEventForId(id: string, event: string, content: any): void;
+    idIsSubscribed(id: string): boolean;
+    sendEventForId(id: string, event: string, content: any, error?: (err: any) => void): Promise<void>;
+    broadcastEvent(event: string, content: any): void;
     /**
      * You must setup params for the service in this function
      *

package/lib/_services/dynamo-nts-socket.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamo-nts-socket.service.d.ts","sourceRoot":"","sources":["../../src/_services/dynamo-nts-socket.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAItC,OAAO,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAIxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,8BAAsB,uBAAwB,SAAQ,0BAA0B;IAC9E,SAAS,CAAC,MAAM,EAAE,+BAA+B,CAAC;IAClD,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,QAAQ,IAAI,wBAAwB,CAEvC;IACD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC;IAExC,OAAO,CAAC,YAAY,CAA+C;IACnE,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC;IAErD,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,sBAAsB,CAAC,CAA4B;IAC3D,OAAO,CAAC,aAAa,CAAoC;IAEzD,SAAS,CAAC,GAAG,EAAE,OAAO,CAAqC;;IAkB3D,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI;YAkC3C,kBAAkB;YASlB,8BAA8B;IAW5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAI5C,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAW7D;;;OAGG;IACF,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IAEpC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,IAAI;CAC7B"}
+{"version":3,"file":"dynamo-nts-socket.service.d.ts","sourceRoot":"","sources":["../../src/_services/dynamo-nts-socket.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAItC,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAIxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,8BAAsB,uBAAwB,SAAQ,0BAA0B;IAC9E,SAAS,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAChD,IAAI,IAAI,IAAI,MAAM,CAA6B;IAC/C,IAAI,IAAI,IAAI,MAAM,CAA6B;IAC/C,IAAI,QAAQ,IAAI,wBAAwB,CAAiC;IAEzE,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC;IAExC,OAAO,CAAC,YAAY,CAA+C;IACnE,SAAS,CAAC,cAAc,EAAE,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,sBAAsB,CAAC,CAAqC;IACpE,OAAO,CAAC,aAAa,CAAoC;IAEzD,SAAS,CAAC,GAAG,EAAE,OAAO,CAAqC;;IAkB3D,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCf,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAmC1D,kBAAkB;YASlB,8BAA8B;IAW5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAI5C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAQjD;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IAEnC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,IAAI;CAC7B"}

package/lib/_services/dynamo-nts-socket.service.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamoNTS_SocketService = void 0;
 const tslib_1 = require("tslib");
-const dynamo_nts_global_settings_1 = require("../_constants/dynamo-nts-global.settings");
+const dynamo_nts_global_settings_1 = require("../_constants/dynamo-nts-global-settings");
 const dynamo_nts_shared_service_1 = require("./dynamo-nts-shared.service");
 const dynamo_nts_singleton_service_1 = require("./dynamo-nts-singleton.service");
 const dynamo_nts_socket_event_params_1 = require("../_models/dynamo-nts-socket-event-params");
@@ -29,15 +29,9 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
             dynamo_nts_shared_service_1.DynamoNTS_Shared.logError(`Socket Controller setup failed: ${this.params.name} (${this.params.port})`, error);
         }
     }
-    get name() {
-        return this.params.name;
-    }
-    get security() {
-        return this.params.security;
-    }
-    get port() {
-        return this.params.port;
-    }
+    get name() { return this.params.name; }
+    get port() { return this.params.port; }
+    get security() { return this.params.security; }
     attachToGlobalCollection() {
         dynamo_nts_global_service_1.DynamoNTS_GlobalService.attachNewSocketService(this);
     }
@@ -45,9 +39,9 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
      * You must setup events and required services for this function
      */
     prepareEvents() {
-        const connectEventIndex = this.events.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.connection);
+        const connectEventIndex = this.incomingEvents.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.connection);
         if (0 <= connectEventIndex) {
-            this.connectEvent = this.events.splice(connectEventIndex)[0];
+            this.connectEvent = this.incomingEvents.splice(connectEventIndex)[0];
         }
         else {
             this.connectEvent = new dynamo_nts_socket_event_params_1.DynamoNTS_SocketEventParams({
@@ -56,9 +50,9 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
             });
         }
         if (this.getIdFromSubscrioption) {
-            const subscriptionEventIndex = this.events.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.subscribe);
+            const subscriptionEventIndex = this.incomingEvents.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.subscribe);
             if (0 <= subscriptionEventIndex) {
-                this.subscriptionEvent = this.events.splice(subscriptionEventIndex)[0];
+                this.subscriptionEvent = this.incomingEvents.splice(subscriptionEventIndex)[0];
             }
             else {
                 this.subscriptionEvent = new dynamo_nts_socket_event_params_1.DynamoNTS_SocketEventParams({
@@ -66,12 +60,12 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
                     tasks: []
                 });
             }
-            const disconnectEventIndex = this.events.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.disconnect);
+            const disconnectEventIndex = this.incomingEvents.findIndex((event) => event.event === socket_event_enum_1.DynamoNTS_SocketEvent.disconnect);
             if (0 <= disconnectEventIndex) {
-                this.events[disconnectEventIndex].tasks.push(this.removeSubscriptionOnDisconnect);
+                this.incomingEvents[disconnectEventIndex].tasks.push(this.removeSubscriptionOnDisconnect);
             }
             else {
-                this.events.push(new dynamo_nts_socket_event_params_1.DynamoNTS_SocketEventParams({
+                this.incomingEvents.push(new dynamo_nts_socket_event_params_1.DynamoNTS_SocketEventParams({
                     event: socket_event_enum_1.DynamoNTS_SocketEvent.disconnect,
                     tasks: [
                         this.removeSubscriptionOnDisconnect
@@ -81,30 +75,32 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
         }
     }
     setupSocketServer(newSocketServer) {
-        this.socketServer = newSocketServer;
-        this.socketServer.on(socket_event_enum_1.DynamoNTS_SocketEvent.connection, (socket) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let issuer;
-            for (let i = 0; i < this.connectEvent.preProcessess.length; i++) {
-                yield this.connectEvent.preProcessess[i](socket);
-            }
-            for (let i = 0; i < this.connectEvent.tasks.length; i++) {
-                yield this.connectEvent.tasks[i](socket);
-            }
-            if (this.getIdFromSubscrioption) {
-                socket.on(socket_event_enum_1.DynamoNTS_SocketEvent.subscribe, (content) => {
-                    issuer = this.getIdFromSubscrioption(content);
-                    this.socketSubscription(socket, issuer);
-                    this.subscriptionEvent.getFullExecution(issuer)(content);
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            this.socketServer = newSocketServer;
+            this.socketServer.on(socket_event_enum_1.DynamoNTS_SocketEvent.connection, (socket) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                let issuer;
+                for (let i = 0; i < this.connectEvent.preProcessess.length; i++) {
+                    yield this.connectEvent.preProcessess[i](socket);
+                }
+                for (let i = 0; i < this.connectEvent.tasks.length; i++) {
+                    yield this.connectEvent.tasks[i](socket);
+                }
+                if (this.getIdFromSubscrioption) {
+                    socket.on(socket_event_enum_1.DynamoNTS_SocketEvent.subscribe, (content) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                        issuer = yield this.getIdFromSubscrioption(content);
+                        this.socketSubscription(socket, issuer);
+                        this.subscriptionEvent.getFullExecution(issuer)(content);
+                    }));
+                }
+                this.incomingEvents.forEach((event) => {
+                    socket.on(event.event, event.getFullExecution(issuer));
                 });
-            }
-            this.events.forEach((event) => {
-                socket.on(event.event, event.getFullExecution(issuer));
-            });
-        }));
-        this.socketServer.listen(this.params.port);
-        if (this.log)
-            console.log(`\nsocket service setup finished: ${this.params.name}` +
-                `\nsocket server listening on port: ${this.params.port}`);
+            }));
+            this.socketServer.listen(this.params.port);
+            if (this.log)
+                console.log(`\nsocket service setup finished: ${this.params.name}` +
+                    `\nsocket server listening on port: ${this.params.port}`);
+        });
     }
     socketSubscription(newSocket, id) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -132,16 +128,29 @@ class DynamoNTS_SocketService extends dynamo_nts_singleton_service_1.DynamoNTS_S
     emitEvent(event, content) {
         this.socketServer.emit(event, content);
     }
-    emitEventForId(id, event, content) {
-        const dic = this.activeSockets.find((dic) => dic.id === id);
-        if (dic) {
+    idIsSubscribed(id) {
+        return !!this.activeSockets.find((dic) => dic.id === id);
+    }
+    sendEventForId(id, event, content, error) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const dic = this.activeSockets.find((dic) => dic.id === id);
+            if (dic) {
+                dic.sockets.forEach((socket) => {
+                    socket.emit(event, content);
+                });
+            }
+            else {
+                if (error)
+                    throw new fsm_dynamo_1.DynamoNTS_Error({ status: 404, message: `No active socket whit this specific ID: ${id}` });
+            }
+        });
+    }
+    broadcastEvent(event, content) {
+        this.activeSockets.forEach((dic) => {
             dic.sockets.forEach((socket) => {
                 socket.emit(event, content);
             });
-        }
-        else {
-            throw new fsm_dynamo_1.DynamoNTS_Error({ message: `No active socket whit this specific ID: ${id}` });
-        }
+        });
     }
 }
 exports.DynamoNTS_SocketService = DynamoNTS_SocketService;