topsyde-utils 1.0.196 → 1.0.198

package/dist/index.d.ts

@@ -25,7 +25,9 @@ export * from "./server/bun/websocket/websocket.types";
 export * from "./utils/Rxjs";
 export * from "./utils/Lib";
 export * from "./utils/Guards";
+export * from "./utils/BaseEntity";
 export * from "./utils/Console";
+export * from "./utils/BaseDto";
 export { default as Singleton } from "./singleton";
 export { default as Initializable } from "./initializable";
 export { default as Application } from "./application";
@@ -42,6 +44,7 @@ export { default as Channel } from "./server/bun/websocket/Channel";
 export { default as Client } from "./server/bun/websocket/Client";
 export { default as Lib } from "./utils/Lib";
 export { default as Guards } from "./utils/Guards";
+export { default as BaseEntity } from "./utils/BaseEntity";
 export { default as Console } from "./utils/Console";
 export { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from "./errors";
 export { InitializableOptions, InitializableEvent } from "./initializable";

package/dist/index.js

@@ -28,7 +28,9 @@ export * from "./server/bun/websocket/websocket.types.js";
 export * from "./utils/Rxjs.js";
 export * from "./utils/Lib.js";
 export * from "./utils/Guards.js";
+export * from "./utils/BaseEntity.js";
 export * from "./utils/Console.js";
+export * from "./utils/BaseDto.js";
 // Export default classes
 export { default as Singleton } from "./singleton.js";
 export { default as Initializable } from "./initializable.js";
@@ -46,6 +48,7 @@ export { default as Channel } from "./server/bun/websocket/Channel.js";
 export { default as Client } from "./server/bun/websocket/Client.js";
 export { default as Lib } from "./utils/Lib.js";
 export { default as Guards } from "./utils/Guards.js";
+export { default as BaseEntity } from "./utils/BaseEntity.js";
 export { default as Console } from "./utils/Console.js";
 // Re-export specific items for backward compatibility
 export { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from "./errors.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,iCAAiC;AAEjC,qBAAqB;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,8CAA8C,CAAC;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAEhC,yBAAyB;AACzB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACjG,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAErD,sDAAsD;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAmB5G,OAAO,EAAE,aAAa,EAAiC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC","sourcesContent":["// This file is auto-generated by scripts/generate-indexes.ts\n// Do not edit this file directly\n\n// Export all modules\nexport * from \"./errors\";\nexport * from \"./singleton\";\nexport * from \"./initializable\";\nexport * from \"./application\";\nexport * from \"./consts\";\nexport * from \"./types\";\nexport * from \"./throwable\";\nexport * from \"./enums\";\nexport * from \"./client/rxjs/useRxjs\";\nexport * from \"./client/vite/plugins/topsydeUtilsVitePlugin\";\nexport * from \"./server/controller\";\nexport * from \"./server/service\";\nexport * from \"./server/base/base.database\";\nexport * from \"./server/bun/router/controller-discovery\";\nexport * from \"./server/bun/router/routes\";\nexport * from \"./server/bun/router/router\";\nexport * from \"./server/bun/router/router.internal\";\nexport * from \"./server/bun/websocket/Websocket\";\nexport * from \"./server/bun/websocket/websocket.guards\";\nexport * from \"./server/bun/websocket/Message\";\nexport * from \"./server/bun/websocket/Channel\";\nexport * from \"./server/bun/websocket/Client\";\nexport * from \"./server/bun/websocket/websocket.enums\";\nexport * from \"./server/bun/websocket/websocket.types\";\nexport * from \"./utils/Rxjs\";\nexport * from \"./utils/Lib\";\nexport * from \"./utils/Guards\";\nexport * from \"./utils/Console\";\n\n// Export default classes\nexport { default as Singleton } from \"./singleton\";\nexport { default as Initializable } from \"./initializable\";\nexport { default as Application } from \"./application\";\nexport { default as Throwable } from \"./throwable\";\nexport { default as TopsydeUtilsVitePlugin } from \"./client/vite/plugins/topsydeUtilsVitePlugin\";\nexport { default as Controller } from \"./server/controller\";\nexport { default as Service } from \"./server/service\";\nexport { default as Database } from \"./server/base/base.database\";\nexport { default as Router } from \"./server/bun/router/router\";\nexport { default as Router_Internal } from \"./server/bun/router/router.internal\";\nexport { default as Websocket } from \"./server/bun/websocket/Websocket\";\nexport { default as Message } from \"./server/bun/websocket/Message\";\nexport { default as Channel } from \"./server/bun/websocket/Channel\";\nexport { default as Client } from \"./server/bun/websocket/Client\";\nexport { default as Lib } from \"./utils/Lib\";\nexport { default as Guards } from \"./utils/Guards\";\nexport { default as Console } from \"./utils/Console\";\n\n// Re-export specific items for backward compatibility\nexport { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from \"./errors\";\nexport { InitializableOptions, InitializableEvent } from \"./initializable\";\nexport { RESPONSE_INIT, HEADERS_INIT, RESPONSE_METHOD_OPTIONS } from \"./application\";\nexport { DEFAULT_FALSE_RESPONSE, LOG_COLORS, LOG_ICONS } from \"./consts\";\nexport { ClassConstructor, NonNullableType, ObjectKeys, KVObj, I_ApplicationResponse } from \"./types\";\nexport { E_IS, E_ENVIRONMENTS } from \"./enums\";\nexport { RxjsDataType, NamespaceActions, MultiNamespaceActions } from \"./client/rxjs/useRxjs\";\nexport { ControllerResponse, ControllerAction, ControllerMap, ControllerOptions } from \"./server/controller\";\nexport { Routes } from \"./server/bun/router/routes\";\nexport { WebsocketConstructorOptions, I_WebsocketConstructor } from \"./server/bun/websocket/Websocket\";\nexport { E_WebsocketMessageType, E_WebsocketMessagePriority } from \"./server/bun/websocket/websocket.enums\";\nexport {\n\tBunWebsocketMessage,\n\tWebsocketChannel,\n\tWebsocketClients,\n\tWebsocketMessageOptions,\n\tWebsocketMessage,\n\tWebsocketStructuredMessage,\n\tWebsocketEntityId,\n\tWebsocketEntityName,\n\tWebsocketEntityData,\n\tI_WebsocketEntity,\n\tI_WebsocketClient,\n\tI_WebsocketChannelEntity,\n\tBroadcastOptions,\n\tI_WebsocketChannel,\n\tWebsocketInterfaceHandlers,\n\tI_WebsocketInterface,\n} from \"./server/bun/websocket/websocket.types\";\nexport { E_SUBJET_TYPE, I_RxjsPayload, RxjsNamespaces, AsyncSubject, BehaviorSubject, ReplaySubject, Subject, Subscription } from \"./utils/Rxjs\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// This file is auto-generated by scripts/generate-indexes.ts\n// Do not edit this file directly\n\n// Export all modules\nexport * from \"./errors\";\nexport * from \"./singleton\";\nexport * from \"./initializable\";\nexport * from \"./application\";\nexport * from \"./consts\";\nexport * from \"./types\";\nexport * from \"./throwable\";\nexport * from \"./enums\";\nexport * from \"./client/rxjs/useRxjs\";\nexport * from \"./client/vite/plugins/topsydeUtilsVitePlugin\";\nexport * from \"./server/controller\";\nexport * from \"./server/service\";\nexport * from \"./server/base/base.database\";\nexport * from \"./server/bun/router/controller-discovery\";\nexport * from \"./server/bun/router/routes\";\nexport * from \"./server/bun/router/router\";\nexport * from \"./server/bun/router/router.internal\";\nexport * from \"./server/bun/websocket/Websocket\";\nexport * from \"./server/bun/websocket/websocket.guards\";\nexport * from \"./server/bun/websocket/Message\";\nexport * from \"./server/bun/websocket/Channel\";\nexport * from \"./server/bun/websocket/Client\";\nexport * from \"./server/bun/websocket/websocket.enums\";\nexport * from \"./server/bun/websocket/websocket.types\";\nexport * from \"./utils/Rxjs\";\nexport * from \"./utils/Lib\";\nexport * from \"./utils/Guards\";\nexport * from \"./utils/BaseEntity\";\nexport * from \"./utils/Console\";\nexport * from \"./utils/BaseDto\";\n\n// Export default classes\nexport { default as Singleton } from \"./singleton\";\nexport { default as Initializable } from \"./initializable\";\nexport { default as Application } from \"./application\";\nexport { default as Throwable } from \"./throwable\";\nexport { default as TopsydeUtilsVitePlugin } from \"./client/vite/plugins/topsydeUtilsVitePlugin\";\nexport { default as Controller } from \"./server/controller\";\nexport { default as Service } from \"./server/service\";\nexport { default as Database } from \"./server/base/base.database\";\nexport { default as Router } from \"./server/bun/router/router\";\nexport { default as Router_Internal } from \"./server/bun/router/router.internal\";\nexport { default as Websocket } from \"./server/bun/websocket/Websocket\";\nexport { default as Message } from \"./server/bun/websocket/Message\";\nexport { default as Channel } from \"./server/bun/websocket/Channel\";\nexport { default as Client } from \"./server/bun/websocket/Client\";\nexport { default as Lib } from \"./utils/Lib\";\nexport { default as Guards } from \"./utils/Guards\";\nexport { default as BaseEntity } from \"./utils/BaseEntity\";\nexport { default as Console } from \"./utils/Console\";\n\n// Re-export specific items for backward compatibility\nexport { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from \"./errors\";\nexport { InitializableOptions, InitializableEvent } from \"./initializable\";\nexport { RESPONSE_INIT, HEADERS_INIT, RESPONSE_METHOD_OPTIONS } from \"./application\";\nexport { DEFAULT_FALSE_RESPONSE, LOG_COLORS, LOG_ICONS } from \"./consts\";\nexport { ClassConstructor, NonNullableType, ObjectKeys, KVObj, I_ApplicationResponse } from \"./types\";\nexport { E_IS, E_ENVIRONMENTS } from \"./enums\";\nexport { RxjsDataType, NamespaceActions, MultiNamespaceActions } from \"./client/rxjs/useRxjs\";\nexport { ControllerResponse, ControllerAction, ControllerMap, ControllerOptions } from \"./server/controller\";\nexport { Routes } from \"./server/bun/router/routes\";\nexport { WebsocketConstructorOptions, I_WebsocketConstructor } from \"./server/bun/websocket/Websocket\";\nexport { E_WebsocketMessageType, E_WebsocketMessagePriority } from \"./server/bun/websocket/websocket.enums\";\nexport {\n\tBunWebsocketMessage,\n\tWebsocketChannel,\n\tWebsocketClients,\n\tWebsocketMessageOptions,\n\tWebsocketMessage,\n\tWebsocketStructuredMessage,\n\tWebsocketEntityId,\n\tWebsocketEntityName,\n\tWebsocketEntityData,\n\tI_WebsocketEntity,\n\tI_WebsocketClient,\n\tI_WebsocketChannelEntity,\n\tBroadcastOptions,\n\tI_WebsocketChannel,\n\tWebsocketInterfaceHandlers,\n\tI_WebsocketInterface,\n} from \"./server/bun/websocket/websocket.types\";\nexport { E_SUBJET_TYPE, I_RxjsPayload, RxjsNamespaces, AsyncSubject, BehaviorSubject, ReplaySubject, Subject, Subscription } from \"./utils/Rxjs\";\n"]}

package/dist/utils/BaseDto.d.ts

@@ -0,0 +1,39 @@
+import type { ClassConstructor, ClassTransformOptions } from "class-transformer";
+import { ValidationError } from "class-validator";
+/**
+ * Base typesafe class for Data Transfer Objects (DTOs)
+ */
+export declare abstract class Dto {
+    /**
+     * Default options for class transformation
+     */
+    protected static readonly defaultTransformOptions: ClassTransformOptions;
+    /**
+     * Validates the DTO instance
+     * @throws ValidationError[] if validation fails
+     */
+    validate(): ValidationError[];
+    /**
+     * Converts the DTO to a plain object
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns Plain object representation of the DTO
+     */
+    toJSON<T = Record<string, unknown>>(include_undefined?: boolean, options?: ClassTransformOptions): T;
+    /**
+     * Creates a new instance of the DTO with validation
+     * @param cls - The class constructor to create an instance from
+     * @param data - Data to create the DTO from
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns New instance of the DTO
+     * @throws ValidationError[] if validation fails and validate is true
+     */
+    static create<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, data: D, options?: ClassTransformOptions): T;
+    /**
+     * Creates an array of DTOs from an array of plain objects
+     * @param cls - The class constructor to create instances from
+     * @param dataArray - Array of data to create DTOs from
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns Array of DTO instances
+     */
+    static createMany<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, dataArray: D[], options?: ClassTransformOptions): T[];
+}

