topsyde-utils 1.3.2 → 2.0.1

package/dist/server/bun/websocket/websocket.types.d.ts

@@ -1,235 +0,0 @@
-import { ServerWebSocket, WebSocketHandler } from "bun";
-import Channel from "./Channel";
-import Websocket from "./Websocket";
-import { E_ClientState } from "./websocket.enums";
-export type BunWebsocketMessage = string | Buffer<ArrayBufferLike>;
-export type WebsocketChannel<T extends I_WebsocketChannel = Channel> = Map<string, T>;
-export type WebsocketClients = Map<string, I_WebsocketClient>;
-export type WebsocketMessageOptions = {
-    /**
-     * Additional data to include in the message content
-     * If an object is provided, it will be merged with the content
-     * If a primitive value is provided, it will be added as content.data
-     */
-    data?: any;
-    /**
-     * Client information to include in the message
-     * Will be added as content.client
-     */
-    client?: Partial<WebsocketEntityData> & {
-        [key: string]: any;
-    };
-    /**
-     * Channel metadata to include in the message
-     * If true, all metadata will be included
-     * If an array of strings, only the specified keys will be included
-     */
-    includeMetadata?: boolean | string[];
-    /**
-     * Client IDs to exclude from receiving the broadcast
-     * Useful for sending messages to all clients except the sender
-     */
-    excludeClients?: string[];
-    /**
-     * Channel to include in the message
-     * Defaults to the channel of the message
-     */
-    channel?: string;
-    /**
-     * Whether to include timestamp in the message
-     * Defaults to true
-     */
-    includeTimestamp?: boolean;
-    /**
-     * Custom fields to add to the root of the message
-     * These will be merged with the message object
-     */
-    customFields?: Record<string, any>;
-    /**
-     * Transform function to modify the final message before sending
-     * This is applied after all other processing
-     */
-    transform?: (message: any) => any;
-    /**
-     * Priority of the message (higher numbers = higher priority)
-     * Can be used by clients to determine processing order
-     */
-    priority?: number;
-    /**
-     * Message expiration time in milliseconds since epoch
-     * Can be used by clients to ignore outdated messages
-     */
-    expiresAt?: number;
-    /**
-     * Metadata to include in the message
-     * If an array of strings, only the specified keys will be included
-     */
-    metadata?: boolean | string[] | Record<string, string>;
-};
-export type WebsocketMessage<T extends Record<string, any> = Record<string, any>> = {
-    /**
-     * Message type identifier used for client-side routing
-     */
-    type: string;
-    /**
-     * Message content - can be any data structure
-     * If a string is provided, it will be wrapped in {message: string}
-     */
-    content: T;
-    /**
-     * Channel ID
-     */
-    channel?: string;
-    /**
-     * Timestamp of the message
-     */
-    timestamp?: string;
-    /**
-     * Any additional custom fields
-     */
-    [key: string]: any;
-};
-/**
- * Message structure sent over the wire to clients.
- * This is the actual WebSocket payload format - transport options are NOT included.
- */
-export type WebsocketStructuredMessage<T extends Record<string, any> = Record<string, any>> = {
-    /** Message type identifier for client-side routing */
-    type: string;
-    /** Message payload */
-    content: T;
-    /** Channel ID where message originated */
-    channel?: string;
-    /** ISO timestamp when message was created */
-    timestamp?: string;
-    /** Client information (who sent this) */
-    client?: WebsocketEntityData;
-    /** Channel metadata (if included) */
-    metadata?: Record<string, string>;
-    /** Message priority for client-side processing */
-    priority?: number;
-    /** Expiration timestamp (milliseconds since epoch) */
-    expiresAt?: number;
-    /** Any additional custom fields */
-    [key: string]: any;
-};
-/**
- * @deprecated This type incorrectly mixed transport options with wire format.
- * Use WebsocketStructuredMessage for wire format and WebsocketMessageOptions for options.
- * This will be removed in a future version.
- */
-export type deprecated_WebsocketStructuredMessage<T extends Record<string, any> = Record<string, any>> = WebsocketMessage<T> & WebsocketMessageOptions;
-export type WebsocketEntityId = string;
-export type WebsocketEntityName = string;
-export type WebsocketEntityData = {
-    id: WebsocketEntityId;
-    name: WebsocketEntityName;
-};
-export interface I_WebsocketEntity extends WebsocketEntityData {
-    ws: ServerWebSocket<WebsocketEntityData>;
-}
-export interface I_WebsocketClient extends I_WebsocketEntity {
-    channels: WebsocketChannel<I_WebsocketChannel>;
-    state: E_ClientState;
-    send(message: string, options?: WebsocketMessageOptions): void;
-    send(message: WebsocketStructuredMessage): void;
-    subscribe(channel: string): any;
-    trackChannel(channel: I_WebsocketChannel): void;
-    untrackChannel(channel: I_WebsocketChannel): void;
-    joinChannel(channel: I_WebsocketChannel, send?: boolean): {
-        success: boolean;
-        reason: string;
-    };
-    leaveChannel(channel: I_WebsocketChannel, send?: boolean): void;
-    joinChannels(channels: I_WebsocketChannel[], send?: boolean): void;
-    leaveChannels(channels?: I_WebsocketChannel[], send?: boolean): void;
-    unsubscribe(channel: string): any;
-    whoami(): WebsocketEntityData;
-    canReceiveMessages(): boolean;
-    markConnected(): void;
-    markDisconnecting(): void;
-    markDisconnected(): void;
-    getConnectionInfo(): {
-        id: string;
-        name: string;
-        state: E_ClientState;
-        connectedAt?: Date;
-        disconnectedAt?: Date;
-        uptime: number;
-        channelCount: number;
-    };
-}
-export interface I_WebsocketChannelEntity<T extends Websocket = Websocket> extends WebsocketEntityData {
-    ws: T;
-}
-export type BroadcastOptions = WebsocketMessageOptions & {
-    debug?: boolean;
-};
-export type AddMemberResult = {
-    success: true;
-    client: I_WebsocketClient;
-} | {
-    success: false;
-    reason: "full" | "already_member" | "error";
-    error?: Error;
-};
-export type AddMemberOptions = {
-    /** Whether to notify client when channel is full (default: false) */
-    notify_when_full?: boolean;
-    /** Whether to send welcome notification to client on successful join (default: false) */
-    notify?: boolean;
-};
-export type RemoveMemberOptions = {
-    /** Whether to send goodbye notification to client on successful leave (default: false) */
-    notify?: boolean;
-};
-export interface I_WebsocketChannel<T extends Websocket = Websocket> extends I_WebsocketChannelEntity<T> {
-    limit: number;
-    members: Map<string, I_WebsocketClient>;
-    metadata: Record<string, string>;
-    createdAt: Date;
-    broadcast(message: WebsocketStructuredMessage | string, options?: BroadcastOptions): void;
-    hasMember(client: I_WebsocketEntity | string): boolean;
-    addMember(entity: I_WebsocketClient, options?: AddMemberOptions): AddMemberResult;
-    removeFromMembersMap(entity: I_WebsocketClient): void;
-    removeMember(entity: I_WebsocketEntity, options?: RemoveMemberOptions): I_WebsocketClient | false;
-    getMember(client: I_WebsocketEntity | string): I_WebsocketClient | undefined;
-    getMembers(clients?: string[] | I_WebsocketEntity[]): I_WebsocketClient[];
-    getMetadata(): Record<string, string>;
-    getCreatedAt(): Date;
-    getId(): string;
-    getSize(): number;
-    getLimit(): number;
-    getName(): string;
-    canAddMember(): boolean;
-}
-/**
- * Interface for implementing custom WebSocket behavior.
- *
- * @interface I_WebsocketInterface
- *
- * @property {Function} setup - Initializes the WebSocket handler with channels and clients
- *
- * The interface supports three optional handler methods:
- *
- * - `message`: Custom message handler that replaces the default handler
- * - `open`: Connection handler that runs after the default open handler
- * - `close`: Disconnection handler that runs before the default close handler
- */
-export type WebsocketInterfaceHandlers = Partial<WebSocketHandler<WebsocketEntityData>>;
-/**
- * Interface for implementing custom WebSocket behavior.
- *
- * @interface I_WebsocketInterface
- *
- * @property {Function} setup - Initializes the WebSocket handler with channels and clients
- *
- * The interface supports three optional handler methods:
- *
- * - `message`: Custom message handler that replaces the default handler
- * - `open`: Connection handler that runs after the default open handler
- * - `close`: Disconnection handler that runs before the default close handler
- */
-export interface I_WebsocketInterface {
-    handlers: (channels: WebsocketChannel, clients: WebsocketClients) => WebsocketInterfaceHandlers;
-}

