topsyde-utils 1.0.149 → 1.0.151

package/src/client/rxjs/useRxjs.ts

@@ -0,0 +1,111 @@
+import { Subscription } from "rxjs";
+import { computed, onBeforeUnmount, onMounted, ref } from "vue";
+import { Rxjs, RxjsNamespaces, I_RxjsPayload } from "./rxjs";
+import { Guards, Lib } from "../../utils";
+
+export type RxjsDataType = string | Record<string, any>;
+type NamespaceActions = Record<string, Function>;
+type MultiNamespaceActions<T extends string> = Partial<Record<RxjsNamespaces<T>, NamespaceActions>>;
+
+export const useRxjs = <T extends string>(
+	_namespace: RxjsNamespaces<T> | RxjsNamespaces<T>[],
+	actions?: NamespaceActions | MultiNamespaceActions<T>,
+	options?: { static_instance: boolean },
+) => {
+	const subs = ref<Map<RxjsNamespaces<T>, Subscription>>(new Map());
+	const _actions = ref(actions);
+	const instance = Rxjs.GetInstance<Rxjs<T>>();
+	const namespaces = ref<RxjsNamespaces<T>[]>(Guards.IsArray(_namespace) ? _namespace : [_namespace]);
+
+	namespaces.value.forEach((ns) => {
+		if (instance.has(ns)) return;
+		console.log("Creating namespace", ns);
+		instance.create(ns);
+	});
+
+	function _getAction(cta: string, ns: RxjsNamespaces<T>) {
+		if (Guards.IsArray(_namespace)) return _actions.value?.[ns]?.[cta];
+		return _actions.value?.[cta];
+	}
+
+	function $next(namespace: RxjsNamespaces<T>, payload: I_RxjsPayload<any>): void;
+	function $next(cta: string, data: RxjsDataType): void;
+	function $next(firstParam: RxjsNamespaces<T> | string, secondParam: I_RxjsPayload<RxjsDataType> | any): void {
+		if (typeof firstParam !== "string" && secondParam && typeof secondParam === "object" && "cta" in secondParam && "data" in secondParam) {
+			const ns = firstParam;
+			const payload: I_RxjsPayload<any> = secondParam;
+			instance.next(ns, payload);
+			return;
+		}
+
+		const cta = firstParam as string;
+		const data = secondParam as RxjsDataType;
+		const namespaces = Guards.IsArray(_namespace) ? _namespace : [_namespace];
+		namespaces.forEach((ns) => {
+			instance.next(ns, { cta, data });
+		});
+	}
+
+	function $clear(namespace: RxjsNamespaces<T>) {
+		instance.clear(namespace);
+	}
+
+	function $subscribe(actions: NamespaceActions | MultiNamespaceActions<T>) {
+		_actions.value = actions;
+		$unsubscribe(); // Clear existing subscriptions
+
+		const namespaces = Guards.IsArray(_namespace) ? _namespace : [_namespace];
+
+		namespaces.forEach((ns) => {
+			if (!instance.namespaces.has(ns)) {
+				Lib.Warn(`Rxjs namespace ${ns} does not exist`);
+				return;
+			}
+
+			if (subs.value.has(ns)) return;
+
+			subs.value.set(
+				ns,
+				instance.subscribe(ns, ({ cta, data }) => {
+					const action = _getAction(cta, ns) || (() => {});
+					action(data);
+				}),
+			);
+		});
+	}
+
+	function $unsubscribe() {
+		subs.value.forEach((sub) => sub.unsubscribe());
+		subs.value.clear();
+	}
+
+	function $mount() {
+		if (subs.value.size > 0 || !actions) return;
+		$subscribe(actions);
+	}
+
+	function $unmount() {
+		$unsubscribe();
+	}
+
+	if (!options?.static_instance) {
+		onMounted(() => {
+			$mount();
+		});
+	}
+
+	if (!options?.static_instance) {
+		onBeforeUnmount(() => {
+			$unmount();
+		});
+	}
+
+	return {
+		$next,
+		$clear,
+		$subscribe,
+		$unsubscribe,
+		$mount,
+		$unmount,
+	};
+};