package/dist/utils/BaseDto.js

@@ -0,0 +1,72 @@
+import { instanceToPlain, plainToInstance } from "class-transformer";
+import Guards from "./Guards.js";
+import { validateSync } from "class-validator";
+/**
+ * Base typesafe class for Data Transfer Objects (DTOs)
+ */
+export class Dto {
+    /**
+     * Validates the DTO instance
+     * @throws ValidationError[] if validation fails
+     */
+    validate() {
+        const errors = validateSync(this, {
+            validationError: { target: false },
+            forbidUnknownValues: true,
+        });
+        if (errors.length > 0) {
+            throw errors;
+        }
+        return errors;
+    }
+    /**
+     * Converts the DTO to a plain object
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns Plain object representation of the DTO
+     */
+    toJSON(include_undefined = true, options) {
+        const value = instanceToPlain(this, {
+            ...Dto.defaultTransformOptions,
+            ...options,
+        });
+        if (!include_undefined) {
+            return Object.fromEntries(Object.entries(value).filter(([_, v]) => !Guards.IsNil(v)));
+        }
+        return value;
+    }
+    /**
+     * Creates a new instance of the DTO with validation
+     * @param cls - The class constructor to create an instance from
+     * @param data - Data to create the DTO from
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns New instance of the DTO
+     * @throws ValidationError[] if validation fails and validate is true
+     */
+    static create(cls, data, options = {}) {
+        const instance = plainToInstance(cls, data, {
+            ...Dto.defaultTransformOptions,
+            ...options,
+        });
+        return instance;
+    }
+    /**
+     * Creates an array of DTOs from an array of plain objects
+     * @param cls - The class constructor to create instances from
+     * @param dataArray - Array of data to create DTOs from
+     * @param options - Class transformer options for controlling exposure and transformation
+     * @returns Array of DTO instances
+     */
+    static createMany(cls, dataArray, options = {}) {
+        return dataArray.map((data) => Dto.create(cls, data, options));
+    }
+}
+/**
+ * Default options for class transformation
+ */
+Dto.defaultTransformOptions = {
+    excludeExtraneousValues: true,
+    enableCircularCheck: true,
+    exposeDefaultValues: true,
+    enableImplicitConversion: false, // Safer default, especially when using class-validator
+};
+//# sourceMappingURL=BaseDto.js.map

