zlient 3.1.0 → 3.2.0

package/README.md

@@ -16,6 +16,7 @@ Build robust, type-safe API clients with runtime validation, retry logic, and ze
 - **Runtime Validation**: Validate requests, responses, query params, and path params.
 - **Resilience**: Built-in exponential backoff retries and timeouts.
 - **Auth**: Logic-safe authentication providers (Bearer, API Key, Custom).
+- **Real-Time**: Type-safe WebSockets and Server-Sent Events (SSE).
 - **Observability**: Hooks for structured logging and metrics.
 
 ---
@@ -233,6 +234,34 @@ const client = new HttpClient({
 });
 ```
 
+### Real-Time (WebSockets & SSE)
+
+Zlient makes real-time communication as simple as HTTP requests.
+
+#### **WebSockets**
+```typescript
+const chatWs = client.createWebSocket({
+  path: '/chat',
+  send: z.object({ text: z.string() }),
+  receive: z.object({ user: z.string(), text: z.string() }),
+});
+
+const socket = chatWs();
+socket.on('message', (data) => console.log(data.text));
+socket.send({ text: 'Hello!' });
+```
+
+#### **SSE**
+```typescript
+const stream = client.createSSE({
+  path: '/events',
+  response: z.object({ type: z.string(), value: z.number() }),
+});
+
+const sse = stream();
+sse.on('message', (data) => console.log(data.value));
+```
+
 ---
 
 ## Migration from v2
@@ -251,7 +280,7 @@ v3 introduces Standard Schema support. Key changes:
 
 ## Documentation
 
-📖 [Full Documentation](https://zlient.dev)
+📖 [Full Documentation](https://emirhangumus.github.io/zlient/)
 
 ---
 

package/dist/http/http-client.d.ts

@@ -1,6 +1,6 @@
 import type { AuthProvider } from '../auth';
-import { EndpointCall, EndpointConfig } from '../endpoint/base-endpoint';
-import { ClientOptions, HTTPMethod, HTTPStatusCodeNumber, RequestOptions, ResponseSchema, StandardSchemaV1 } from '../types';
+import { ClientOptions, HTTPMethod, HTTPStatusCodeNumber, RequestOptions, ResponseSchema, SSEEndpointCall, SSEEndpointConfig, StandardSchemaV1, WSEndpointCall, WSEndpointConfig } from '../types';
+import { EndpointCall, EndpointConfig } from './http-endpoint';
 /**
  * HTTP client with built-in authentication, and interceptors.
  * Supports multiple base URLs, type-safe requests, and comprehensive error handling.
@@ -179,5 +179,19 @@ export declare class HttpClient {
      * ```
      */
     createEndpoint<ResSchema extends ResponseSchema, ReqSchema extends StandardSchemaV1 | undefined = undefined, QuerySchema extends StandardSchemaV1 | undefined = undefined, PathSchema extends StandardSchemaV1 | undefined = undefined, MustHeaderKeys extends readonly string[] = readonly []>(config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema, MustHeaderKeys>): EndpointCall<ResSchema, ReqSchema, QuerySchema, PathSchema, MustHeaderKeys>;
+    /**
+     * Create a strongly-typed WebSocket endpoint builder.
+     *
+     * @param config - WebSocket endpoint configuration
+     * @returns WebSocket endpoint call function
+     */
+    createWebSocket<SendSchema extends StandardSchemaV1 | undefined = undefined, ReceiveSchema extends StandardSchemaV1 | undefined = undefined, QuerySchema extends StandardSchemaV1 | undefined = undefined, PathSchema extends StandardSchemaV1 | undefined = undefined>(config: WSEndpointConfig<SendSchema, ReceiveSchema, QuerySchema, PathSchema>): WSEndpointCall<SendSchema, ReceiveSchema, QuerySchema, PathSchema>;
+    /**
+     * Create a strongly-typed Server-Sent Events (SSE) endpoint builder.
+     *
+     * @param config - SSE endpoint configuration
+     * @returns SSE endpoint call function
+     */
+    createSSE<ResSchema extends StandardSchemaV1 | undefined = undefined, QuerySchema extends StandardSchemaV1 | undefined = undefined, PathSchema extends StandardSchemaV1 | undefined = undefined>(config: SSEEndpointConfig<ResSchema, QuerySchema, PathSchema>): SSEEndpointCall<ResSchema, QuerySchema, PathSchema>;
 }
 //# sourceMappingURL=http-client.d.ts.map

package/dist/http/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../lib/http/http-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../lib/http/http-client.ts"],"names":[],"mappings":"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"}

package/dist/{endpoint/base-endpoint.d.ts → http/http-endpoint.d.ts}

@@ -1,5 +1,5 @@
-import { HttpClient } from '../http/http-client';
 import { HTTPMethod, ResponseSchema, SchemaMap, StandardSchemaV1 } from '../types';
+import { HttpClient } from './http-client';
 export type EndpointConfig<ResSchema extends ResponseSchema, ReqSchema extends StandardSchemaV1 | undefined = undefined, QuerySchema extends StandardSchemaV1 | undefined = undefined, PathSchema extends StandardSchemaV1 | undefined = undefined, MustHeaderKeys extends readonly string[] = readonly []> = {
     method: keyof typeof HTTPMethod;
     path: string | ((params: StandardSchemaV1.InferOutput<Exclude<PathSchema, undefined>>) => string);
@@ -41,4 +41,4 @@ export declare class EndpointImpl<ResSchema extends ResponseSchema, ReqSchema ex
     call(params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema, MustHeaderKeys>): Promise<InferResponse<ResSchema>>;
 }
 export {};
-//# sourceMappingURL=base-endpoint.d.ts.map
+//# sourceMappingURL=http-endpoint.d.ts.map

package/dist/http/http-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-endpoint.d.ts","sourceRoot":"","sources":["../../lib/http/http-endpoint.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -73,6 +73,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",
@@ -322,7 +495,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;
@@ -364,179 +683,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.
@@ -897,6 +1043,24 @@ 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
 exports.ApiError = ApiError;
@@ -914,7 +1078,11 @@ exports.LoggerUtil = LoggerUtil;
 exports.NoAuth = NoAuth;
 exports.NoOpLogger = NoOpLogger;
 exports.NoOpMetricsCollector = NoOpMetricsCollector;
+exports.SSEConnectionImpl = SSEConnectionImpl;
+exports.SSEEndpointImpl = SSEEndpointImpl;
 exports.SchemaDefinitionError = SchemaDefinitionError;
+exports.WSConnectionImpl = WSConnectionImpl;
+exports.WSEndpointImpl = WSEndpointImpl;
 exports.isStandardSchema = isStandardSchema;
 exports.parseOrThrow = parseOrThrow;
 exports.safeParse = safeParse;