package/dist/server/bun/websocket/websocket.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=websocket.types.js.map

package/dist/server/bun/websocket/websocket.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"websocket.types.js","sourceRoot":"","sources":["../../../../src/server/bun/websocket/websocket.types.ts"],"names":[],"mappings":"","sourcesContent":["import { ServerWebSocket, WebSocketHandler } from \"bun\";\nimport Channel from \"./Channel\";\nimport Websocket from \"./Websocket\";\nimport { E_ClientState } from \"./websocket.enums\";\n\nexport type BunWebsocketMessage = string | Buffer<ArrayBufferLike>;\n\nexport type WebsocketChannel<T extends I_WebsocketChannel = Channel> = Map<string, T>;\nexport type WebsocketClients = Map<string, I_WebsocketClient>;\nexport type WebsocketMessageOptions = {\n\t/**\n\t * Additional data to include in the message content\n\t * If an object is provided, it will be merged with the content\n\t * If a primitive value is provided, it will be added as content.data\n\t */\n\tdata?: any;\n\n\t/**\n\t * Client information to include in the message\n\t * Will be added as content.client\n\t */\n\tclient?: Partial<WebsocketEntityData> & {\n\t\t[key: string]: any;\n\t};\n\n\t/**\n\t * Channel metadata to include in the message\n\t * If true, all metadata will be included\n\t * If an array of strings, only the specified keys will be included\n\t */\n\tincludeMetadata?: boolean | string[];\n\n\t/**\n\t * Client IDs to exclude from receiving the broadcast\n\t * Useful for sending messages to all clients except the sender\n\t */\n\texcludeClients?: string[];\n\n\t/**\n\t * Channel to include in the message\n\t * Defaults to the channel of the message\n\t */\n\tchannel?: string;\n\n\t/**\n\t * Whether to include timestamp in the message\n\t * Defaults to true\n\t */\n\tincludeTimestamp?: boolean;\n\n\t/**\n\t * Custom fields to add to the root of the message\n\t * These will be merged with the message object\n\t */\n\tcustomFields?: Record<string, any>;\n\n\t/**\n\t * Transform function to modify the final message before sending\n\t * This is applied after all other processing\n\t */\n\ttransform?: (message: any) => any;\n\n\t/**\n\t * Priority of the message (higher numbers = higher priority)\n\t * Can be used by clients to determine processing order\n\t */\n\tpriority?: number;\n\n\t/**\n\t * Message expiration time in milliseconds since epoch\n\t * Can be used by clients to ignore outdated messages\n\t */\n\texpiresAt?: number;\n\n\t/**\n\t * Metadata to include in the message\n\t * If an array of strings, only the specified keys will be included\n\t */\n\tmetadata?: boolean | string[] | Record<string, string>;\n};\n\nexport type WebsocketMessage<T extends Record<string, any> = Record<string, any>> = {\n\t/**\n\t * Message type identifier used for client-side routing\n\t */\n\ttype: string;\n\t/**\n\t * Message content - can be any data structure\n\t * If a string is provided, it will be wrapped in {message: string}\n\t */\n\tcontent: T;\n\t/**\n\t * Channel ID\n\t */\n\tchannel?: string;\n\t/**\n\t * Timestamp of the message\n\t */\n\ttimestamp?: string;\n\t/**\n\t * Any additional custom fields\n\t */\n\t[key: string]: any;\n};\n\n/**\n * Message structure sent over the wire to clients.\n * This is the actual WebSocket payload format - transport options are NOT included.\n */\nexport type WebsocketStructuredMessage<T extends Record<string, any> = Record<string, any>> = {\n\t/** Message type identifier for client-side routing */\n\ttype: string;\n\n\t/** Message payload */\n\tcontent: T;\n\n\t/** Channel ID where message originated */\n\tchannel?: string;\n\n\t/** ISO timestamp when message was created */\n\ttimestamp?: string;\n\n\t/** Client information (who sent this) */\n\tclient?: WebsocketEntityData;\n\n\t/** Channel metadata (if included) */\n\tmetadata?: Record<string, string>;\n\n\t/** Message priority for client-side processing */\n\tpriority?: number;\n\n\t/** Expiration timestamp (milliseconds since epoch) */\n\texpiresAt?: number;\n\n\t/** Any additional custom fields */\n\t[key: string]: any;\n};\n\n/**\n * @deprecated This type incorrectly mixed transport options with wire format.\n * Use WebsocketStructuredMessage for wire format and WebsocketMessageOptions for options.\n * This will be removed in a future version.\n */\nexport type deprecated_WebsocketStructuredMessage<T extends Record<string, any> = Record<string, any>> = WebsocketMessage<T> & WebsocketMessageOptions;\n\nexport type WebsocketEntityId = string;\nexport type WebsocketEntityName = string;\nexport type WebsocketEntityData = { id: WebsocketEntityId; name: WebsocketEntityName };\n\nexport interface I_WebsocketEntity extends WebsocketEntityData {\n\tws: ServerWebSocket<WebsocketEntityData>;\n}\n\nexport interface I_WebsocketClient extends I_WebsocketEntity {\n\tchannels: WebsocketChannel<I_WebsocketChannel>;\n\tstate: E_ClientState;\n\tsend(message: string, options?: WebsocketMessageOptions): void;\n\tsend(message: WebsocketStructuredMessage): void;\n\tsubscribe(channel: string): any;\n\ttrackChannel(channel: I_WebsocketChannel): void;\n\tuntrackChannel(channel: I_WebsocketChannel): void;\n\tjoinChannel(channel: I_WebsocketChannel, send?: boolean): { success: boolean; reason: string };\n\tleaveChannel(channel: I_WebsocketChannel, send?: boolean): void;\n\tjoinChannels(channels: I_WebsocketChannel[], send?: boolean): void;\n\tleaveChannels(channels?: I_WebsocketChannel[], send?: boolean): void;\n\tunsubscribe(channel: string): any;\n\twhoami(): WebsocketEntityData;\n\tcanReceiveMessages(): boolean;\n\tmarkConnected(): void;\n\tmarkDisconnecting(): void;\n\tmarkDisconnected(): void;\n\tgetConnectionInfo(): { id: string; name: string; state: E_ClientState; connectedAt?: Date; disconnectedAt?: Date; uptime: number; channelCount: number };\n}\n\nexport interface I_WebsocketChannelEntity<T extends Websocket = Websocket> extends WebsocketEntityData {\n\tws: T;\n}\n\n// New types for the broadcast method\nexport type BroadcastOptions = WebsocketMessageOptions & {\n\tdebug?: boolean;\n};\n\n// Result type for addMember operations\nexport type AddMemberResult = { success: true; client: I_WebsocketClient } | { success: false; reason: \"full\" | \"already_member\" | \"error\"; error?: Error };\n\n// Options for addMember operations\nexport type AddMemberOptions = {\n\t/** Whether to notify client when channel is full (default: false) */\n\tnotify_when_full?: boolean;\n\t/** Whether to send welcome notification to client on successful join (default: false) */\n\tnotify?: boolean;\n};\n\n// Options for removeMember operations\nexport type RemoveMemberOptions = {\n\t/** Whether to send goodbye notification to client on successful leave (default: false) */\n\tnotify?: boolean;\n};\n\nexport interface I_WebsocketChannel<T extends Websocket = Websocket> extends I_WebsocketChannelEntity<T> {\n\tlimit: number;\n\tmembers: Map<string, I_WebsocketClient>;\n\tmetadata: Record<string, string>;\n\tcreatedAt: Date;\n\tbroadcast(message: WebsocketStructuredMessage | string, options?: BroadcastOptions): void;\n\thasMember(client: I_WebsocketEntity | string): boolean;\n\taddMember(entity: I_WebsocketClient, options?: AddMemberOptions): AddMemberResult;\n\tremoveFromMembersMap(entity: I_WebsocketClient): void;\n\tremoveMember(entity: I_WebsocketEntity, options?: RemoveMemberOptions): I_WebsocketClient | false;\n\tgetMember(client: I_WebsocketEntity | string): I_WebsocketClient | undefined;\n\tgetMembers(clients?: string[] | I_WebsocketEntity[]): I_WebsocketClient[];\n\tgetMetadata(): Record<string, string>;\n\tgetCreatedAt(): Date;\n\tgetId(): string;\n\tgetSize(): number;\n\tgetLimit(): number;\n\tgetName(): string;\n\tcanAddMember(): boolean;\n}\n\n/**\n * Interface for implementing custom WebSocket behavior.\n *\n * @interface I_WebsocketInterface\n *\n * @property {Function} setup - Initializes the WebSocket handler with channels and clients\n *\n * The interface supports three optional handler methods:\n *\n * - `message`: Custom message handler that replaces the default handler\n * - `open`: Connection handler that runs after the default open handler\n * - `close`: Disconnection handler that runs before the default close handler\n */\nexport type WebsocketInterfaceHandlers = Partial<WebSocketHandler<WebsocketEntityData>>;\n\n/**\n * Interface for implementing custom WebSocket behavior.\n *\n * @interface I_WebsocketInterface\n *\n * @property {Function} setup - Initializes the WebSocket handler with channels and clients\n *\n * The interface supports three optional handler methods:\n *\n * - `message`: Custom message handler that replaces the default handler\n * - `open`: Connection handler that runs after the default open handler\n * - `close`: Disconnection handler that runs before the default close handler\n */\nexport interface I_WebsocketInterface {\n\thandlers: (channels: WebsocketChannel, clients: WebsocketClients) => WebsocketInterfaceHandlers;\n}\n"]}