package/dist/utils/BaseDto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDto.js","sourceRoot":"","sources":["../../src/utils/BaseDto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAmB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAgB,GAAG;IAWxB;;;OAGG;IACI,QAAQ;QACd,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE;YACjC,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;YAClC,mBAAmB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,MAAM,CAA8B,oBAA6B,IAAI,EAAE,OAA+B;QAC5G,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE;YACnC,GAAG,GAAG,CAAC,uBAAuB;YAC9B,GAAG,OAAO;SACV,CAAM,CAAC;QAER,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAM,CAAC;QACvH,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAmD,GAAwB,EAAE,IAAO,EAAE,UAAiC,EAAE;QACrI,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE;YAC3C,GAAG,GAAG,CAAC,uBAAuB;YAC9B,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAmD,GAAwB,EAAE,SAAc,EAAE,UAAiC,EAAE;QAChJ,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;;AArED;;GAEG;AACuB,2BAAuB,GAA0B;IAC1E,uBAAuB,EAAE,IAAI;IAC7B,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,IAAI;IACzB,wBAAwB,EAAE,KAAK,EAAE,uDAAuD;CACxF,CAAC","sourcesContent":["import type { ClassConstructor, ClassTransformOptions } from \"class-transformer\";\nimport { instanceToPlain, plainToInstance } from \"class-transformer\";\nimport Guards from \"./Guards\";\nimport { ValidationError, validateSync } from \"class-validator\";\n\n/**\n * Base typesafe class for Data Transfer Objects (DTOs)\n */\nexport abstract class Dto {\n\t/**\n\t * Default options for class transformation\n\t */\n\tprotected static readonly defaultTransformOptions: ClassTransformOptions = {\n\t\texcludeExtraneousValues: true,\n\t\tenableCircularCheck: true,\n\t\texposeDefaultValues: true,\n\t\tenableImplicitConversion: false, // Safer default, especially when using class-validator\n\t};\n\n\t/**\n\t * Validates the DTO instance\n\t * @throws ValidationError[] if validation fails\n\t */\n\tpublic validate(): ValidationError[] {\n\t\tconst errors = validateSync(this, {\n\t\t\tvalidationError: { target: false },\n\t\t\tforbidUnknownValues: true,\n\t\t});\n\t\tif (errors.length > 0) {\n\t\t\tthrow errors;\n\t\t}\n\t\treturn errors;\n\t}\n\n\t/**\n\t * Converts the DTO to a plain object\n\t * @param options - Class transformer options for controlling exposure and transformation\n\t * @returns Plain object representation of the DTO\n\t */\n\tpublic toJSON<T = Record<string, unknown>>(include_undefined: boolean = true, options?: ClassTransformOptions): T {\n\t\tconst value = instanceToPlain(this, {\n\t\t\t...Dto.defaultTransformOptions,\n\t\t\t...options,\n\t\t}) as T;\n\n\t\tif (!include_undefined) {\n\t\t\treturn Object.fromEntries(Object.entries(value as Record<string, unknown>).filter(([_, v]) => !Guards.IsNil(v))) as T;\n\t\t}\n\n\t\treturn value;\n\t}\n\n\t/**\n\t * Creates a new instance of the DTO with validation\n\t * @param cls - The class constructor to create an instance from\n\t * @param data - Data to create the DTO from\n\t * @param options - Class transformer options for controlling exposure and transformation\n\t * @returns New instance of the DTO\n\t * @throws ValidationError[] if validation fails and validate is true\n\t */\n\tstatic create<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, data: D, options: ClassTransformOptions = {}): T {\n\t\tconst instance = plainToInstance(cls, data, {\n\t\t\t...Dto.defaultTransformOptions,\n\t\t\t...options,\n\t\t});\n\n\t\treturn instance;\n\t}\n\n\t/**\n\t * Creates an array of DTOs from an array of plain objects\n\t * @param cls - The class constructor to create instances from\n\t * @param dataArray - Array of data to create DTOs from\n\t * @param options - Class transformer options for controlling exposure and transformation\n\t * @returns Array of DTO instances\n\t */\n\tstatic createMany<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, dataArray: D[], options: ClassTransformOptions = {}): T[] {\n\t\treturn dataArray.map((data) => Dto.create(cls, data, options));\n\t}\n}\n"]}

