zlient 3.1.0 → 3.2.0

package/dist/index.js

@@ -72,6 +72,179 @@ var BearerTokenAuth = class {
 	}
 };
 //#endregion
+//#region lib/logger.ts
+/**
+* Log levels for structured logging.
+*/
+let LogLevel = /* @__PURE__ */ function(LogLevel) {
+	LogLevel["DEBUG"] = "debug";
+	LogLevel["INFO"] = "info";
+	LogLevel["WARN"] = "warn";
+	LogLevel["ERROR"] = "error";
+	return LogLevel;
+}({});
+/**
+* Default console logger implementation.
+* Formats log entries as JSON for easy parsing.
+*/
+var ConsoleLogger = class {
+	constructor(minLevel = LogLevel.INFO) {
+		this.minLevel = minLevel;
+	}
+	log(entry) {
+		const levels = [
+			LogLevel.DEBUG,
+			LogLevel.INFO,
+			LogLevel.WARN,
+			LogLevel.ERROR
+		];
+		if (levels.indexOf(entry.level) < levels.indexOf(this.minLevel)) return;
+		const output = {
+			...entry,
+			error: entry.error ? {
+				message: entry.error.message,
+				stack: entry.error.stack,
+				name: entry.error.name
+			} : void 0
+		};
+		switch (entry.level) {
+			case LogLevel.DEBUG:
+				console.debug(JSON.stringify(output));
+				break;
+			case LogLevel.INFO:
+				console.info(JSON.stringify(output));
+				break;
+			case LogLevel.WARN:
+				console.warn(JSON.stringify(output));
+				break;
+			case LogLevel.ERROR:
+				console.error(JSON.stringify(output));
+				break;
+		}
+	}
+};
+/**
+* No-op logger that discards all log entries.
+* Use this in production if you don't want any logging.
+*/
+var NoOpLogger = class {
+	log(_entry) {}
+};
+/**
+* Utility class for creating structured log entries.
+*/
+var LoggerUtil = class {
+	constructor(logger) {
+		this.logger = logger;
+	}
+	debug(message, context) {
+		this.logger.log({
+			level: LogLevel.DEBUG,
+			message,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			context
+		});
+	}
+	info(message, context) {
+		this.logger.log({
+			level: LogLevel.INFO,
+			message,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			context
+		});
+	}
+	warn(message, context) {
+		this.logger.log({
+			level: LogLevel.WARN,
+			message,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			context
+		});
+	}
+	error(message, error, context) {
+		this.logger.log({
+			level: LogLevel.ERROR,
+			message,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			context,
+			error
+		});
+	}
+};
+//#endregion
+//#region lib/metrics.ts
+/**
+* No-op metrics collector that discards all metrics.
+*/
+var NoOpMetricsCollector = class {
+	collect(_metrics) {}
+};
+/**
+* In-memory metrics collector for testing and development.
+* Stores metrics in memory with configurable retention.
+*/
+var InMemoryMetricsCollector = class {
+	constructor(maxEntries = 1e3) {
+		this.metrics = [];
+		this.maxEntries = maxEntries;
+	}
+	collect(metrics) {
+		this.metrics.push(metrics);
+		if (this.metrics.length > this.maxEntries) this.metrics.shift();
+	}
+	/**
+	* Get all collected metrics.
+	*/
+	getMetrics() {
+		return [...this.metrics];
+	}
+	/**
+	* Get metrics summary statistics.
+	*/
+	getSummary() {
+		if (this.metrics.length === 0) return {
+			total: 0,
+			successful: 0,
+			failed: 0,
+			avgDurationMs: 0,
+			minDurationMs: 0,
+			maxDurationMs: 0
+		};
+		const successful = this.metrics.filter((m) => m.success).length;
+		let sum = 0;
+		let min = Infinity;
+		let max = -Infinity;
+		for (const m of this.metrics) {
+			const d = m.durationMs;
+			sum += d;
+			if (d < min) min = d;
+			if (d > max) max = d;
+		}
+		return {
+			total: this.metrics.length,
+			successful,
+			failed: this.metrics.length - successful,
+			avgDurationMs: sum / this.metrics.length,
+			minDurationMs: min === Infinity ? 0 : min,
+			maxDurationMs: max === -Infinity ? 0 : max
+		};
+	}
+	/**
+	* Clear all collected metrics.
+	*/
+	clear() {
+		this.metrics = [];
+	}
+};
+/**
+* Console-based metrics collector for debugging.
+*/
+var ConsoleMetricsCollector = class {
+	collect(metrics) {
+		console.log("[METRICS]", JSON.stringify(metrics));
+	}
+};
+//#endregion
 //#region lib/types.ts
 const HTTPMethod = {
 	GET: "GET",
@@ -321,7 +494,153 @@ function isStandardSchema(value) {
 	return "~standard" in schema && typeof schema["~standard"] === "object" && schema["~standard"] !== null && schema["~standard"].version === 1 && typeof schema["~standard"].validate === "function";
 }
 //#endregion
-//#region lib/endpoint/base-endpoint.ts
+//#region lib/sse/sse-client.ts
+var SSEConnectionImpl = class {
+	constructor(url, responseSchema, skipResponseValidation = false, withCredentials = false) {
+		this.responseSchema = responseSchema;
+		this.skipResponseValidation = skipResponseValidation;
+		this.handlers = /* @__PURE__ */ new Map();
+		if (typeof EventSource === "undefined") throw new Error("EventSource is not defined. Ensure you are in a supported environment.");
+		this.es = new EventSource(url, { withCredentials });
+		this.es.onopen = (event) => this.emit("open", event);
+		this.es.onerror = (event) => this.emit("error", event);
+		this.es.onmessage = async (event) => {
+			let data = event.data;
+			try {
+				if (typeof data === "string") try {
+					data = JSON.parse(data);
+				} catch {}
+				if (!this.skipResponseValidation && this.responseSchema) data = await parseOrThrow(this.responseSchema, data);
+				this.emit("message", data);
+			} catch (error) {
+				this.emit("error", error);
+			}
+		};
+	}
+	on(event, handler) {
+		if (!this.handlers.has(event)) {
+			this.handlers.set(event, /* @__PURE__ */ new Set());
+			if (event !== "message" && event !== "open" && event !== "error") this.es.addEventListener(event, async (ev) => {
+				let data = ev.data;
+				try {
+					if (typeof data === "string") try {
+						data = JSON.parse(data);
+					} catch {}
+					if (!this.skipResponseValidation && this.responseSchema) data = await parseOrThrow(this.responseSchema, data);
+					this.emit(event, data);
+				} catch (error) {
+					this.emit("error", error);
+				}
+			});
+		}
+		this.handlers.get(event).add(handler);
+	}
+	off(event, handler) {
+		const handlers = this.handlers.get(event);
+		if (handlers) handlers.delete(handler);
+	}
+	emit(event, ...args) {
+		const handlers = this.handlers.get(event);
+		if (handlers) handlers.forEach((handler) => handler(...args));
+	}
+	close() {
+		this.es.close();
+	}
+	get readyState() {
+		return this.es.readyState;
+	}
+};
+//#endregion
+//#region lib/sse/sse-endpoint.ts
+var SSEEndpointImpl = class {
+	constructor(client, config) {
+		this.client = client;
+		this.config = config;
+	}
+	createCall() {
+		return (params) => {
+			const { query, pathParams } = params || {};
+			let pathStr;
+			if (typeof this.config.path === "function") {
+				if (!pathParams) throw new Error("Path function requires pathParams");
+				pathStr = this.config.path(pathParams);
+			} else pathStr = this.config.path;
+			return new SSEConnectionImpl(`${this.client.getBaseUrl(this.config.advanced?.baseUrlKey || "default")}${pathStr}${toQueryString(query)}`, this.config.response, this.config.advanced?.skipResponseValidation, this.config.advanced?.withCredentials);
+		};
+	}
+};
+//#endregion
+//#region lib/ws/ws-client.ts
+var WSConnectionImpl = class {
+	constructor(url, sendSchema, receiveSchema, skipRequestValidation = false, skipResponseValidation = false, protocols) {
+		this.sendSchema = sendSchema;
+		this.receiveSchema = receiveSchema;
+		this.skipRequestValidation = skipRequestValidation;
+		this.skipResponseValidation = skipResponseValidation;
+		this.handlers = /* @__PURE__ */ new Map();
+		if (typeof WebSocket === "undefined") throw new Error("WebSocket is not defined. Ensure you are in a supported environment.");
+		this.ws = new WebSocket(url, protocols);
+		this.ws.onopen = () => this.emit("open");
+		this.ws.onclose = (event) => this.emit("close", event);
+		this.ws.onerror = (event) => this.emit("error", event);
+		this.ws.onmessage = async (event) => {
+			let data = event.data;
+			try {
+				if (typeof data === "string") try {
+					data = JSON.parse(data);
+				} catch {}
+				if (!this.skipResponseValidation && this.receiveSchema) data = await parseOrThrow(this.receiveSchema, data);
+				this.emit("message", data);
+			} catch (error) {
+				this.emit("error", error);
+			}
+		};
+	}
+	async send(data) {
+		if (!this.skipRequestValidation && this.sendSchema) await parseOrThrow(this.sendSchema, data);
+		const message = data != null && typeof data === "object" ? JSON.stringify(data) : data;
+		this.ws.send(message);
+	}
+	on(event, handler) {
+		if (!this.handlers.has(event)) this.handlers.set(event, /* @__PURE__ */ new Set());
+		this.handlers.get(event).add(handler);
+	}
+	off(event, handler) {
+		const handlers = this.handlers.get(event);
+		if (handlers) handlers.delete(handler);
+	}
+	emit(event, ...args) {
+		const handlers = this.handlers.get(event);
+		if (handlers) handlers.forEach((handler) => handler(...args));
+	}
+	close(code, reason) {
+		this.ws.close(code, reason);
+	}
+	get readyState() {
+		return this.ws.readyState;
+	}
+};
+//#endregion
+//#region lib/ws/ws-endpoint.ts
+var WSEndpointImpl = class {
+	constructor(client, config) {
+		this.client = client;
+		this.config = config;
+	}
+	createCall() {
+		return (params) => {
+			const { query, pathParams, protocols } = params || {};
+			let pathStr;
+			if (typeof this.config.path === "function") {
+				if (!pathParams) throw new Error("Path function requires pathParams");
+				pathStr = this.config.path(pathParams);
+			} else pathStr = this.config.path;
+			return new WSConnectionImpl(`${this.client.getBaseUrl(this.config.advanced?.baseUrlKey || "default").replace(/^http/, "ws")}${pathStr}${toQueryString(query)}`, this.config.send, this.config.receive, this.config.advanced?.skipRequestValidation, this.config.advanced?.skipResponseValidation, protocols);
+		};
+	}
+};
+//#endregion
+//#region lib/http/http-endpoint.ts
 var EndpointImpl = class {
 	constructor(client, config) {
 		this.client = client;
@@ -363,179 +682,6 @@ var EndpointImpl = class {
 	}
 };
 //#endregion
-//#region lib/logger.ts
-/**
-* Log levels for structured logging.
-*/
-let LogLevel = /* @__PURE__ */ function(LogLevel) {
-	LogLevel["DEBUG"] = "debug";
-	LogLevel["INFO"] = "info";
-	LogLevel["WARN"] = "warn";
-	LogLevel["ERROR"] = "error";
-	return LogLevel;
-}({});
-/**
-* Default console logger implementation.
-* Formats log entries as JSON for easy parsing.
-*/
-var ConsoleLogger = class {
-	constructor(minLevel = LogLevel.INFO) {
-		this.minLevel = minLevel;
-	}
-	log(entry) {
-		const levels = [
-			LogLevel.DEBUG,
-			LogLevel.INFO,
-			LogLevel.WARN,
-			LogLevel.ERROR
-		];
-		if (levels.indexOf(entry.level) < levels.indexOf(this.minLevel)) return;
-		const output = {
-			...entry,
-			error: entry.error ? {
-				message: entry.error.message,
-				stack: entry.error.stack,
-				name: entry.error.name
-			} : void 0
-		};
-		switch (entry.level) {
-			case LogLevel.DEBUG:
-				console.debug(JSON.stringify(output));
-				break;
-			case LogLevel.INFO:
-				console.info(JSON.stringify(output));
-				break;
-			case LogLevel.WARN:
-				console.warn(JSON.stringify(output));
-				break;
-			case LogLevel.ERROR:
-				console.error(JSON.stringify(output));
-				break;
-		}
-	}
-};
-/**
-* No-op logger that discards all log entries.
-* Use this in production if you don't want any logging.
-*/
-var NoOpLogger = class {
-	log(_entry) {}
-};
-/**
-* Utility class for creating structured log entries.
-*/
-var LoggerUtil = class {
-	constructor(logger) {
-		this.logger = logger;
-	}
-	debug(message, context) {
-		this.logger.log({
-			level: LogLevel.DEBUG,
-			message,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			context
-		});
-	}
-	info(message, context) {
-		this.logger.log({
-			level: LogLevel.INFO,
-			message,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			context
-		});
-	}
-	warn(message, context) {
-		this.logger.log({
-			level: LogLevel.WARN,
-			message,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			context
-		});
-	}
-	error(message, error, context) {
-		this.logger.log({
-			level: LogLevel.ERROR,
-			message,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			context,
-			error
-		});
-	}
-};
-//#endregion
-//#region lib/metrics.ts
-/**
-* No-op metrics collector that discards all metrics.
-*/
-var NoOpMetricsCollector = class {
-	collect(_metrics) {}
-};
-/**
-* In-memory metrics collector for testing and development.
-* Stores metrics in memory with configurable retention.
-*/
-var InMemoryMetricsCollector = class {
-	constructor(maxEntries = 1e3) {
-		this.metrics = [];
-		this.maxEntries = maxEntries;
-	}
-	collect(metrics) {
-		this.metrics.push(metrics);
-		if (this.metrics.length > this.maxEntries) this.metrics.shift();
-	}
-	/**
-	* Get all collected metrics.
-	*/
-	getMetrics() {
-		return [...this.metrics];
-	}
-	/**
-	* Get metrics summary statistics.
-	*/
-	getSummary() {
-		if (this.metrics.length === 0) return {
-			total: 0,
-			successful: 0,
-			failed: 0,
-			avgDurationMs: 0,
-			minDurationMs: 0,
-			maxDurationMs: 0
-		};
-		const successful = this.metrics.filter((m) => m.success).length;
-		let sum = 0;
-		let min = Infinity;
-		let max = -Infinity;
-		for (const m of this.metrics) {
-			const d = m.durationMs;
-			sum += d;
-			if (d < min) min = d;
-			if (d > max) max = d;
-		}
-		return {
-			total: this.metrics.length,
-			successful,
-			failed: this.metrics.length - successful,
-			avgDurationMs: sum / this.metrics.length,
-			minDurationMs: min === Infinity ? 0 : min,
-			maxDurationMs: max === -Infinity ? 0 : max
-		};
-	}
-	/**
-	* Clear all collected metrics.
-	*/
-	clear() {
-		this.metrics = [];
-	}
-};
-/**
-* Console-based metrics collector for debugging.
-*/
-var ConsoleMetricsCollector = class {
-	collect(metrics) {
-		console.log("[METRICS]", JSON.stringify(metrics));
-	}
-};
-//#endregion
 //#region lib/http/http-client.ts
 /**
 * HTTP client with built-in authentication, and interceptors.
@@ -896,8 +1042,26 @@ var HttpClient = class {
 		const endpoint = new EndpointImpl(this, config);
 		return (params) => endpoint.call(params);
 	}
+	/**
+	* Create a strongly-typed WebSocket endpoint builder.
+	*
+	* @param config - WebSocket endpoint configuration
+	* @returns WebSocket endpoint call function
+	*/
+	createWebSocket(config) {
+		return new WSEndpointImpl(this, config).createCall();
+	}
+	/**
+	* Create a strongly-typed Server-Sent Events (SSE) endpoint builder.
+	*
+	* @param config - SSE endpoint configuration
+	* @returns SSE endpoint call function
+	*/
+	createSSE(config) {
+		return new SSEEndpointImpl(this, config).createCall();
+	}
 };
 //#endregion
-export { ApiError, ApiKeyAuth, BearerTokenAuth, ConsoleLogger, ConsoleMetricsCollector, EndpointImpl, HTTPMethod, HTTPStatusCode, HttpClient, InMemoryMetricsCollector, LogLevel, LoggerUtil, NoAuth, NoOpLogger, NoOpMetricsCollector, SchemaDefinitionError, isStandardSchema, parseOrThrow, safeParse, toQueryString };
+export { ApiError, ApiKeyAuth, BearerTokenAuth, ConsoleLogger, ConsoleMetricsCollector, EndpointImpl, HTTPMethod, HTTPStatusCode, HttpClient, InMemoryMetricsCollector, LogLevel, LoggerUtil, NoAuth, NoOpLogger, NoOpMetricsCollector, SSEConnectionImpl, SSEEndpointImpl, SchemaDefinitionError, WSConnectionImpl, WSEndpointImpl, isStandardSchema, parseOrThrow, safeParse, toQueryString };
 
 //# sourceMappingURL=index.js.map