package/dist/server/controller.d.ts

@@ -1,62 +0,0 @@
-import Initializable, { InitializableOptions } from "../initializable";
-import { I_ApplicationResponse } from "../types";
-export type ControllerResponse<T = unknown> = Promise<I_ApplicationResponse<T> | PromiseLike<I_ApplicationResponse<T>>>;
-export type ControllerAction<T> = (req: Request) => ControllerResponse<T>;
-export type ControllerMap<T = unknown> = Map<string, ControllerAction<T>>;
-export type ControllerOptions<T = unknown> = InitializableOptions & {
-    path: string | undefined;
-    post: Map<string, ControllerAction<T>>;
-    get: ControllerMap<T>;
-    controllerMap: Map<string, ControllerMap<T>>;
-};
-export default abstract class Controller extends Initializable {
-    path: string | undefined;
-    post: Map<string, ControllerAction<any>>;
-    get: ControllerMap;
-    controllerMap: Map<string, ControllerMap>;
-    constructor();
-    static Create<T>(this: new () => T): T;
-    static AsyncCreate<T>(this: new () => T): Promise<T>;
-    call<T>(request: Request): Promise<T>;
-    success<T>(data: T, after_action?: () => void | Promise<void>): I_ApplicationResponse<T>;
-    failure<T>(data: T, after_action?: () => void | Promise<void>): I_ApplicationResponse<T>;
-    private setControllerMap;
-    private resolve;
-    private resolveAction;
-    /**
-     * Abstract method that needs to be implemented in derived classes.
-     * This method is used to map post actions to their corresponding handler methods.
-     *
-     * Each action is a string that represents a specific operation, and the handler is a function that performs this operation.
-     * The handler is bound to the current context (`this`) to ensure it has access to the class's properties and methods.
-     *
-     * Example implementation:
-     *
-     * ```typescript
-     * setActionsMap() {
-     *     this.post.set("action", this.controllerMethod.bind(this));
-     * }
-     * ```
-     *
-     * In this example, when "https://webserver_url:port/controller/action" is called by the router, the `controllerMethod` method will be called.
-     */
-    abstract POST(): void;
-    /**
-     * Abstract method that needs to be implemented in derived classes.
-     * This method is used to map actions to their corresponding handler methods.
-     *
-     * Each action is a string that represents a specific operation, and the handler is a function that performs this operation.
-     * The handler is bound to the current context (`this`) to ensure it has access to the class's properties and methods.
-     *
-     * Example implementation:
-     *
-     * ```typescript
-     * setActionsMap() {
-     *     this.get.set("action", this.controllerMethod.bind(this));
-     * }
-     * ```
-     *
-     * In this example, when "https://webserver_url:port/controller/action" is called by the router, the `controllerMethod` method will be called.
-     */
-    abstract GET(): void;
-}