package/dist/utils/BaseEntity.d.ts

@@ -0,0 +1,29 @@
+import { ClassConstructor } from "class-transformer";
+import { Dto } from "./BaseDto";
+export default abstract class BaseEntity {
+    /**
+     * Converts entity to plain object
+     */
+    toJSON<T = Record<string, unknown>>(): T;
+    /**
+     * Abstract method - entities must define how to convert to DTO
+     */
+    abstract toDto(): Dto;
+    /**
+     * Creates a new entity instance from DTO with validation
+     * @param cls - Entity class constructor
+     * @param dto - DTO to create entity from
+     * @param validate - Whether to validate after creation (default: true)
+     */
+    static fromDto<T extends BaseEntity>(cls: ClassConstructor<T>, dto: Dto): T;
+    /**
+     * Creates multiple entities from DTOs
+     */
+    static fromDtos<T extends BaseEntity>(cls: ClassConstructor<T>, dtos: Dto[]): T[];
+    /**
+     * Updates entity with partial data (immutable - returns new instance)
+     * @param data - Partial data to update
+     * @param validate - Whether to validate after update (default: true)
+     */
+    update<T extends BaseEntity>(this: T, data: Partial<T>): T;
+}

package/dist/utils/BaseEntity.js

@@ -0,0 +1,35 @@
+import { instanceToPlain, plainToInstance } from "class-transformer";
+export default class BaseEntity {
+    /**
+     * Converts entity to plain object
+     */
+    toJSON() {
+        return instanceToPlain(this);
+    }
+    /**
+     * Creates a new entity instance from DTO with validation
+     * @param cls - Entity class constructor
+     * @param dto - DTO to create entity from
+     * @param validate - Whether to validate after creation (default: true)
+     */
+    static fromDto(cls, dto) {
+        const instance = plainToInstance(cls, dto.toJSON());
+        return instance;
+    }
+    /**
+     * Creates multiple entities from DTOs
+     */
+    static fromDtos(cls, dtos) {
+        return dtos.map((dto) => BaseEntity.fromDto(cls, dto));
+    }
+    /**
+     * Updates entity with partial data (immutable - returns new instance)
+     * @param data - Partial data to update
+     * @param validate - Whether to validate after update (default: true)
+     */
+    update(data) {
+        const updated = Object.assign(Object.create(Object.getPrototypeOf(this)), this, data);
+        return updated;
+    }
+}
+//# sourceMappingURL=BaseEntity.js.map