package/src/client/vite/plugins/index.ts

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

package/src/client/vite/plugins/topsydeUtilsVitePlugin.ts

@@ -0,0 +1,80 @@
+import type { Plugin } from "vite";
+
+/**
+ * Creates a Vite plugin that provides compatibility for topsyde-utils in browser environments
+ * by disabling sourcemaps and providing mock implementations of Node.js modules.
+ * 
+ * @returns A single Vite plugin with all necessary functionality
+ */
+export function TopsydeUtilsVitePlugin(): Plugin {
+	return {
+		name: "topsyde-utils-compatibility",
+
+		// Disable sourcemaps for topsyde-utils
+		transform(code, id) {
+			if (id.includes("node_modules/topsyde-utils")) {
+				return {
+					code,
+					map: { mappings: "" }, // Return empty sourcemap
+				};
+			}
+		},
+
+		// Handle virtual modules for Node.js built-ins
+		resolveId(id) {
+			if (id === "virtual:path" || id === "virtual:fs") {
+				return id;
+			}
+			return null;
+		},
+
+		// Provide virtual module implementations
+		load(id) {
+			if (id === "virtual:path") {
+				return `
+          export function join() { return ''; }
+          export function resolve() { return ''; }
+          export function dirname() { return ''; }
+          export function basename() { return ''; }
+          export function extname() { return ''; }
+          export default { join, resolve, dirname, basename, extname };
+        `;
+			}
+			if (id === "virtual:fs") {
+				return `
+          export function readFileSync() { return ''; }
+          export function existsSync() { return false; }
+          export function writeFileSync() { return null; }
+          export function readdirSync() { return []; }
+          export function statSync() { 
+            return { 
+              isDirectory: () => false,
+              isFile: () => true
+            }; 
+          }
+          export default { readFileSync, existsSync, writeFileSync, readdirSync, statSync };
+        `;
+			}
+			return null;
+		},
+
+		// Configure aliases and optimization
+		config() {
+			return {
+				resolve: {
+					alias: {
+						// Alias Node.js built-ins to virtual modules
+						path: "virtual:path",
+						fs: "virtual:fs",
+					},
+				},
+				optimizeDeps: {
+					exclude: ["topsyde-utils"],
+				},
+			};
+		},
+	};
+}
+
+// Export as default for compatibility with different import styles
+export default TopsydeUtilsVitePlugin;

package/src/consts.ts

@@ -0,0 +1,48 @@
+export const DEFAULT_FALSE_RESPONSE = "Something went wrong. Please try again later.";
+
+export const LOG_COLORS = {
+	reset: "\x1b[0m",
+	bright: "\x1b[1m",
+	dim: "\x1b[2m",
+	underscore: "\x1b[4m",
+	blink: "\x1b[5m",
+	reverse: "\x1b[7m",
+	hidden: "\x1b[8m",
+
+	text: {
+		black: "\x1b[30m",
+		red: "\x1b[31m",
+		green: "\x1b[32m",
+		yellow: "\x1b[33m",
+		blue: "\x1b[34m",
+		magenta: "\x1b[35m",
+		cyan: "\x1b[36m",
+		white: "\x1b[37m",
+	},
+	bg: {
+		black: "\x1b[40m",
+		red: "\x1b[41m",
+		green: "\x1b[42m",
+		yellow: "\x1b[43m",
+		blue: "\x1b[44m",
+		magenta: "\x1b[45m",
+		cyan: "\x1b[46m",
+		white: "\x1b[47m",
+	},
+};
+
+export const LOG_ICONS = {
+	info: 'ℹ️',
+	success: '✅',
+	warning: '⚠️',
+	error: '❌',
+	debug: '🔍',
+	arrow: '➜',
+	bullet: '•',
+	star: '★',
+	heart: '❤️',
+	rocket: '🚀',
+	fire: '🔥',
+	dice: '🎲',
+	bunny: '🐰',
+};