package/dist/server/controller.js

@@ -1,55 +0,0 @@
-import { ERROR_CODE } from "../errors.js";
-import Initializable from "../initializable.js";
-import { Guards } from "../utils/index.js";
-export default class Controller extends Initializable {
-    constructor() {
-        super();
-        this.post = new Map();
-        this.get = new Map();
-        this.controllerMap = new Map();
-        this.POST();
-        this.GET();
-        this.setControllerMap();
-    }
-    static Create() {
-        return new this();
-    }
-    static async AsyncCreate() {
-        return new this();
-    }
-    async call(request) {
-        await this.isInitialized();
-        const action = this.resolve(request);
-        return await action(request);
-    }
-    success(data, after_action) {
-        return { status: true, data, after_action };
-    }
-    failure(data, after_action) {
-        return { status: false, data, after_action };
-    }
-    setControllerMap() {
-        this.controllerMap.set("GET", this.get);
-        this.controllerMap.set("POST", this.post);
-    }
-    resolve(req) {
-        const url = new URL(req.url);
-        const endpointArray = url.pathname.split("/");
-        const actionName = endpointArray.slice(2).join("/");
-        if (!Guards.IsString(actionName, true))
-            throw ERROR_CODE.INVALID_ACTION;
-        const methodMap = this.controllerMap.get(req.method);
-        if (Guards.IsNil(methodMap)) {
-            throw ERROR_CODE.INVALID_METHOD;
-        }
-        return this.resolveAction(methodMap, actionName);
-    }
-    resolveAction(methodMap, actionName) {
-        const action = methodMap.get(actionName);
-        if (!Guards.IsFunction(action, true)) {
-            throw ERROR_CODE.NO_ACTION_IN_MAP;
-        }
-        return action;
-    }
-}
-//# sourceMappingURL=controller.js.map