package/dist/utils/BaseEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseEntity.js","sourceRoot":"","sources":["../../src/utils/BaseEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGvF,MAAM,CAAC,OAAO,OAAgB,UAAU;IACvC;;OAEG;IACI,MAAM;QACZ,OAAO,eAAe,CAAC,IAAI,CAAM,CAAC;IACnC,CAAC;IAOD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAuB,GAAwB,EAAE,GAAQ;QACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAuB,GAAwB,EAAE,IAAW;QAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAgC,IAAgB;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC;IAChB,CAAC;CACD","sourcesContent":["import { ClassConstructor, instanceToPlain, plainToInstance } from \"class-transformer\";\nimport { Dto } from \"./BaseDto\";\n\nexport default abstract class BaseEntity {\n\t/**\n\t * Converts entity to plain object\n\t */\n\tpublic toJSON<T = Record<string, unknown>>(): T {\n\t\treturn instanceToPlain(this) as T;\n\t}\n\n\t/**\n\t * Abstract method - entities must define how to convert to DTO\n\t */\n\tpublic abstract toDto(): Dto;\n\n\t/**\n\t * Creates a new entity instance from DTO with validation\n\t * @param cls - Entity class constructor\n\t * @param dto - DTO to create entity from\n\t * @param validate - Whether to validate after creation (default: true)\n\t */\n\tstatic fromDto<T extends BaseEntity>(cls: ClassConstructor<T>, dto: Dto): T {\n\t\tconst instance = plainToInstance(cls, dto.toJSON());\n\t\treturn instance;\n\t}\n\n\t/**\n\t * Creates multiple entities from DTOs\n\t */\n\tstatic fromDtos<T extends BaseEntity>(cls: ClassConstructor<T>, dtos: Dto[]): T[] {\n\t\treturn dtos.map((dto) => BaseEntity.fromDto(cls, dto));\n\t}\n\n\t/**\n\t * Updates entity with partial data (immutable - returns new instance)\n\t * @param data - Partial data to update\n\t * @param validate - Whether to validate after update (default: true)\n\t */\n\tpublic update<T extends BaseEntity>(this: T, data: Partial<T>): T {\n\t\tconst updated = Object.assign(Object.create(Object.getPrototypeOf(this)), this, data);\n\t\treturn updated;\n\t}\n}\n"]}

