topsyde-utils 1.3.1 → 2.0.0

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/src/application.ts

@@ -1,73 +0,0 @@
-import { I_ApplicationResponse } from "./types";
-
-export const RESPONSE_INIT = (status?: number, headers?: HeadersInit): ResponseInit => {
-	return {
-		status: status ?? 200,
-		headers: HEADERS_INIT(headers),
-	};
-};
-
-export const HEADERS_INIT = (headers?: HeadersInit): HeadersInit => {
-	return {
-		"Access-Control-Allow-Origin": "*", // Specific origin
-		"Content-Type": "application/json",
-		"Access-Control-Allow-Methods": "GET, POST, OPTIONS, PUT, DELETE",
-		"Access-Control-Allow-Headers": "Content-Type, Authorization, X-Requested-With, Origin, Accept",
-		"Access-Control-Allow-Credentials": "true",
-		"Access-Control-Max-Age": "86400", // 24 hours
-		...headers,
-	};
-};
-
-export const RESPONSE_METHOD_OPTIONS = {
-	name: "Access-Control-Max-Age",
-	value: "86400",
-};
-
-function isApplicationResponse<T>(data: T | I_ApplicationResponse<T>): data is I_ApplicationResponse<T> {
-	return typeof data === "object" && data !== null && "status" in data;
-}
-
-class Application {
-	public static Response<T>(
-		data: T | I_ApplicationResponse<T>,
-		options?: { after_action?: () => void | Promise<void>; before_action?: () => void },
-		status = 200,
-		headers?: HeadersInit,
-	): Response {
-		const { after_action, before_action } = options || {};
-		Application.BeforeAction(before_action);
-		const response = isApplicationResponse(data) ? data : { status: true, data };
-		const output = Response.json(response, RESPONSE_INIT(status, headers));
-		Application.AfterAction(after_action);
-		return output;
-	}
-
-	private static AfterAction(after_action?: () => void | Promise<void>) {
-		if (after_action) {
-			queueMicrotask(async () => {
-				try {
-					await after_action();
-				} catch (error) {
-					console.error("[Application] After-action error:", error);
-				}
-			});
-		}
-	}
-
-	private static BeforeAction(before_action?: () => void) {
-		if (before_action) before_action();
-	}
-
-	public static Error<T extends BodyInit | unknown | Error>(error: T | I_ApplicationResponse<T>, status = 200, headers?: HeadersInit): Response {
-		const response = isApplicationResponse(error) ? error : { status: false, data: error, error };
-		return Response.json(response, RESPONSE_INIT(status, headers));
-	}
-
-	public static Throw<T extends BodyInit | unknown | Error>(error: T | I_ApplicationResponse<T>, status = 400, headers?: HeadersInit): Response {
-		const response = isApplicationResponse(error) ? error : { status: false, data: error, error };
-		return Response.json(response, RESPONSE_INIT(status, headers));
-	}
-}
-
-export default Application;

package/src/server/base/base.database.ts

@@ -1,31 +0,0 @@
-import Singleton from "../../singleton";
-
-abstract class Database extends Singleton {
-	constructor() {
-		super();
-	}
-
-	public abstract connect(): Promise<void>;
-	public abstract disconnect(): Promise<void>;
-
-	protected connected: boolean = false;
-	protected processing: boolean = false;
-
-	public static async Connection<T extends (new (...args: any[]) => Database) & typeof Singleton>(
-		this: T,
-		...args: ConstructorParameters<T>
-	): Promise<InstanceType<T>> {
-		try {
-			const instance = this.GetInstance(...args) as InstanceType<T>;
-			if (!instance.connected && !instance.processing) {
-				await instance.connect();
-			}
-			return instance;
-		} catch (e) {
-			console.error(e);
-			throw e;
-		}
-	}
-}
-
-export default Database;

package/src/server/base/index.ts

@@ -1,5 +0,0 @@
-// This file is auto-generated by scripts/generate-indexes.ts
-// Do not edit this file directly
-
-export * from './base.database';
-export { default as Database } from './base.database';

package/src/server/bun/index.ts

@@ -1,6 +0,0 @@
-// This file is auto-generated by scripts/generate-indexes.sh
-// Do not edit this file directly
-
-export * from './websocket/Websocket';
-export { default as Websocket } from './websocket/Websocket';
-export * from './websocket';