package/dist/server/controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/server/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,aAAuC,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAclC,MAAM,CAAC,OAAO,OAAgB,UAAW,SAAQ,aAAa;IAM7D;QACC,KAAK,EAAE,CAAC;QALT,SAAI,GAAuC,IAAI,GAAG,EAAE,CAAC;QACrD,QAAG,GAAkB,IAAI,GAAG,EAAE,CAAC;QAC/B,kBAAa,GAA+B,IAAI,GAAG,EAAE,CAAC;QAIrD,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzB,CAAC;IAEM,MAAM,CAAC,MAAM;QACnB,OAAO,IAAI,IAAI,EAAE,CAAC;IACnB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,WAAW;QAC9B,OAAO,IAAI,IAAI,EAAE,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAI,OAAgB;QACpC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEM,OAAO,CAAI,IAAO,EAAE,YAAyC;QACnE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC7C,CAAC;IAEM,OAAO,CAAI,IAAO,EAAE,YAAyC;QACnE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9C,CAAC;IAEO,gBAAgB;QACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAEO,OAAO,CAAC,GAAY;QAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;YAAE,MAAM,UAAU,CAAC,cAAc,CAAC;QAExE,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAErD,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,CAAC,cAAc,CAAC;QACjC,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAEO,aAAa,CAAC,SAAwB,EAAE,UAAkB;QACjE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAa,CAAC;QAErD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,UAAU,CAAC,gBAAgB,CAAC;QACnC,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;CAuCD","sourcesContent":["import { ERROR_CODE } from \"../errors\";\nimport Initializable, { InitializableOptions } from \"../initializable\";\nimport { I_ApplicationResponse } from \"../types\";\nimport { Guards } from \"../utils\";\n\nexport type ControllerResponse<T = unknown> = Promise<I_ApplicationResponse<T> | PromiseLike<I_ApplicationResponse<T>>>;\nexport type ControllerAction<T> = (req: Request) => ControllerResponse<T>;\n\nexport type ControllerMap<T = unknown> = Map<string, ControllerAction<T>>;\n\nexport type ControllerOptions<T = unknown> = InitializableOptions & {\n\tpath: string | undefined;\n\tpost: Map<string, ControllerAction<T>>;\n\tget: ControllerMap<T>;\n\tcontrollerMap: Map<string, ControllerMap<T>>;\n};\n\nexport default abstract class Controller extends Initializable {\n\tpath: string | undefined;\n\tpost: Map<string, ControllerAction<any>> = new Map();\n\tget: ControllerMap = new Map();\n\tcontrollerMap: Map<string, ControllerMap> = new Map();\n\n\tconstructor() {\n\t\tsuper();\n\t\tthis.POST();\n\t\tthis.GET();\n\t\tthis.setControllerMap();\n\t}\n\n\tpublic static Create<T>(this: new () => T): T {\n\t\treturn new this();\n\t}\n\n\tpublic static async AsyncCreate<T>(this: new () => T): Promise<T> {\n\t\treturn new this();\n\t}\n\n\tpublic async call<T>(request: Request): Promise<T> {\n\t\tawait this.isInitialized();\n\t\tconst action = this.resolve(request);\n\t\treturn await action(request);\n\t}\n\n\tpublic success<T>(data: T, after_action?: () => void | Promise<void>): I_ApplicationResponse<T> {\n\t\treturn { status: true, data, after_action };\n\t}\n\n\tpublic failure<T>(data: T, after_action?: () => void | Promise<void>): I_ApplicationResponse<T> {\n\t\treturn { status: false, data, after_action };\n\t}\n\n\tprivate setControllerMap() {\n\t\tthis.controllerMap.set(\"GET\", this.get);\n\t\tthis.controllerMap.set(\"POST\", this.post);\n\t}\n\n\tprivate resolve(req: Request): Function {\n\t\tconst url = new URL(req.url);\n\t\tconst endpointArray = url.pathname.split(\"/\");\n\t\tconst actionName = endpointArray.slice(2).join(\"/\");\n\n\t\tif (!Guards.IsString(actionName, true)) throw ERROR_CODE.INVALID_ACTION;\n\n\t\tconst methodMap = this.controllerMap.get(req.method);\n\n\t\tif (Guards.IsNil(methodMap)) {\n\t\t\tthrow ERROR_CODE.INVALID_METHOD;\n\t\t}\n\n\t\treturn this.resolveAction(methodMap, actionName);\n\t}\n\n\tprivate resolveAction(methodMap: ControllerMap, actionName: string) {\n\t\tconst action = methodMap.get(actionName) as Function;\n\n\t\tif (!Guards.IsFunction(action, true)) {\n\t\t\tthrow ERROR_CODE.NO_ACTION_IN_MAP;\n\t\t}\n\n\t\treturn action;\n\t}\n\n\t/**\n\t * Abstract method that needs to be implemented in derived classes.\n\t * This method is used to map post actions to their corresponding handler methods.\n\t *\n\t * Each action is a string that represents a specific operation, and the handler is a function that performs this operation.\n\t * The handler is bound to the current context (`this`) to ensure it has access to the class's properties and methods.\n\t *\n\t * Example implementation:\n\t *\n\t * ```typescript\n\t * setActionsMap() {\n\t *     this.post.set(\"action\", this.controllerMethod.bind(this));\n\t * }\n\t * ```\n\t *\n\t * In this example, when \"https://webserver_url:port/controller/action\" is called by the router, the `controllerMethod` method will be called.\n\t */\n\tabstract POST(): void;\n\n\t/**\n\t * Abstract method that needs to be implemented in derived classes.\n\t * This method is used to map actions to their corresponding handler methods.\n\t *\n\t * Each action is a string that represents a specific operation, and the handler is a function that performs this operation.\n\t * The handler is bound to the current context (`this`) to ensure it has access to the class's properties and methods.\n\t *\n\t * Example implementation:\n\t *\n\t * ```typescript\n\t * setActionsMap() {\n\t *     this.get.set(\"action\", this.controllerMethod.bind(this));\n\t * }\n\t * ```\n\t *\n\t * In this example, when \"https://webserver_url:port/controller/action\" is called by the router, the `controllerMethod` method will be called.\n\t */\n\tabstract GET(): void;\n}\n"]}