package/dist/utils/index.d.ts

@@ -1,7 +1,10 @@
 export * from './Rxjs';
 export * from './Lib';
 export * from './Guards';
+export * from './BaseEntity';
 export * from './Console';
+export * from './BaseDto';
 export { default as Lib } from './Lib';
 export { default as Guards } from './Guards';
+export { default as BaseEntity } from './BaseEntity';
 export { default as Console } from './Console';

package/dist/utils/index.js

@@ -3,8 +3,11 @@
 export * from './Rxjs.js';
 export * from './Lib.js';
 export * from './Guards.js';
+export * from './BaseEntity.js';
 export * from './Console.js';
+export * from './BaseDto.js';
 export { default as Lib } from './Lib.js';
 export { default as Guards } from './Guards.js';
+export { default as BaseEntity } from './BaseEntity.js';
 export { default as Console } from './Console.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,iCAAiC;AAEjC,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC","sourcesContent":["// This file is auto-generated by scripts/generate-indexes.ts\n// Do not edit this file directly\n\nexport * from './Rxjs';\nexport * from './Lib';\nexport * from './Guards';\nexport * from './Console';\nexport { default as Lib } from './Lib';\nexport { default as Guards } from './Guards';\nexport { default as Console } from './Console';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,iCAAiC;AAEjC,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC","sourcesContent":["// This file is auto-generated by scripts/generate-indexes.ts\n// Do not edit this file directly\n\nexport * from './Rxjs';\nexport * from './Lib';\nexport * from './Guards';\nexport * from './BaseEntity';\nexport * from './Console';\nexport * from './BaseDto';\nexport { default as Lib } from './Lib';\nexport { default as Guards } from './Guards';\nexport { default as BaseEntity } from './BaseEntity';\nexport { default as Console } from './Console';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topsyde-utils",