package/src/enums.ts

@@ -0,0 +1,14 @@
+export enum E_IS {
+	ARRAY = "array",
+	OBJECT = "object",
+	FUNCTION = "function",
+	STRING = "string",
+	NUMBER = "number",
+	BOOLEAN = "boolean",
+	REGEX = "regex",
+}
+
+export enum E_ENVIRONMENTS {
+	DEV = "development",
+	PROD = "production",
+}

package/src/errors.ts

@@ -0,0 +1,56 @@
+// Error code enums
+export enum ERROR_CODE {
+	NO_REQUEST = -1,
+	UNKNOWN_ERROR = 0,
+	INVALID_METHOD = 1,
+	INVALID_REQUEST = 2,
+	INVALID_CONTROLLER = 3,
+	INVALID_ACTION = 4,
+	NO_ACTION_IN_MAP = 5,
+	NO_METHOD_HANDLER = 6,
+	INVALID_METHOD_INPUT = 7,
+	REQ_BODY_EMPTY = 8,
+}
+
+export enum HTTP_ERROR_CODE {
+	OK = 200,
+	BAD_REQUEST = 400,
+	UNAUTHORIZED = 401,
+	FORBIDDEN = 403,
+	NOT_FOUND = 404,
+	INTERNAL_SERVER_ERROR = 500,
+}
+
+/**
+ * WebSocket close event codes
+ * 
+ * Standard codes (1000-1999):
+ * - 1000-1015: Reserved for the WebSocket protocol
+ * 
+ * Application-specific codes:
+ * - 4000-4999: Reserved for application use
+ */
+export enum WS_ERROR_CODE {
+	// Standard WebSocket close codes (1000-1015)
+	NORMAL_CLOSURE = 1000,        // Normal closure; the connection successfully completed whatever purpose for which it was created
+	GOING_AWAY = 1001,            // The endpoint is going away (server shutdown or browser navigating away)
+	PROTOCOL_ERROR = 1002,        // Protocol error
+	UNSUPPORTED_DATA = 1003,      // Received data of a type it cannot accept (e.g., text-only endpoint received binary data)
+	NO_STATUS_RECEIVED = 1005,    // No status code was provided even though one was expected
+	ABNORMAL_CLOSURE = 1006,      // Connection was closed abnormally (e.g., without sending or receiving a Close control frame)
+	INVALID_FRAME_PAYLOAD_DATA = 1007, // Received data that was not consistent with the type of the message
+	POLICY_VIOLATION = 1008,      // Policy violation
+	MESSAGE_TOO_BIG = 1009,       // Message was too big and was rejected
+	MISSING_EXTENSION = 1010,     // Client expected the server to negotiate one or more extension, but server didn't
+	INTERNAL_ERROR = 1011,        // Server encountered an unexpected condition that prevented it from fulfilling the request
+	SERVICE_RESTART = 1012,       // Server is restarting
+	TRY_AGAIN_LATER = 1013,       // Server is too busy or the client is rate-limited
+	BAD_GATEWAY = 1014,           // Gateway or proxy received an invalid response from the upstream server
+	TLS_HANDSHAKE = 1015,         // TLS handshake failure
+	
+	// Application-specific codes (4000-4999)
+	// Add your application-specific codes here as needed
+	// Example:
+	APP_AUTHENTICATION_FAILED = 4000,
+	APP_INVALID_MESSAGE_FORMAT = 4001,
+}

package/src/index.ts