package/dist/server/index.d.ts

@@ -1,4 +0,0 @@
-export * from './controller';
-export * from './service';
-export { default as Controller } from './controller';
-export { default as Service } from './service';

package/dist/server/index.js

@@ -1,7 +0,0 @@
-// This file is auto-generated by scripts/generate-indexes.ts
-// Do not edit this file directly
-export * from './controller.js';
-export * from './service.js';
-export { default as Controller } from './controller.js';
-export { default as Service } from './service.js';
-//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,iCAAiC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,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 './controller';\nexport * from './service';\nexport { default as Controller } from './controller';\nexport { default as Service } from './service';\n"]}

package/dist/server/service.d.ts

@@ -1,5 +0,0 @@
-import Initializable from "../initializable";
-export default abstract class Service extends Initializable {
-    validateRequestBody<T>(request: Request, keys: (keyof T)[]): Promise<T>;
-    static validateRequestBody<T>(request: Request, keys: (keyof T)[]): Promise<T>;
-}

package/dist/server/service.js

@@ -1,38 +0,0 @@
-import { ERROR_CODE } from "../errors.js";
-import Initializable from "../initializable.js";
-import { Guards } from "../utils/index.js";
-export default class Service extends Initializable {
-    async validateRequestBody(request, keys) {
-        return await Service.validateRequestBody(request, keys);
-    }
-    static async validateRequestBody(request, keys) {
-        try {
-            let body;
-            try {
-                body = await request.json();
-            }
-            catch (e) {
-                body = await request.text();
-                const cleanedBody = body
-                    .replace(/\/\/.*$/gm, "") // Remove comments
-                    .replace(/\n/g, "") // Remove newlines
-                    .replace(/\s+/g, " ") // Replace multiple spaces with single space
-                    .trim(); // Remove leading/trailing whitespace
-                body = JSON.parse(cleanedBody);
-            }
-            if (Guards.IsNil(body))
-                throw ERROR_CODE.REQ_BODY_EMPTY;
-            if (!Guards.IsType(body, keys)) {
-                console.error(`Expected keys: ${keys.join(", ")}`);
-                throw ERROR_CODE.INVALID_METHOD_INPUT;
-            }
-            return body;
-        }
-        catch (e) {
-            if (e instanceof Error || e instanceof SyntaxError)
-                throw "Could not parse request body: " + e;
-            throw e;
-        }
-    }
-}
-//# sourceMappingURL=service.js.map