-  "version": "1.0.196",
+  "version": "1.0.198",
   "description": "A bundle of TypeScript utility classes and functions",
   "type": "module",
   "main": "dist/index.js",
@@ -110,6 +110,8 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
     "rxjs": "^7.8.2",
     "vite": "^6.2.0",
     "vue": "^3.5.13"

package/src/index.ts

@@ -29,7 +29,9 @@ export * from "./server/bun/websocket/websocket.types";
 export * from "./utils/Rxjs";
 export * from "./utils/Lib";
 export * from "./utils/Guards";
+export * from "./utils/BaseEntity";
 export * from "./utils/Console";
+export * from "./utils/BaseDto";
 
 // Export default classes
 export { default as Singleton } from "./singleton";
@@ -48,6 +50,7 @@ export { default as Channel } from "./server/bun/websocket/Channel";
 export { default as Client } from "./server/bun/websocket/Client";
 export { default as Lib } from "./utils/Lib";
 export { default as Guards } from "./utils/Guards";
+export { default as BaseEntity } from "./utils/BaseEntity";
 export { default as Console } from "./utils/Console";
 
 // Re-export specific items for backward compatibility

package/src/utils/BaseDto.ts

@@ -0,0 +1,80 @@
+import type { ClassConstructor, ClassTransformOptions } from "class-transformer";
+import { instanceToPlain, plainToInstance } from "class-transformer";
+import Guards from "./Guards";
+import { ValidationError, validateSync } from "class-validator";
+
+/**
+ * Base typesafe class for Data Transfer Objects (DTOs)
+ */
+export abstract class Dto {
+	/**
+	 * Default options for class transformation
+	 */
+	protected static readonly defaultTransformOptions: ClassTransformOptions = {
+		excludeExtraneousValues: true,
+		enableCircularCheck: true,
+		exposeDefaultValues: true,
+		enableImplicitConversion: false, // Safer default, especially when using class-validator
+	};
+
+	/**
+	 * Validates the DTO instance
+	 * @throws ValidationError[] if validation fails
+	 */
+	public validate(): ValidationError[] {
+		const errors = validateSync(this, {
+			validationError: { target: false },
+			forbidUnknownValues: true,
+		});
+		if (errors.length > 0) {
+			throw errors;
+		}
+		return errors;
+	}
+
+	/**
+	 * Converts the DTO to a plain object
+	 * @param options - Class transformer options for controlling exposure and transformation
+	 * @returns Plain object representation of the DTO
+	 */
+	public toJSON<T = Record<string, unknown>>(include_undefined: boolean = true, options?: ClassTransformOptions): T {
+		const value = instanceToPlain(this, {
+			...Dto.defaultTransformOptions,
+			...options,
+		}) as T;
+
+		if (!include_undefined) {
+			return Object.fromEntries(Object.entries(value as Record<string, unknown>).filter(([_, v]) => !Guards.IsNil(v))) as T;
+		}
+
+		return value;
+	}
+
+	/**
+	 * Creates a new instance of the DTO with validation
+	 * @param cls - The class constructor to create an instance from
+	 * @param data - Data to create the DTO from
+	 * @param options - Class transformer options for controlling exposure and transformation
+	 * @returns New instance of the DTO
+	 * @throws ValidationError[] if validation fails and validate is true
+	 */
+	static create<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, data: D, options: ClassTransformOptions = {}): T {
+		const instance = plainToInstance(cls, data, {
+			...Dto.defaultTransformOptions,
+			...options,
+		});
+
+		return instance;
+	}
+
+	/**
+	 * Creates an array of DTOs from an array of plain objects
+	 * @param cls - The class constructor to create instances from
+	 * @param dataArray - Array of data to create DTOs from
+	 * @param options - Class transformer options for controlling exposure and transformation
+	 * @returns Array of DTO instances
+	 */
+	static createMany<T extends Dto, D extends Record<string, unknown>>(cls: ClassConstructor<T>, dataArray: D[], options: ClassTransformOptions = {}): T[] {
+		return dataArray.map((data) => Dto.create(cls, data, options));
+	}
+}

