@fatagnus/dink-web 2.24.0 → 2.24.1

package/dist/client.d.ts

@@ -96,4 +96,3 @@ export declare class DinkWebClient implements ServiceCaller {
     private encode;
     private decode;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,312 @@
-export { DinkWebClient } from './client.js';
-export { type DinkWebConfig, type ServiceCaller, type Subscription, type StreamSubscription, type StreamOptions, type ServiceDefinition, type ConnectionStatus, type ConnectionStats, type WebTokenResponse, type TokenRefresher, type EdgeInfo, type Channel, type ChannelOptions, } from './types.js';
-export { DinkWebProvider, useDinkWeb, useDinkService, useChannel, type DinkWebProviderProps, type UseChannelOptions } from './react.js';
-//# sourceMappingURL=index.d.ts.map
+// Generated by dts-bundle-generator v9.5.1
+
+import { ReactNode } from 'react';
+
+export interface ServiceCaller {
+	call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+	callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+	subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
+}
+export interface Subscription {
+	unsubscribe(): void;
+}
+/**
+ * Extended subscription handle for streaming RPCs.
+ * Supports cancellation and lifecycle callbacks.
+ */
+export interface StreamSubscription extends Subscription {
+	/** Send a cancel signal to the edge to abort the stream. */
+	cancel(): void;
+}
+/**
+ * Options for streaming RPC subscriptions.
+ */
+export interface StreamOptions {
+	/** Called when the stream completes normally. */
+	onDone?: () => void;
+	/** Called when the stream encounters an error. */
+	onError?: (err: Error) => void;
+}
+export interface ServiceDefinition {
+	name: string;
+	version: string;
+	methods: string[];
+}
+/** Response from POST /api/keys/web-token */
+export interface WebTokenResponse {
+	token: string;
+	ws_url: string;
+	expires_at: string;
+}
+/**
+ * Callback that fetches a fresh web token.
+ * Called automatically when the current token is about to expire.
+ * Should POST to /api/keys/web-token and return the response.
+ */
+export type TokenRefresher = () => Promise<WebTokenResponse>;
+export interface DinkWebConfig {
+	/** WebSocket URL (e.g., "wss://host:9222") */
+	url: string;
+	/** Authentication token (from /api/keys/web-token) */
+	token: string;
+	/** Token expiry time (ISO 8601 string or Date). Enables auto-refresh when set with tokenRefresher. */
+	expiresAt?: string | Date;
+	/** App ID for subject routing */
+	appId: string;
+	/** Request timeout in ms (default: 30000) */
+	timeout?: number;
+	/** Called when connection state changes */
+	onStatusChange?: (status: ConnectionStatus) => void;
+	/**
+	 * Called to obtain a fresh token before the current one expires.
+	 * If not set, the client will not auto-refresh tokens.
+	 */
+	tokenRefresher?: TokenRefresher;
+	/**
+	 * How many ms before expiry to trigger a refresh (default: 60000 = 1 minute).
+	 */
+	refreshBeforeExpiryMs?: number;
+}
+export interface ConnectionStats {
+	/** Current connection status */
+	status: ConnectionStatus;
+	/** Number of reconnections since connect() */
+	reconnectCount: number;
+	/** Last measured round-trip time in ms, or null if not yet measured */
+	rttMs: number | null;
+	/** When the current token expires, or null if unknown */
+	tokenExpiresAt: Date | null;
+}
+export type ConnectionStatus = "connecting" | "connected" | "reconnecting" | "closed" | "error";
+/** Discovered edge information */
+export interface EdgeInfo {
+	edgeId: string;
+	name?: string;
+	labels?: Record<string, string>;
+	services?: string[];
+	status?: string;
+}
+/** Bidirectional raw byte channel between browser and edge. */
+export interface Channel {
+	/** Unique channel identifier (e.g., "ch_abc123") */
+	readonly id: string;
+	/** Send raw bytes to the other side. Returns false if backpressure is active. */
+	write(data: Uint8Array): boolean;
+	/** Register handler for incoming raw bytes */
+	onData(handler: (data: Uint8Array) => void): void;
+	/** Close the channel (either side can initiate) */
+	close(): void;
+	/** Called when the channel closes (by either side). Supports multiple handlers. */
+	onClose(handler: (reason?: string) => void): void;
+	/** Send a JSON-serializable control message out-of-band */
+	sendControl(msg: unknown): void;
+	/** Register handler for incoming control messages */
+	onControl(handler: (msg: unknown) => void): void;
+	/** True if channel is open */
+	readonly isOpen: boolean;
+	/** Promise that resolves when the channel closes */
+	readonly closed: Promise<void>;
+	/** Number of bytes queued for sending */
+	readonly bufferedAmount: number;
+	/** Register handler called when buffered data has been flushed */
+	onDrain(handler: () => void): void;
+}
+/** Options for opening a channel. */
+export interface ChannelOptions {
+	/** Called when the channel encounters an error. */
+	onError?: (err: Error) => void;
+}
+/**
+ * DinkWebClient connects to dinkd via NATS WebSocket from the browser.
+ * Implements ServiceCaller so generated client code works unchanged.
+ *
+ * Features:
+ * - Correct inbox-based streaming protocol (matches Node.js SDK)
+ * - Auto token refresh before expiry (requires tokenRefresher config)
+ * - Connection quality monitoring (RTT, reconnect count)
+ * - Automatic reconnection (built into nats.ws)
+ * - Center and edge service calls
+ * - Raw binary subscription mode for high-throughput streams
+ * - Edge discovery from the browser
+ */
+export declare class DinkWebClient implements ServiceCaller {
+	private nc;
+	private config;
+	private _status;
+	private _reconnectCount;
+	private _rttMs;
+	private _tokenExpiresAt;
+	private _refreshTimer;
+	private _rttInterval;
+	constructor(config: DinkWebConfig);
+	get status(): ConnectionStatus;
+	/** Current connection statistics */
+	get stats(): ConnectionStats;
+	connect(): Promise<void>;
+	close(): Promise<void>;
+	/**
+	 * Call an edge service via request/reply.
+	 * Subject: edge.{appId}.{edgeId}.services.{service}.{method}
+	 */
+	call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+	/**
+	 * Call a center (cloud) service via request/reply.
+	 * Subject: center.{appId}.services.{service}.{method}
+	 */
+	callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+	/**
+	 * Subscribe to a streaming edge service using the correct inbox-based protocol.
+	 *
+	 * Protocol:
+	 * 1. Create a unique inbox subject
+	 * 2. Subscribe to inbox (data) and inbox.done (completion)
+	 * 3. Send { reply_subject, data } envelope via request to the .stream subject
+	 * 4. Edge acks with { status, cancelSubject }
+	 * 5. Edge publishes stream data to the inbox, then inbox.done when finished
+	 * 6. On cancel/unsubscribe, publish to cancelSubject to abort the stream
+	 */
+	subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
+	/**
+	 * Subscribe to a streaming edge service in raw binary mode.
+	 * Skips JSON encode/decode — handler receives raw Uint8Array payloads.
+	 * Ideal for high-throughput binary streams (PTY output, file transfers).
+	 *
+	 * Uses the same inbox-based streaming protocol as subscribe().
+	 */
+	subscribeRaw(edgeId: string, service: string, method: string, req: unknown, handler: (data: Uint8Array) => void, options?: StreamOptions): Promise<StreamSubscription>;
+	/**
+	 * Open a bidirectional raw byte channel to an edge service.
+	 * Returns a Channel object for sending/receiving raw Uint8Array data.
+	 *
+	 * Protocol:
+	 * 1. Create two unique inbox subjects (output for receiving, input for sending)
+	 * 2. Subscribe to output inbox (data) and output inbox.done (completion)
+	 * 3. Send { reply_subject, input_subject, data } envelope via request to .channel subject
+	 * 4. Edge acks with { status, cancelSubject }
+	 * 5. Bidirectional raw byte flow over the two inboxes
+	 * 6. Either side can close: client publishes to cancelSubject, edge publishes to outputInbox.done
+	 */
+	openChannel(edgeId: string, service: string, method: string, request?: unknown, options?: ChannelOptions): Promise<Channel>;
+	/**
+	 * Discover edges in the current app.
+	 * Subject: center.{appId}.edges.discover
+	 *
+	 * This is a convenience for browser apps that need to find edges
+	 * without a Convex backend intermediary.
+	 */
+	discoverEdges(filter?: {
+		labels?: Record<string, string>;
+		service?: string;
+	}): Promise<EdgeInfo[]>;
+	/**
+	 * Create a typed service client for an edge.
+	 * Usage: const svc = client.service('edge-1', MyServiceClient);
+	 */
+	service<T>(edgeId: string, factory: new (edgeId: string, caller: ServiceCaller) => T): T;
+	private scheduleTokenRefresh;
+	private refreshToken;
+	private startRttProbe;
+	private monitorStatus;
+	private stopTimers;
+	private setStatus;
+	private ensureConnected;
+	private encode;
+	private decode;
+}
+export interface DinkWebContextValue {
+	client: DinkWebClient | null;
+	status: ConnectionStatus;
+	stats: ConnectionStats;
+}
+export interface DinkWebProviderProps {
+	/** WebSocket URL (e.g., "wss://host:9222") */
+	url: string;
+	/** Authentication token */
+	token: string;
+	/** Token expiry (ISO string or Date) */
+	expiresAt?: string | Date;
+	/** App ID for subject routing */
+	appId: string;
+	/** Request timeout in ms */
+	timeout?: number;
+	/** Callback to fetch a fresh token before expiry */
+	tokenRefresher?: TokenRefresher;
+	/** Ms before expiry to trigger refresh (default: 60000) */
+	refreshBeforeExpiryMs?: number;
+	children: ReactNode;
+}
+/**
+ * Provider that manages DinkWebClient lifecycle.
+ * Creates and connects the client on mount, drains on unmount.
+ * Reconnects when url/token/appId change.
+ */
+export declare function DinkWebProvider({ url, token, expiresAt, appId, timeout, tokenRefresher, refreshBeforeExpiryMs, children, }: DinkWebProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<DinkWebContextValue | null>>;
+/**
+ * Access the DinkWebClient instance, connection status, and stats.
+ *
+ * @throws Error if used outside DinkWebProvider
+ *
+ * @example
+ * ```tsx
+ * function StatusBar() {
+ *   const { client, status, stats } = useDinkWeb();
+ *   return <div>Status: {status}, RTT: {stats.rttMs}ms</div>;
+ * }
+ * ```
+ */
+export declare function useDinkWeb(): DinkWebContextValue;
+/**
+ * Get a typed service client bound to a specific edge.
+ * Memoized — returns the same instance as long as edgeId and client don't change.
+ *
+ * @param edgeId - Edge to bind the service client to
+ * @param factory - Generated service client class (e.g., TerminalServiceClient)
+ *
+ * @example
+ * ```tsx
+ * function Terminal({ edgeId }: { edgeId: string }) {
+ *   const svc = useDinkService(edgeId, TerminalServiceClient);
+ *   // svc.StreamOutput(...), svc.SendInput(...), etc.
+ * }
+ * ```
+ */
+export declare function useDinkService<T>(edgeId: string, factory: new (edgeId: string, caller: ServiceCaller) => T): T | null;
+/**
+ * Options for the useChannel hook.
+ */
+export interface UseChannelOptions extends ChannelOptions {
+	/** If false, the channel will not be opened. Default: true. */
+	enabled?: boolean;
+}
+/**
+ * Open a bidirectional raw byte channel to an edge service.
+ * Manages channel lifecycle — opens on mount/deps change, closes on unmount.
+ *
+ * @param edgeId - Edge to connect to
+ * @param service - Service name
+ * @param method - Method name
+ * @param request - Initial request payload
+ * @param options - Channel options
+ *
+ * @example
+ * ```tsx
+ * function Terminal({ edgeId }: { edgeId: string }) {
+ *   const { channel, isOpen, error } = useChannel(
+ *     edgeId, 'TerminalService', 'shell',
+ *     { shell: '/bin/bash', cols: 80, rows: 24 }
+ *   );
+ *
+ *   useEffect(() => {
+ *     if (!channel) return;
+ *     channel.onData((data) => term.write(data));
+ *   }, [channel]);
+ * }
+ * ```
+ */
+export declare function useChannel(edgeId: string, service: string, method: string, request?: unknown, options?: UseChannelOptions): {
+	channel: Channel | null;
+	isOpen: boolean;
+	error: Error | null;
+};
+
+export {};

package/dist/react.d.ts

@@ -1,36 +1,221 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { ReactNode } from 'react';
+
+export interface ServiceCaller {
+	call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+	callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+	subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
+}
+export interface Subscription {
+	unsubscribe(): void;
+}
 /**
- * React hooks for DinkWebClient.
- *
- * Provides DinkWebProvider for connection lifecycle management,
- * useDinkWeb for accessing client + status, and useDinkService
- * for typed service client access with auto-edge binding.
- *
- * @module @fatagnus/dink-web/react
+ * Extended subscription handle for streaming RPCs.
+ * Supports cancellation and lifecycle callbacks.
  */
-import { type ReactNode } from 'react';
-import { DinkWebClient } from './client.js';
-import type { ConnectionStatus, ConnectionStats, ServiceCaller, TokenRefresher, Channel, ChannelOptions } from './types.js';
-interface DinkWebContextValue {
-    client: DinkWebClient | null;
-    status: ConnectionStatus;
-    stats: ConnectionStats;
+export interface StreamSubscription extends Subscription {
+	/** Send a cancel signal to the edge to abort the stream. */
+	cancel(): void;
+}
+/**
+ * Options for streaming RPC subscriptions.
+ */
+export interface StreamOptions {
+	/** Called when the stream completes normally. */
+	onDone?: () => void;
+	/** Called when the stream encounters an error. */
+	onError?: (err: Error) => void;
+}
+/** Response from POST /api/keys/web-token */
+export interface WebTokenResponse {
+	token: string;
+	ws_url: string;
+	expires_at: string;
+}
+/**
+ * Callback that fetches a fresh web token.
+ * Called automatically when the current token is about to expire.
+ * Should POST to /api/keys/web-token and return the response.
+ */
+export type TokenRefresher = () => Promise<WebTokenResponse>;
+export interface DinkWebConfig {
+	/** WebSocket URL (e.g., "wss://host:9222") */
+	url: string;
+	/** Authentication token (from /api/keys/web-token) */
+	token: string;
+	/** Token expiry time (ISO 8601 string or Date). Enables auto-refresh when set with tokenRefresher. */
+	expiresAt?: string | Date;
+	/** App ID for subject routing */
+	appId: string;
+	/** Request timeout in ms (default: 30000) */
+	timeout?: number;
+	/** Called when connection state changes */
+	onStatusChange?: (status: ConnectionStatus) => void;
+	/**
+	 * Called to obtain a fresh token before the current one expires.
+	 * If not set, the client will not auto-refresh tokens.
+	 */
+	tokenRefresher?: TokenRefresher;
+	/**
+	 * How many ms before expiry to trigger a refresh (default: 60000 = 1 minute).
+	 */
+	refreshBeforeExpiryMs?: number;
+}
+export interface ConnectionStats {
+	/** Current connection status */
+	status: ConnectionStatus;
+	/** Number of reconnections since connect() */
+	reconnectCount: number;
+	/** Last measured round-trip time in ms, or null if not yet measured */
+	rttMs: number | null;
+	/** When the current token expires, or null if unknown */
+	tokenExpiresAt: Date | null;
+}
+export type ConnectionStatus = "connecting" | "connected" | "reconnecting" | "closed" | "error";
+/** Discovered edge information */
+export interface EdgeInfo {
+	edgeId: string;
+	name?: string;
+	labels?: Record<string, string>;
+	services?: string[];
+	status?: string;
+}
+/** Bidirectional raw byte channel between browser and edge. */
+export interface Channel {
+	/** Unique channel identifier (e.g., "ch_abc123") */
+	readonly id: string;
+	/** Send raw bytes to the other side. Returns false if backpressure is active. */
+	write(data: Uint8Array): boolean;
+	/** Register handler for incoming raw bytes */
+	onData(handler: (data: Uint8Array) => void): void;
+	/** Close the channel (either side can initiate) */
+	close(): void;
+	/** Called when the channel closes (by either side). Supports multiple handlers. */
+	onClose(handler: (reason?: string) => void): void;
+	/** Send a JSON-serializable control message out-of-band */
+	sendControl(msg: unknown): void;
+	/** Register handler for incoming control messages */
+	onControl(handler: (msg: unknown) => void): void;
+	/** True if channel is open */
+	readonly isOpen: boolean;
+	/** Promise that resolves when the channel closes */
+	readonly closed: Promise<void>;
+	/** Number of bytes queued for sending */
+	readonly bufferedAmount: number;
+	/** Register handler called when buffered data has been flushed */
+	onDrain(handler: () => void): void;
+}
+/** Options for opening a channel. */
+export interface ChannelOptions {
+	/** Called when the channel encounters an error. */
+	onError?: (err: Error) => void;
+}
+declare class DinkWebClient implements ServiceCaller {
+	private nc;
+	private config;
+	private _status;
+	private _reconnectCount;
+	private _rttMs;
+	private _tokenExpiresAt;
+	private _refreshTimer;
+	private _rttInterval;
+	constructor(config: DinkWebConfig);
+	get status(): ConnectionStatus;
+	/** Current connection statistics */
+	get stats(): ConnectionStats;
+	connect(): Promise<void>;
+	close(): Promise<void>;
+	/**
+	 * Call an edge service via request/reply.
+	 * Subject: edge.{appId}.{edgeId}.services.{service}.{method}
+	 */
+	call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+	/**
+	 * Call a center (cloud) service via request/reply.
+	 * Subject: center.{appId}.services.{service}.{method}
+	 */
+	callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+	/**
+	 * Subscribe to a streaming edge service using the correct inbox-based protocol.
+	 *
+	 * Protocol:
+	 * 1. Create a unique inbox subject
+	 * 2. Subscribe to inbox (data) and inbox.done (completion)
+	 * 3. Send { reply_subject, data } envelope via request to the .stream subject
+	 * 4. Edge acks with { status, cancelSubject }
+	 * 5. Edge publishes stream data to the inbox, then inbox.done when finished
+	 * 6. On cancel/unsubscribe, publish to cancelSubject to abort the stream
+	 */
+	subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
+	/**
+	 * Subscribe to a streaming edge service in raw binary mode.
+	 * Skips JSON encode/decode — handler receives raw Uint8Array payloads.
+	 * Ideal for high-throughput binary streams (PTY output, file transfers).
+	 *
+	 * Uses the same inbox-based streaming protocol as subscribe().
+	 */
+	subscribeRaw(edgeId: string, service: string, method: string, req: unknown, handler: (data: Uint8Array) => void, options?: StreamOptions): Promise<StreamSubscription>;
+	/**
+	 * Open a bidirectional raw byte channel to an edge service.
+	 * Returns a Channel object for sending/receiving raw Uint8Array data.
+	 *
+	 * Protocol:
+	 * 1. Create two unique inbox subjects (output for receiving, input for sending)
+	 * 2. Subscribe to output inbox (data) and output inbox.done (completion)
+	 * 3. Send { reply_subject, input_subject, data } envelope via request to .channel subject
+	 * 4. Edge acks with { status, cancelSubject }
+	 * 5. Bidirectional raw byte flow over the two inboxes
+	 * 6. Either side can close: client publishes to cancelSubject, edge publishes to outputInbox.done
+	 */
+	openChannel(edgeId: string, service: string, method: string, request?: unknown, options?: ChannelOptions): Promise<Channel>;
+	/**
+	 * Discover edges in the current app.
+	 * Subject: center.{appId}.edges.discover
+	 *
+	 * This is a convenience for browser apps that need to find edges
+	 * without a Convex backend intermediary.
+	 */
+	discoverEdges(filter?: {
+		labels?: Record<string, string>;
+		service?: string;
+	}): Promise<EdgeInfo[]>;
+	/**
+	 * Create a typed service client for an edge.
+	 * Usage: const svc = client.service('edge-1', MyServiceClient);
+	 */
+	service<T>(edgeId: string, factory: new (edgeId: string, caller: ServiceCaller) => T): T;
+	private scheduleTokenRefresh;
+	private refreshToken;
+	private startRttProbe;
+	private monitorStatus;
+	private stopTimers;
+	private setStatus;
+	private ensureConnected;
+	private encode;
+	private decode;
+}
+export interface DinkWebContextValue {
+	client: DinkWebClient | null;
+	status: ConnectionStatus;
+	stats: ConnectionStats;
 }
 export interface DinkWebProviderProps {
-    /** WebSocket URL (e.g., "wss://host:9222") */
-    url: string;
-    /** Authentication token */
-    token: string;
-    /** Token expiry (ISO string or Date) */
-    expiresAt?: string | Date;
-    /** App ID for subject routing */
-    appId: string;
-    /** Request timeout in ms */
-    timeout?: number;
-    /** Callback to fetch a fresh token before expiry */
-    tokenRefresher?: TokenRefresher;
-    /** Ms before expiry to trigger refresh (default: 60000) */
-    refreshBeforeExpiryMs?: number;
-    children: ReactNode;
+	/** WebSocket URL (e.g., "wss://host:9222") */
+	url: string;
+	/** Authentication token */
+	token: string;
+	/** Token expiry (ISO string or Date) */
+	expiresAt?: string | Date;
+	/** App ID for subject routing */
+	appId: string;
+	/** Request timeout in ms */
+	timeout?: number;
+	/** Callback to fetch a fresh token before expiry */
+	tokenRefresher?: TokenRefresher;
+	/** Ms before expiry to trigger refresh (default: 60000) */
+	refreshBeforeExpiryMs?: number;
+	children: ReactNode;
 }
 /**
  * Provider that manages DinkWebClient lifecycle.
@@ -72,8 +257,8 @@ export declare function useDinkService<T>(edgeId: string, factory: new (edgeId:
  * Options for the useChannel hook.
  */
 export interface UseChannelOptions extends ChannelOptions {
-    /** If false, the channel will not be opened. Default: true. */
-    enabled?: boolean;
+	/** If false, the channel will not be opened. Default: true. */
+	enabled?: boolean;
 }
 /**
  * Open a bidirectional raw byte channel to an edge service.
@@ -101,9 +286,9 @@ export interface UseChannelOptions extends ChannelOptions {
  * ```
  */
 export declare function useChannel(edgeId: string, service: string, method: string, request?: unknown, options?: UseChannelOptions): {
-    channel: Channel | null;
-    isOpen: boolean;
-    error: Error | null;
+	channel: Channel | null;
+	isOpen: boolean;
+	error: Error | null;
 };
+
 export {};
-//# sourceMappingURL=react.d.ts.map

package/dist/types.d.ts

@@ -1,38 +1,40 @@
+// Generated by dts-bundle-generator v9.5.1
+
 export interface ServiceCaller {
-    call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
-    callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
-    subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
+	call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+	callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+	subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void, options?: StreamOptions): Promise<StreamSubscription>;
 }
 export interface Subscription {
-    unsubscribe(): void;
+	unsubscribe(): void;
 }
 /**
  * Extended subscription handle for streaming RPCs.
  * Supports cancellation and lifecycle callbacks.
  */
 export interface StreamSubscription extends Subscription {
-    /** Send a cancel signal to the edge to abort the stream. */
-    cancel(): void;
+	/** Send a cancel signal to the edge to abort the stream. */
+	cancel(): void;
 }
 /**
  * Options for streaming RPC subscriptions.
  */
 export interface StreamOptions {
-    /** Called when the stream completes normally. */
-    onDone?: () => void;
-    /** Called when the stream encounters an error. */
-    onError?: (err: Error) => void;
+	/** Called when the stream completes normally. */
+	onDone?: () => void;
+	/** Called when the stream encounters an error. */
+	onError?: (err: Error) => void;
 }
 export interface ServiceDefinition {
-    name: string;
-    version: string;
-    methods: string[];
+	name: string;
+	version: string;
+	methods: string[];
 }
 /** Response from POST /api/keys/web-token */
 export interface WebTokenResponse {
-    token: string;
-    ws_url: string;
-    expires_at: string;
+	token: string;
+	ws_url: string;
+	expires_at: string;
 }
 /**
  * Callback that fetches a fresh web token.
@@ -41,75 +43,76 @@ export interface WebTokenResponse {
  */
 export type TokenRefresher = () => Promise<WebTokenResponse>;
 export interface DinkWebConfig {
-    /** WebSocket URL (e.g., "wss://host:9222") */
-    url: string;
-    /** Authentication token (from /api/keys/web-token) */
-    token: string;
-    /** Token expiry time (ISO 8601 string or Date). Enables auto-refresh when set with tokenRefresher. */
-    expiresAt?: string | Date;
-    /** App ID for subject routing */
-    appId: string;
-    /** Request timeout in ms (default: 30000) */
-    timeout?: number;
-    /** Called when connection state changes */
-    onStatusChange?: (status: ConnectionStatus) => void;
-    /**
-     * Called to obtain a fresh token before the current one expires.
-     * If not set, the client will not auto-refresh tokens.
-     */
-    tokenRefresher?: TokenRefresher;
-    /**
-     * How many ms before expiry to trigger a refresh (default: 60000 = 1 minute).
-     */
-    refreshBeforeExpiryMs?: number;
+	/** WebSocket URL (e.g., "wss://host:9222") */
+	url: string;
+	/** Authentication token (from /api/keys/web-token) */
+	token: string;
+	/** Token expiry time (ISO 8601 string or Date). Enables auto-refresh when set with tokenRefresher. */
+	expiresAt?: string | Date;
+	/** App ID for subject routing */
+	appId: string;
+	/** Request timeout in ms (default: 30000) */
+	timeout?: number;
+	/** Called when connection state changes */
+	onStatusChange?: (status: ConnectionStatus) => void;
+	/**
+	 * Called to obtain a fresh token before the current one expires.
+	 * If not set, the client will not auto-refresh tokens.
+	 */
+	tokenRefresher?: TokenRefresher;
+	/**
+	 * How many ms before expiry to trigger a refresh (default: 60000 = 1 minute).
+	 */
+	refreshBeforeExpiryMs?: number;
 }
 export interface ConnectionStats {
-    /** Current connection status */
-    status: ConnectionStatus;
-    /** Number of reconnections since connect() */
-    reconnectCount: number;
-    /** Last measured round-trip time in ms, or null if not yet measured */
-    rttMs: number | null;
-    /** When the current token expires, or null if unknown */
-    tokenExpiresAt: Date | null;
+	/** Current connection status */
+	status: ConnectionStatus;
+	/** Number of reconnections since connect() */
+	reconnectCount: number;
+	/** Last measured round-trip time in ms, or null if not yet measured */
+	rttMs: number | null;
+	/** When the current token expires, or null if unknown */
+	tokenExpiresAt: Date | null;
 }
-export type ConnectionStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+export type ConnectionStatus = "connecting" | "connected" | "reconnecting" | "closed" | "error";
 /** Discovered edge information */
 export interface EdgeInfo {
-    edgeId: string;
-    name?: string;
-    labels?: Record<string, string>;
-    services?: string[];
-    status?: string;
+	edgeId: string;
+	name?: string;
+	labels?: Record<string, string>;
+	services?: string[];
+	status?: string;
 }
 /** Bidirectional raw byte channel between browser and edge. */
 export interface Channel {
-    /** Unique channel identifier (e.g., "ch_abc123") */
-    readonly id: string;
-    /** Send raw bytes to the other side. Returns false if backpressure is active. */
-    write(data: Uint8Array): boolean;
-    /** Register handler for incoming raw bytes */
-    onData(handler: (data: Uint8Array) => void): void;
-    /** Close the channel (either side can initiate) */
-    close(): void;
-    /** Called when the channel closes (by either side). Supports multiple handlers. */
-    onClose(handler: (reason?: string) => void): void;
-    /** Send a JSON-serializable control message out-of-band */
-    sendControl(msg: unknown): void;
-    /** Register handler for incoming control messages */
-    onControl(handler: (msg: unknown) => void): void;
-    /** True if channel is open */
-    readonly isOpen: boolean;
-    /** Promise that resolves when the channel closes */
-    readonly closed: Promise<void>;
-    /** Number of bytes queued for sending */
-    readonly bufferedAmount: number;
-    /** Register handler called when buffered data has been flushed */
-    onDrain(handler: () => void): void;
+	/** Unique channel identifier (e.g., "ch_abc123") */
+	readonly id: string;
+	/** Send raw bytes to the other side. Returns false if backpressure is active. */
+	write(data: Uint8Array): boolean;
+	/** Register handler for incoming raw bytes */
+	onData(handler: (data: Uint8Array) => void): void;
+	/** Close the channel (either side can initiate) */
+	close(): void;
+	/** Called when the channel closes (by either side). Supports multiple handlers. */
+	onClose(handler: (reason?: string) => void): void;
+	/** Send a JSON-serializable control message out-of-band */
+	sendControl(msg: unknown): void;
+	/** Register handler for incoming control messages */
+	onControl(handler: (msg: unknown) => void): void;
+	/** True if channel is open */
+	readonly isOpen: boolean;
+	/** Promise that resolves when the channel closes */
+	readonly closed: Promise<void>;
+	/** Number of bytes queued for sending */
+	readonly bufferedAmount: number;
+	/** Register handler called when buffered data has been flushed */
+	onDrain(handler: () => void): void;
 }
 /** Options for opening a channel. */
 export interface ChannelOptions {
-    /** Called when the channel encounters an error. */
-    onError?: (err: Error) => void;
+	/** Called when the channel encounters an error. */
+	onError?: (err: Error) => void;
 }
-//# sourceMappingURL=types.d.ts.map
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-web",
-  "version": "2.24.0",
+  "version": "2.24.1",
   "description": "Browser SDK for Dink edge mesh platform via NATS WebSocket",
   "type": "module",
   "main": "dist/index.js",
@@ -30,7 +30,7 @@
     }
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && dts-bundle-generator --config dts-bundle.config.json --no-banner",
     "clean": "rm -rf dist",
     "prebuild": "npm run clean",
     "prepublishOnly": "npm run build",
@@ -73,6 +73,7 @@
   "devDependencies": {
     "@types/node": "^20.10.0",
     "@types/react": "^19.2.14",
+    "dts-bundle-generator": "^9.5.1",
     "typescript": "^5.3.0"
   },
   "engines": {

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,eAAe,EAEf,QAAQ,EACR,OAAO,EACP,cAAc,EACd,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,aAAa;IAClD,OAAO,CAAC,EAAE,CAA+B;IACzC,OAAO,CAAC,MAAM,CAA2E;IACzF,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,YAAY,CAA+C;gBAEvD,MAAM,EAAE,aAAa;IAQjC,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,oCAAoC;IACpC,IAAI,KAAK,IAAI,eAAe,CAO3B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,IAAI,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACN,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,IAAI,EACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACN,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;;;;;OAUG;IACG,SAAS,CAAC,GAAG,EAAE,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC7B,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,kBAAkB,CAAC;IAgG9B;;;;;;OAMG;IACG,YAAY,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,EACnC,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,kBAAkB,CAAC;IA0E9B;;;;;;;;;;;OAWG;IACG,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC;IAmKnB;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUvB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC;IAMxF,OAAO,CAAC,oBAAoB;YAiBd,YAAY;IAwC1B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;CAGd"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,cAAc,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/react.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAON,KAAK,SAAS,EAEd,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,OAAO,EACP,cAAc,EACd,MAAM,YAAY,CAAC;AAIpB,UAAU,mBAAmB;IAC5B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC;CACvB;AAMD,MAAM,WAAW,oBAAoB;IACpC,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC/B,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACR,EAAE,oBAAoB,uGA4DtB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAMhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,CAAC,GACvD,CAAC,GAAG,IAAI,CAOV;AAKD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACxD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB;IAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAwDnE"}

package/dist/types.d.ts.map

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