package/dist/server/service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/server/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,OAAO,OAAgB,OAAQ,SAAQ,aAAa;IAC1D,KAAK,CAAC,mBAAmB,CAAI,OAAgB,EAAE,IAAiB;QAC/D,OAAO,MAAM,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAI,OAAgB,EAAE,IAAiB;QACtE,IAAI,CAAC;YACJ,IAAI,IAAI,CAAC;YACT,IAAI,CAAC;gBACJ,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,WAAW,GAAG,IAAI;qBACtB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,kBAAkB;qBAC3C,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,kBAAkB;qBACrC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,4CAA4C;qBACjE,IAAI,EAAE,CAAC,CAAC,qCAAqC;gBAE/C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,MAAM,UAAU,CAAC,cAAc,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAI,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACnD,MAAM,UAAU,CAAC,oBAAoB,CAAC;YACvC,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY,WAAW;gBAAE,MAAM,gCAAgC,GAAG,CAAC,CAAC;YAC/F,MAAM,CAAC,CAAC;QACT,CAAC;IACF,CAAC;CACD","sourcesContent":["import { ERROR_CODE } from \"../errors\";\nimport Initializable from \"../initializable\";\nimport { Guards } from \"../utils\";\n\nexport default abstract class Service extends Initializable {\n\tasync validateRequestBody<T>(request: Request, keys: (keyof T)[]): Promise<T> {\n\t\treturn await Service.validateRequestBody(request, keys);\n\t}\n\n\tstatic async validateRequestBody<T>(request: Request, keys: (keyof T)[]): Promise<T> {\n\t\ttry {\n\t\t\tlet body;\n\t\t\ttry {\n\t\t\t\tbody = await request.json();\n\t\t\t} catch (e) {\n\t\t\t\tbody = await request.text();\n\t\t\t\tconst cleanedBody = body\n\t\t\t\t\t.replace(/\\/\\/.*$/gm, \"\") // Remove comments\n\t\t\t\t\t.replace(/\\n/g, \"\") // Remove newlines\n\t\t\t\t\t.replace(/\\s+/g, \" \") // Replace multiple spaces with single space\n\t\t\t\t\t.trim(); // Remove leading/trailing whitespace\n\n\t\t\t\tbody = JSON.parse(cleanedBody);\n\t\t\t}\n\t\t\tif (Guards.IsNil(body)) throw ERROR_CODE.REQ_BODY_EMPTY;\n\t\t\tif (!Guards.IsType<T>(body, keys)) {\n\t\t\t\tconsole.error(`Expected keys: ${keys.join(\", \")}`);\n\t\t\t\tthrow ERROR_CODE.INVALID_METHOD_INPUT;\n\t\t\t}\n\t\t\treturn body;\n\t\t} catch (e) {\n\t\t\tif (e instanceof Error || e instanceof SyntaxError) throw \"Could not parse request body: \" + e;\n\t\t\tthrow e;\n\t\t}\n\t}\n}\n"]}

package/dist/utils/BaseDto.d.ts

@@ -1,33 +0,0 @@
-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 (infers class from `this`)
-     * @param data - Data to create the DTO from
-     * @param options - Class transformer options
-     * @returns New instance of the DTO
-     */
-    static Create<T extends Dto>(this: ClassConstructor<T>, data: Record<string, unknown>, options?: ClassTransformOptions): T;
-    /**
-     * Creates an array of DTOs from an array of plain objects
-     */
-    static CreateMany<T extends Dto>(this: ClassConstructor<T>, dataArray: Record<string, unknown>[], options?: ClassTransformOptions): T[];
-}