package/src/utils/BaseEntity.ts

@@ -0,0 +1,44 @@
+import { ClassConstructor, instanceToPlain, plainToInstance } from "class-transformer";
+import { Dto } from "./BaseDto";
+
+export default abstract class BaseEntity {
+	/**
+	 * Converts entity to plain object
+	 */
+	public toJSON<T = Record<string, unknown>>(): T {
+		return instanceToPlain(this) as T;
+	}
+
+	/**
+	 * Abstract method - entities must define how to convert to DTO
+	 */
+	public abstract toDto(): Dto;
+
+	/**
+	 * Creates a new entity instance from DTO with validation
+	 * @param cls - Entity class constructor
+	 * @param dto - DTO to create entity from
+	 * @param validate - Whether to validate after creation (default: true)
+	 */
+	static fromDto<T extends BaseEntity>(cls: ClassConstructor<T>, dto: Dto): T {
+		const instance = plainToInstance(cls, dto.toJSON());
+		return instance;
+	}
+
+	/**
+	 * Creates multiple entities from DTOs
+	 */
+	static fromDtos<T extends BaseEntity>(cls: ClassConstructor<T>, dtos: Dto[]): T[] {
+		return dtos.map((dto) => BaseEntity.fromDto(cls, dto));
+	}
+
+	/**
+	 * Updates entity with partial data (immutable - returns new instance)
+	 * @param data - Partial data to update
+	 * @param validate - Whether to validate after update (default: true)
+	 */
+	public update<T extends BaseEntity>(this: T, data: Partial<T>): T {
+		const updated = Object.assign(Object.create(Object.getPrototypeOf(this)), this, data);
+		return updated;
+	}
+}

package/src/utils/index.ts

@@ -4,7 +4,10 @@
 export * from './Rxjs';
 export * from './Lib';
 export * from './Guards';
+export * from './BaseEntity';
 export * from './Console';
+export * from './BaseDto';
 export { default as Lib } from './Lib';
 export { default as Guards } from './Guards';
+export { default as BaseEntity } from './BaseEntity';
 export { default as Console } from './Console';