@@ -0,0 +1,81 @@
+// This file is auto-generated by scripts/generate-indexes.ts
+// Do not edit this file directly
+
+// Export all modules
+export * from "./errors";
+export * from "./singleton";
+export * from "./initializable";
+export * from "./application";
+export * from "./consts";
+export * from "./types";
+export * from "./throwable";
+export * from "./enums";
+export * from "./client/rxjs/rxjs";
+export * from "./client/rxjs/useRxjs";
+export * from "./client/vite/plugins/topsydeUtilsVitePlugin";
+export * from "./server/controller";
+export * from "./server/service";
+export * from "./server/bun/router/controller-discovery";
+export * from "./server/bun/router/routes";
+export * from "./server/bun/router/router";
+export * from "./server/bun/router/router.internal";
+export * from "./server/bun/websocket/websocket.guards";
+export * from "./server/bun/websocket/Client";
+export * from "./server/bun/websocket/Websocket";
+export * from "./server/bun/websocket/websocket.enums";
+export * from "./server/bun/websocket/websocket.types";
+export * from "./server/bun/websocket/Message";
+export * from "./server/bun/websocket/Channel";
+export * from "./utils/Guards";
+export * from "./utils/Lib";
+export * from "./utils/Console";
+
+// Export default classes
+export { default as Singleton } from "./singleton";
+export { default as Initializable } from "./initializable";
+export { default as Application } from "./application";
+export { default as Throwable } from "./throwable";
+export { default as TopsydeUtilsVitePlugin } from "./client/vite/plugins/topsydeUtilsVitePlugin";
+export { default as Controller } from "./server/controller";
+export { default as Service } from "./server/service";
+export { default as Router } from "./server/bun/router/router";
+export { default as Router_Internal } from "./server/bun/router/router.internal";
+export { default as Client } from "./server/bun/websocket/Client";
+export { default as Websocket } from "./server/bun/websocket/Websocket";
+export { default as Message } from "./server/bun/websocket/Message";
+export { default as Channel } from "./server/bun/websocket/Channel";
+export { default as Guards } from "./utils/Guards";
+export { default as Lib } from "./utils/Lib";
+export { default as Console } from "./utils/Console";
+
+// Re-export specific items for backward compatibility
+export { ERROR_CODE, HTTP_ERROR_CODE, WS_ERROR_CODE } from "./errors";
+export { InitializableOptions, InitializableEvent } from "./initializable";
+export { RESPONSE_INIT, RESPONSE_METHOD_OPTIONS } from "./application";
+export { DEFAULT_FALSE_RESPONSE, LOG_COLORS, LOG_ICONS } from "./consts";
+export { ClassConstructor, NonNullableType, ObjectKeys, KVObj, I_ApplicationResponse } from "./types";
+export { E_IS, E_ENVIRONMENTS } from "./enums";
+export { E_SUBJET_TYPE, I_RxjsPayload, RxjsNamespaces } from "./client/rxjs/rxjs";
+export { RxjsDataType } from "./client/rxjs/useRxjs";
+export { ControllerResponse, ControllerAction, ControllerMap, ControllerOptions } from "./server/controller";
+export { Routes } from "./server/bun/router/routes";
+export { WebsocketConstructorOptions, I_WebsocketConstructor } from "./server/bun/websocket/Websocket";
+export { E_WebsocketMessageType, E_WebsocketMessagePriority } from "./server/bun/websocket/websocket.enums";
+export {
+	BunWebsocketMessage,
+	WebsocketChannel,
+	WebsocketClients,
+	WebsocketMessageOptions,
+	WebsocketMessage,
+	WebsocketStructuredMessage,
+	WebsocketEntityId,
+	WebsocketEntityName,
+	WebsocketEntityData,
+	I_WebsocketEntity,
+	I_WebsocketClient,
+	I_WebsocketChannelEntity,
+	BroadcastOptions,
+	I_WebsocketChannel,
+	WebsocketInterfaceHandlers,
+	I_WebsocketInterface,
+} from "./server/bun/websocket/websocket.types";