package/dist/utils/BaseDto.js

@@ -1,69 +0,0 @@
-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 (infers class from `this`)
-     * @param data - Data to create the DTO from
-     * @param options - Class transformer options
-     * @returns New instance of the DTO
-     */
-    static Create(data, options = {}) {
-        const instance = plainToInstance(this, data, {
-            ...Dto.defaultTransformOptions,
-            ...options,
-        });
-        return instance;
-    }
-    /**
-     * Creates an array of DTOs from an array of plain objects
-     */
-    static CreateMany(dataArray, options = {}) {
-        return plainToInstance(this, dataArray, {
-            ...Dto.defaultTransformOptions,
-            ...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

@@ -1 +0,0 @@
-{"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;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAA2C,IAA6B,EAAE,UAAiC,EAAE;QAChI,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE;YAC5C,GAAG,GAAG,CAAC,uBAAuB;YAC9B,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAU,CAA2C,SAAoC,EAAE,UAAiC,EAAE;QAC3I,OAAO,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE;YACvC,GAAG,GAAG,CAAC,uBAAuB;YAC9B,GAAG,OAAO;SACV,CAAQ,CAAC;IACX,CAAC;;AAlED;;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 (infers class from `this`)\n\t * @param data - Data to create the DTO from\n\t * @param options - Class transformer options\n\t * @returns New instance of the DTO\n\t */\n\tpublic static Create<T extends Dto>(this: ClassConstructor<T>, data: Record<string, unknown>, options: ClassTransformOptions = {}): T {\n\t\tconst instance = plainToInstance(this, 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 */\n\tpublic static CreateMany<T extends Dto>(this: ClassConstructor<T>, dataArray: Record<string, unknown>[], options: ClassTransformOptions = {}): T[] {\n\t\treturn plainToInstance(this, dataArray, {\n\t\t\t...Dto.defaultTransformOptions,\n\t\t\t...options,\n\t\t}) as T[];\n\t}\n}\n"]}

package/dist/utils/BaseEntity.d.ts

@@ -1,31 +0,0 @@
-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;
-    /**
-     * 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;
-    /**
-     * Creates a new entity instance from DTO (infers class from `this`)
-     *
-     * NOTE: This is a BASE implementation that uses plainToInstance.
-     * Derived classes should override if they need custom construction logic.
-     *
-     * @param dto - DTO to create entity from
-     */
-    static FromDto<T extends BaseEntity>(this: ClassConstructor<T>, dto: Dto): T;
-    /**
-     * Creates multiple entities from DTOs
-     */
-    static FromDtos<T extends BaseEntity>(this: ClassConstructor<T>, dtos: Dto[]): T[];
-}

package/dist/utils/BaseEntity.js

@@ -1,37 +0,0 @@
-import { instanceToPlain, plainToInstance } from "class-transformer";
-export default class BaseEntity {
-    /**
-     * Converts entity to plain object
-     */
-    toJSON() {
-        return instanceToPlain(this);
-    }
-    /**
-     * 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;
-    }
-    /**
-     * Creates a new entity instance from DTO (infers class from `this`)
-     *
-     * NOTE: This is a BASE implementation that uses plainToInstance.
-     * Derived classes should override if they need custom construction logic.
-     *
-     * @param dto - DTO to create entity from
-     */
-    static FromDto(dto) {
-        const instance = plainToInstance(this, dto.toJSON());
-        return instance;
-    }
-    /**
-     * Creates multiple entities from DTOs
-     */
-    static FromDtos(dtos) {
-        return plainToInstance(this, dtos.map((dto) => dto.toJSON()));
-    }
-}
-//# sourceMappingURL=BaseEntity.js.map

package/dist/utils/BaseEntity.js.map

@@ -1 +0,0 @@
-{"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;;;;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;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,OAAO,CAAkD,GAAQ;QAC9E,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,CAAkD,IAAW;QAClF,OAAO,eAAe,CACrB,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAC/B,CAAC;IACH,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 * 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\t/**\n\t * Creates a new entity instance from DTO (infers class from `this`)\n\t *\n\t * NOTE: This is a BASE implementation that uses plainToInstance.\n\t * Derived classes should override if they need custom construction logic.\n\t *\n\t * @param dto - DTO to create entity from\n\t */\n\tpublic static FromDto<T extends BaseEntity>(this: ClassConstructor<T>, dto: Dto): T {\n\t\tconst instance = plainToInstance(this, dto.toJSON());\n\t\treturn instance;\n\t}\n\n\t/**\n\t * Creates multiple entities from DTOs\n\t */\n\tpublic static FromDtos<T extends BaseEntity>(this: ClassConstructor<T>, dtos: Dto[]): T[] {\n\t\treturn plainToInstance(\n\t\t\tthis,\n\t\t\tdtos.map((dto) => dto.toJSON()),\n\t\t);\n\t}\n}\n"]}