@mateosuarezdev/brpc 1.0.84 → 1.0.85

package/README.md

@@ -662,9 +662,12 @@ unsubscribe();
 
 Subscriptions wait for WebSocket authentication by default. Public feeds can subscribe immediately while auth is refreshing with `{ auth: "none" }`.
 
+The React `useSubscription` options also accept `enabled`. Set it to `false` to skip subscription setup; changing it back to `true` attaches the topic again, and disabling or unmounting cleans it up.
+
 ### Dynamic Client Route Params
 
 Pass dynamic route values through the second options object. Client inputs stay separate from path params, and the resolved path is used for transport and cache-key identity.
+The client infers every `:param` segment in the route and requires the complete `params` object for dynamic routes.
 
 ```ts
 await client.routes.users[":userId"].query(
@@ -782,14 +785,13 @@ function ChatRoom({ roomId }: { roomId: string }) {
   const [messages, setMessages] = useState<Message[]>([]);
 
   const { publish } = useSubscription(
-    (callback) =>
-      client.routes.messages[":roomId"].subscription(callback, {
-        params: { roomId },
-      }),
+    (callback, options) =>
+      client.routes.messages[":roomId"].subscription(callback, options),
     (error, message) => {
       if (error || !message) return;
       setMessages((prev) => [...prev, message]);
     },
+    { params: { roomId } },
   );
 
   return (

package/dist/client/index.js

@@ -1,4 +1,4 @@
 // @bun
-function m(q){return(J)=>{if(!J)return null;return`${q}/${J}`}}class O extends Error{status;code;clientCode;data;constructor(q,J,X,N,I){super(q);this.name="BrpcClientError",this.status=J,this.code=X,this.clientCode=N,this.data=I}isClientError(q){return this.clientCode===q}isUnauthorized(){return this.status===401}isForbidden(){return this.status===403}isNotFound(){return this.status===404}isValidationError(){return this.status===400||this.code==="BAD_REQUEST"}}class f extends O{type;constructor(q,J){super(J.message??"WebSocket request failed",J.httpStatus??0,J.code,J.clientCode,J.data);this.name="BrpcClientSubscriptionError",this.type=q}}var h=(q)=>{return q instanceof File||q instanceof Blob||typeof q==="object"&&q!==null&&"uri"in q&&"name"in q&&"type"in q};function y(q){if(!q)return null;return q.replace(/\//g,"")}function c(q){let J=q&&q.length>0?q:typeof window<"u"?window.location.origin:"";return J=J.endsWith("/")?J.slice(0,-1):J,J}function d(q,J){let X=J?`/${J}/ws`:"/ws";return`${q.replace(/^http/,"ws")}${X}`}function u(q,J){if(q&&J)return`/${q}/${J}`;else if(q&&!J)return`/${q}`;else if(!q&&J)return`/${J}`;else return""}class b{baseUrl;ws=null;subscriptions=new Map;messageQueue=[];isConnected=!1;reconnectTimeout=null;WebSocketImpl;getHeaders;authToken=null;debug;pendingAuth=!1;authActions=[];constructor(q,J,X,N=!1,I){this.baseUrl=q;this.WebSocketImpl=J,this.debug=N&&I==="development",this.getHeaders=async()=>{if(typeof X==="function")return await X();return X??{}},this.connect()}startTopicSubscription(q){let J=this.subscriptions.get(q);if(!J)return;if(J.status="pending",J.auth==="required"&&this.pendingAuth){this.authActions.push(()=>this.startTopicSubscription(q));return}this.send({type:"subscribe",topic:q},{allowDuringPendingAuth:J.auth==="none"})}async connect(){try{let q=await this.getHeaders();this.authToken=q.Authorization||null;let J=this.baseUrl;if(this.debug)console.log(`Connecting to WebSocket: ${J}`);this.ws=new this.WebSocketImpl(J),this.ws.onopen=async()=>{if(this.debug)console.log("WebSocket connection established");if(this.isConnected=!0,this.authActions=[],this.authToken){if(this.pendingAuth=!0,this.send({type:"authenticate",token:this.authToken}),this.debug)console.log("Sent authentication token, waiting for response");for(let X of this.subscriptions.keys())this.startTopicSubscription(X);this.authActions.push(()=>{if(this.messageQueue.length>0&&this.debug)console.log(`Sending ${this.messageQueue.length} queued messages`);this.messageQueue.forEach((X)=>this.send(X)),this.messageQueue=[]})}else{for(let X of this.subscriptions.keys())this.startTopicSubscription(X);if(this.messageQueue.length>0&&this.debug)console.log(`Sending ${this.messageQueue.length} queued messages`);this.messageQueue.forEach((X)=>this.send(X)),this.messageQueue=[]}},this.ws.onmessage=(X)=>{try{if(this.debug)console.log("WebSocket message received:",X.data);let N=JSON.parse(X.data);if(N.type==="auth_success"){let I=N.authenticated!==!1;if(this.debug)console.log(`WebSocket ${I?"authentication":"deauthentication"} successful`);if(this.pendingAuth=!1,I)this.authActions.forEach((T)=>T());this.authActions=[];return}if(N.type==="auth_error"){console.error("WebSocket authentication failed:",this.createClientError(N.error)),this.pendingAuth=!1,this.authActions=[];return}if(this.debug)console.log("Got new message",N);if(N.type==="subscribe_success"&&N.topic&&this.subscriptions.has(N.topic))this.subscriptions.get(N.topic).status="subscribed";else if(N.type==="publish"&&N.topic&&this.subscriptions.has(N.topic)){let{callbacks:I}=this.subscriptions.get(N.topic);if(this.debug)console.log("Calling subscription callbacks");I?.forEach((T)=>T(void 0,N.data))}else if(["subscribe_error","publish_error"].includes(N.type)&&N.topic&&this.subscriptions.has(N.topic)){let I=this.createSubscriptionError(N.type,N.error),T=this.subscriptions.get(N.topic);T.status="failed",T.callbacks.forEach((C)=>C(I))}else if(N.type==="unsubscribe_error")console.error(`WebSocket unsubscribe failed for topic ${N.topic??"unknown"}:`,this.createClientError(N.error));else if(N.error)console.error("WebSocket error:",this.createClientError(N.error));else console.warn("Unhandled WebSocket message format:",N)}catch(N){if(this.debug)console.error("Error processing WebSocket message:",N),console.error("Raw message:",X.data)}},this.ws.onclose=(X)=>{if(this.isConnected=!1,this.pendingAuth=!1,this.subscriptions.forEach((N)=>{N.status="stale"}),this.debug)console.log(`WebSocket connection closed. Code: ${X.code}, Reason: ${X.reason}`);this.reconnectTimeout=setTimeout(()=>this.connect(),2000)},this.ws.onerror=(X)=>{if(this.debug)console.log("WebSocket error:",X)}}catch(q){if(this.debug)console.log("Failed to create WebSocket connection:",q);this.pendingAuth=!1,this.reconnectTimeout=setTimeout(()=>this.connect(),2000)}}createClientError(q){return new O(q?.message??"WebSocket request failed",q?.httpStatus??0,q?.code,q?.clientCode,q?.data)}createSubscriptionError(q,J){return new f(q,J??{})}disconnect(){if(this.reconnectTimeout)clearTimeout(this.reconnectTimeout),this.reconnectTimeout=null;if(this.ws)this.ws.close(),this.ws=null;this.isConnected=!1,this.pendingAuth=!1,this.authActions=[],this.subscriptions.clear()}send(q,J={}){if(this.isConnected&&this.ws?.readyState===this.WebSocketImpl.OPEN){if(this.pendingAuth&&q.type!=="authenticate"&&!J.allowDuringPendingAuth){if(this.messageQueue.push(q),this.debug)console.log("Message queued until authentication completes:",q);return}let X=JSON.stringify(q);if(this.ws.send(X),this.debug)console.log("WebSocket message sent:",X)}else if(this.messageQueue.push(q),this.debug)console.log("WebSocket message queued (not connected):",q)}subscribe(q,J,X={}){let N=this.subscriptions.get(q);if(!N){if(N={auth:X.auth??"required",callbacks:new Set,status:"pending"},this.subscriptions.set(q,N),N.callbacks.add(J),this.isConnected)this.startTopicSubscription(q)}else N.callbacks.add(J);return{unsubscribe:()=>this.unsubscribe(q,J),publish:(I)=>this.publish(q,I,J)}}unsubscribe(q,J){let X=this.subscriptions.get(q);if(X){if(X.callbacks.delete(J),X.callbacks.size===0){if(this.subscriptions.delete(q),this.send({type:"unsubscribe",topic:q}),this.debug)console.log(`Unsubscribed from topic: ${q}`)}}}publish(q,J,X){let N=this.subscriptions.get(q);if(N?.status!=="subscribed"){X(this.createSubscriptionError("publish_error",{message:"Cannot publish to a topic that is not subscribed",code:"SUBSCRIPTION_NOT_SUBSCRIBED",clientCode:"SUBSCRIPTION_NOT_SUBSCRIBED",data:{status:N?.status??"unsubscribed"}}));return}if(this.send({type:"publish",topic:q,data:J}),this.debug)console.log(`Published to topic: ${q}`,J)}async updateAuth(){let J=(await this.getHeaders()).Authorization||"",X=J.startsWith("Bearer ")?J.substring(7).trim():J.trim(),N=X.length>0,I=this.authToken!==null&&this.authToken.trim().length>0;if((N!==I||X!==this.authToken)&&this.isConnected){if(this.authToken=X,this.pendingAuth=N,this.send({type:"authenticate",token:J}),this.debug)if(N)console.log("Updated authentication token, waiting for confirmation");else console.log("Sent empty token for deauthentication"),this.pendingAuth=!1,this.authActions=[]}}}function jq(q,J={}){let X=J.fetch||fetch,N=J.WebSocket??(typeof WebSocket<"u"?WebSocket:null),I=J.prefix??"",T=J.apiPrefix??"",C=J.debug??!1,n=J.s3Endpoint,l=J.nodeEnv;if(!J.s3Endpoint)throw Error("BRPC Client: Pass s3Endpoint option to createBrpcClient");if(!J.nodeEnv)throw Error("BRPC Client: Pass nodeEnv option to createBrpcClient");if(!N)throw Error("WebSocket is not available in this environment");let w=J.headers??{},p=async()=>{if(typeof w==="function")return await w();return w},H=c(q),k=y(J.prefix),i=y(J.apiPrefix),K=u(k,i),g=d(H,k),E=new b(g,N,w,C,l),U=async(Y=!0)=>{let M={};if(Y)M["Content-Type"]="application/json";let Q=await p();return{...M,...Q}},o=async(Y)=>{if(!Y.ok){let Q;try{Q=await Y.json()}catch{try{Q={error:await Y.text()}}catch{Q={error:"Failed to parse error response"}}}if(Q?.error&&typeof Q.error==="object"){let F=Q.error;throw new O(F.message||Y.statusText,Y.status,F.code,F.clientCode,F.data)}let z=Q?.error||Q?.message||Y.statusText;throw new O(z,Y.status,void 0,void 0,Q)}let M=Y.headers.get("Content-Type")||"";try{if(M.includes("application/json"))return(await Y.json()).data;else if(M.includes("text/"))return Y.text();else return Y.blob()}catch(Q){throw new O(`Failed to parse response: ${Q instanceof Error?Q.message:"Unknown error"}`,Y.status,"PARSE_ERROR")}},x=async(Y,M)=>{try{let Q=await X(Y,M);return await o(Q)}catch(Q){if(Q instanceof O)throw Q;throw new O(Q instanceof Error?Q.message:"Network request failed",0,"NETWORK_ERROR")}},B=(Y,M)=>{return Y.split("/").map((Q)=>{if(!Q.startsWith(":"))return Q;let z=Q.slice(1),F=M?.[z];if(F===void 0||F===null)throw new O(`Missing route parameter: ${z}`,400,"MISSING_ROUTE_PARAM","MISSING_ROUTE_PARAM",{param:z});return encodeURIComponent(String(F))}).join("/")},v=(Y=[])=>{return new Proxy({},{get(M,Q){if(typeof Q==="symbol")return;if(Q==="query"||Q==="mutation"||Q==="formMutation"||Q==="subscription"||Q==="getStringKey"||Q==="getArrayKey"||Q==="getNoInputsArrayKey"){let z=Y.join("/"),F=(Z)=>`${H}${K}/${Z}`;if(C)console.log(`BRPC ${Q} procedure path: ${z}`);if(Q==="query")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!0);if(C)console.log(`BRPC query request to ${_}`,{input:Z,headers:j});let G=new URL(F(_));if(Z&&typeof Z==="object")Object.entries(Z).forEach(([V,$])=>{if($!==void 0)G.searchParams.append(V,String($))});let W=await x(G.toString(),{method:"GET",headers:j,credentials:"include"});if(C)console.log(`BRPC query response from ${_}:`,W);return W};else if(Q==="mutation")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!0);if(C)console.log(`BRPC mutation request to ${_}`,{input:Z,headers:j});let G=JSON.stringify(Z),W=await x(F(_),{method:"POST",headers:j,body:G,credentials:"include"});if(C)console.log(`BRPC mutation response from ${_}:`,W);return W};else if(Q==="formMutation")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!1);if(C)console.log(`BRPC formMutation request to ${_}`,{input:Z,headers:j});let G=new FormData,W=($,L,P)=>{let D=P?`${P}[${$}]`:$;if(L===null||L===void 0)return;else if(h(L))G.append(D,L);else if(Array.isArray(L))L.forEach((A,S)=>{if(h(A))G.append(D,A);else if(typeof A==="object"&&A!==null)Object.entries(A).forEach(([a,s])=>{W(a,s,`${D}[${S}]`)});else G.append(`${D}[${S}]`,String(A))});else if(typeof L==="object"&&L!==null)Object.entries(L).forEach(([A,S])=>{W(A,S,D)});else G.append(D,String(L))};Object.entries(Z).forEach(([$,L])=>{W($,L)});let V=await x(F(_),{method:"POST",headers:j,body:G,credentials:"include"});if(C)console.log(`BRPC formMutation response from ${_}:`,V);return V};else if(Q==="subscription")return(Z,R={})=>{let _=B(z,R.params);if(C)console.log(`BRPC subscription to ${_}`);let j=K?`${K.slice(1)}/${_}`:_;return E.updateAuth(),E.subscribe(j,Z,R)};else if(Q==="getStringKey")return(Z,R={})=>{let _=B(z,R.params);if(!Z||Object.keys(Z).length===0)return _;let j=Object.keys(Z).sort().reduce((W,V)=>{let $=Z[V];if($!==void 0&&$!==null)W[V]=$;return W},{});if(Object.keys(j).length===0)return _;let G=JSON.stringify(j);return`${_}?${G}`};else if(Q==="getArrayKey")return(Z,R={})=>{let _=B(z,R.params),j=Z??{};if(Object.keys(j).length===0)return[_];let G=[];if(Object.keys(j).sort().forEach((V)=>{let $=j[V];if($!==void 0&&$!==null){let L=$;if(typeof $==="boolean"||typeof $==="number")L=String($);else if(typeof $==="object")L=JSON.stringify($);G.push([V,L])}}),G.length===0)return[_];let W=G.flatMap(([V,$])=>[V,$]);return[_,...W]};else if(Q==="getNoInputsArrayKey")return(Z={})=>{return[B(z,Z.params)]}}return v([...Y,Q])}})},t=v();if(C)console.log("BRPC client created",{baseUrl:H,prefix:K,wsUrl:g});return{routes:t,storage:{getObjectUrl:m(n)},utils:{updateWsAuth:async()=>await E.updateAuth(),setHeader:async(Y,M)=>{if(typeof w==="function"){console.warn("Cannot use setHeader with function-based headers resolver");return}w={...w,[Y]:M},await E.updateAuth()},setHeaders:async(Y)=>{if(typeof w==="function"){console.warn("Cannot use setHeaders with function-based headers resolver");return}w={...w,...Y},await E.updateAuth()}}}}export{m as createGetObjectUrl,jq as createBrpcClient,f as BrpcClientSubscriptionError,O as BrpcClientError};
+function c(q){return(J)=>{if(!J)return null;return`${q}/${J}`}}class O extends Error{status;code;clientCode;data;constructor(q,J,X,N,I){super(q);this.name="BrpcClientError",this.status=J,this.code=X,this.clientCode=N,this.data=I}isClientError(q){return this.clientCode===q}isUnauthorized(){return this.status===401}isForbidden(){return this.status===403}isNotFound(){return this.status===404}isValidationError(){return this.status===400||this.code==="BAD_REQUEST"}}class f extends O{type;constructor(q,J){super(J.message??"WebSocket request failed",J.httpStatus??0,J.code,J.clientCode,J.data);this.name="BrpcClientSubscriptionError",this.type=q}}var h=(q)=>{return q instanceof File||q instanceof Blob||typeof q==="object"&&q!==null&&"uri"in q&&"name"in q&&"type"in q};function y(q){if(!q)return null;return q.replace(/\//g,"")}function d(q){let J=q&&q.length>0?q:typeof window<"u"?window.location.origin:"";return J=J.endsWith("/")?J.slice(0,-1):J,J}function u(q,J){let X=J?`/${J}/ws`:"/ws";return`${q.replace(/^http/,"ws")}${X}`}function n(q,J){if(q&&J)return`/${q}/${J}`;else if(q&&!J)return`/${q}`;else if(!q&&J)return`/${J}`;else return""}class b{baseUrl;ws=null;subscriptions=new Map;messageQueue=[];isConnected=!1;reconnectTimeout=null;WebSocketImpl;getHeaders;authToken=null;debug;pendingAuth=!1;authActions=[];constructor(q,J,X,N=!1,I){this.baseUrl=q;this.WebSocketImpl=J,this.debug=N&&I==="development",this.getHeaders=async()=>{if(typeof X==="function")return await X();return X??{}},this.connect()}startTopicSubscription(q){let J=this.subscriptions.get(q);if(!J)return;if(J.status="pending",J.auth==="required"&&this.pendingAuth){this.authActions.push(()=>this.startTopicSubscription(q));return}this.send({type:"subscribe",topic:q},{allowDuringPendingAuth:J.auth==="none"})}async connect(){try{let q=await this.getHeaders();this.authToken=q.Authorization||null;let J=this.baseUrl;if(this.debug)console.log(`Connecting to WebSocket: ${J}`);this.ws=new this.WebSocketImpl(J),this.ws.onopen=async()=>{if(this.debug)console.log("WebSocket connection established");if(this.isConnected=!0,this.authActions=[],this.authToken){if(this.pendingAuth=!0,this.send({type:"authenticate",token:this.authToken}),this.debug)console.log("Sent authentication token, waiting for response");for(let X of this.subscriptions.keys())this.startTopicSubscription(X);this.authActions.push(()=>{if(this.messageQueue.length>0&&this.debug)console.log(`Sending ${this.messageQueue.length} queued messages`);this.messageQueue.forEach((X)=>this.send(X)),this.messageQueue=[]})}else{for(let X of this.subscriptions.keys())this.startTopicSubscription(X);if(this.messageQueue.length>0&&this.debug)console.log(`Sending ${this.messageQueue.length} queued messages`);this.messageQueue.forEach((X)=>this.send(X)),this.messageQueue=[]}},this.ws.onmessage=(X)=>{try{if(this.debug)console.log("WebSocket message received:",X.data);let N=JSON.parse(X.data);if(N.type==="auth_success"){let I=N.authenticated!==!1;if(this.debug)console.log(`WebSocket ${I?"authentication":"deauthentication"} successful`);if(this.pendingAuth=!1,I)this.authActions.forEach((T)=>T());this.authActions=[];return}if(N.type==="auth_error"){console.error("WebSocket authentication failed:",this.createClientError(N.error)),this.pendingAuth=!1,this.authActions=[];return}if(this.debug)console.log("Got new message",N);if(N.type==="subscribe_success"&&N.topic&&this.subscriptions.has(N.topic))this.subscriptions.get(N.topic).status="subscribed";else if(N.type==="publish"&&N.topic&&this.subscriptions.has(N.topic)){let{callbacks:I}=this.subscriptions.get(N.topic);if(this.debug)console.log("Calling subscription callbacks");I?.forEach((T)=>T(void 0,N.data))}else if(["subscribe_error","publish_error"].includes(N.type)&&N.topic&&this.subscriptions.has(N.topic)){let I=this.createSubscriptionError(N.type,N.error),T=this.subscriptions.get(N.topic);T.status="failed",T.callbacks.forEach((C)=>C(I))}else if(N.type==="unsubscribe_error")console.error(`WebSocket unsubscribe failed for topic ${N.topic??"unknown"}:`,this.createClientError(N.error));else if(N.error)console.error("WebSocket error:",this.createClientError(N.error));else console.warn("Unhandled WebSocket message format:",N)}catch(N){if(this.debug)console.error("Error processing WebSocket message:",N),console.error("Raw message:",X.data)}},this.ws.onclose=(X)=>{if(this.isConnected=!1,this.pendingAuth=!1,this.subscriptions.forEach((N)=>{N.status="stale"}),this.debug)console.log(`WebSocket connection closed. Code: ${X.code}, Reason: ${X.reason}`);this.reconnectTimeout=setTimeout(()=>this.connect(),2000)},this.ws.onerror=(X)=>{if(this.debug)console.log("WebSocket error:",X)}}catch(q){if(this.debug)console.log("Failed to create WebSocket connection:",q);this.pendingAuth=!1,this.reconnectTimeout=setTimeout(()=>this.connect(),2000)}}createClientError(q){return new O(q?.message??"WebSocket request failed",q?.httpStatus??0,q?.code,q?.clientCode,q?.data)}createSubscriptionError(q,J){return new f(q,J??{})}disconnect(){if(this.reconnectTimeout)clearTimeout(this.reconnectTimeout),this.reconnectTimeout=null;if(this.ws)this.ws.close(),this.ws=null;this.isConnected=!1,this.pendingAuth=!1,this.authActions=[],this.subscriptions.clear()}send(q,J={}){if(this.isConnected&&this.ws?.readyState===this.WebSocketImpl.OPEN){if(this.pendingAuth&&q.type!=="authenticate"&&!J.allowDuringPendingAuth){if(this.messageQueue.push(q),this.debug)console.log("Message queued until authentication completes:",q);return}let X=JSON.stringify(q);if(this.ws.send(X),this.debug)console.log("WebSocket message sent:",X)}else if(this.messageQueue.push(q),this.debug)console.log("WebSocket message queued (not connected):",q)}subscribe(q,J,X={}){let N=this.subscriptions.get(q);if(!N){if(N={auth:X.auth??"required",callbacks:new Set,status:"pending"},this.subscriptions.set(q,N),N.callbacks.add(J),this.isConnected)this.startTopicSubscription(q)}else N.callbacks.add(J);return{unsubscribe:()=>this.unsubscribe(q,J),publish:(I)=>this.publish(q,I,J)}}unsubscribe(q,J){let X=this.subscriptions.get(q);if(X){if(X.callbacks.delete(J),X.callbacks.size===0){if(this.subscriptions.delete(q),this.send({type:"unsubscribe",topic:q}),this.debug)console.log(`Unsubscribed from topic: ${q}`)}}}publish(q,J,X){let N=this.subscriptions.get(q);if(N?.status!=="subscribed"){X(this.createSubscriptionError("publish_error",{message:"Cannot publish to a topic that is not subscribed",code:"SUBSCRIPTION_NOT_SUBSCRIBED",clientCode:"SUBSCRIPTION_NOT_SUBSCRIBED",data:{status:N?.status??"unsubscribed"}}));return}if(this.send({type:"publish",topic:q,data:J}),this.debug)console.log(`Published to topic: ${q}`,J)}async updateAuth(){let J=(await this.getHeaders()).Authorization||"",X=J.startsWith("Bearer ")?J.substring(7).trim():J.trim(),N=X.length>0,I=this.authToken!==null&&this.authToken.trim().length>0;if((N!==I||X!==this.authToken)&&this.isConnected){if(this.authToken=X,this.pendingAuth=N,this.send({type:"authenticate",token:J}),this.debug)if(N)console.log("Updated authentication token, waiting for confirmation");else console.log("Sent empty token for deauthentication"),this.pendingAuth=!1,this.authActions=[]}}}function jq(q,J={}){let X=J.fetch||fetch,N=J.WebSocket??(typeof WebSocket<"u"?WebSocket:null),I=J.prefix??"",T=J.apiPrefix??"",C=J.debug??!1,l=J.s3Endpoint,p=J.nodeEnv;if(!J.s3Endpoint)throw Error("BRPC Client: Pass s3Endpoint option to createBrpcClient");if(!J.nodeEnv)throw Error("BRPC Client: Pass nodeEnv option to createBrpcClient");if(!N)throw Error("WebSocket is not available in this environment");let w=J.headers??{},k=async()=>{if(typeof w==="function")return await w();return w},H=d(q),g=y(J.prefix),i=y(J.apiPrefix),K=n(g,i),P=u(H,g),E=new b(P,N,k,C,p),U=async(Y=!0)=>{let M={};if(Y)M["Content-Type"]="application/json";let Q=await k();return{...M,...Q}},o=async(Y)=>{if(!Y.ok){let Q;try{Q=await Y.json()}catch{try{Q={error:await Y.text()}}catch{Q={error:"Failed to parse error response"}}}if(Q?.error&&typeof Q.error==="object"){let F=Q.error;throw new O(F.message||Y.statusText,Y.status,F.code,F.clientCode,F.data)}let z=Q?.error||Q?.message||Y.statusText;throw new O(z,Y.status,void 0,void 0,Q)}let M=Y.headers.get("Content-Type")||"";try{if(M.includes("application/json"))return(await Y.json()).data;else if(M.includes("text/"))return Y.text();else return Y.blob()}catch(Q){throw new O(`Failed to parse response: ${Q instanceof Error?Q.message:"Unknown error"}`,Y.status,"PARSE_ERROR")}},x=async(Y,M)=>{try{let Q=await X(Y,M);return await o(Q)}catch(Q){if(Q instanceof O)throw Q;throw new O(Q instanceof Error?Q.message:"Network request failed",0,"NETWORK_ERROR")}},B=(Y,M)=>{return Y.split("/").map((Q)=>{if(!Q.startsWith(":"))return Q;let z=Q.slice(1),F=M?.[z];if(F===void 0||F===null)throw new O(`Missing route parameter: ${z}`,400,"MISSING_ROUTE_PARAM","MISSING_ROUTE_PARAM",{param:z});return encodeURIComponent(String(F))}).join("/")},m=(Y=[])=>{return new Proxy({},{get(M,Q){if(typeof Q==="symbol")return;if(Q==="query"||Q==="mutation"||Q==="formMutation"||Q==="subscription"||Q==="getStringKey"||Q==="getArrayKey"||Q==="getNoInputsArrayKey"){let z=Y.join("/"),F=(Z)=>`${H}${K}/${Z}`;if(C)console.log(`BRPC ${Q} procedure path: ${z}`);if(Q==="query")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!0);if(C)console.log(`BRPC query request to ${_}`,{input:Z,headers:j});let G=new URL(F(_));if(Z&&typeof Z==="object")Object.entries(Z).forEach(([V,$])=>{if($!==void 0)G.searchParams.append(V,String($))});let W=await x(G.toString(),{method:"GET",headers:j,credentials:"include"});if(C)console.log(`BRPC query response from ${_}:`,W);return W};else if(Q==="mutation")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!0);if(C)console.log(`BRPC mutation request to ${_}`,{input:Z,headers:j});let G=JSON.stringify(Z),W=await x(F(_),{method:"POST",headers:j,body:G,credentials:"include"});if(C)console.log(`BRPC mutation response from ${_}:`,W);return W};else if(Q==="formMutation")return async(Z,R={})=>{let _=B(z,R.params),j=await U(!1);if(C)console.log(`BRPC formMutation request to ${_}`,{input:Z,headers:j});let G=new FormData,W=($,L,v)=>{let D=v?`${v}[${$}]`:$;if(L===null||L===void 0)return;else if(h(L))G.append(D,L);else if(Array.isArray(L))L.forEach((A,S)=>{if(h(A))G.append(D,A);else if(typeof A==="object"&&A!==null)Object.entries(A).forEach(([a,s])=>{W(a,s,`${D}[${S}]`)});else G.append(`${D}[${S}]`,String(A))});else if(typeof L==="object"&&L!==null)Object.entries(L).forEach(([A,S])=>{W(A,S,D)});else G.append(D,String(L))};Object.entries(Z).forEach(([$,L])=>{W($,L)});let V=await x(F(_),{method:"POST",headers:j,body:G,credentials:"include"});if(C)console.log(`BRPC formMutation response from ${_}:`,V);return V};else if(Q==="subscription")return(Z,R={})=>{let _=B(z,R.params);if(C)console.log(`BRPC subscription to ${_}`);let j=K?`${K.slice(1)}/${_}`:_;return E.updateAuth(),E.subscribe(j,Z,R)};else if(Q==="getStringKey")return(Z,R={})=>{let _=B(z,R.params);if(!Z||Object.keys(Z).length===0)return _;let j=Object.keys(Z).sort().reduce((W,V)=>{let $=Z[V];if($!==void 0&&$!==null)W[V]=$;return W},{});if(Object.keys(j).length===0)return _;let G=JSON.stringify(j);return`${_}?${G}`};else if(Q==="getArrayKey")return(Z,R={})=>{let _=B(z,R.params),j=Z??{};if(Object.keys(j).length===0)return[_];let G=[];if(Object.keys(j).sort().forEach((V)=>{let $=j[V];if($!==void 0&&$!==null){let L=$;if(typeof $==="boolean"||typeof $==="number")L=String($);else if(typeof $==="object")L=JSON.stringify($);G.push([V,L])}}),G.length===0)return[_];let W=G.flatMap(([V,$])=>[V,$]);return[_,...W]};else if(Q==="getNoInputsArrayKey")return(Z={})=>{return[B(z,Z.params)]}}return m([...Y,Q])}})},t=m();if(C)console.log("BRPC client created",{baseUrl:H,prefix:K,wsUrl:P});return{routes:t,storage:{getObjectUrl:c(l)},utils:{updateWsAuth:async()=>await E.updateAuth(),setHeader:async(Y,M)=>{if(typeof w==="function"){console.warn("Cannot use setHeader with function-based headers resolver");return}w={...w,[Y]:M},await E.updateAuth()},setHeaders:async(Y)=>{if(typeof w==="function"){console.warn("Cannot use setHeaders with function-based headers resolver");return}w={...w,...Y},await E.updateAuth()}}}}export{c as createGetObjectUrl,jq as createBrpcClient,f as BrpcClientSubscriptionError,O as BrpcClientError};
 
-//# debugId=16BAF87F34BADF9264756E2164756E21
+//# debugId=6A275280D49BF12164756E2164756E21

package/dist/client/react/index.js

@@ -1,4 +1,4 @@
 // @bun
-import{useCallback as A,useEffect as B,useRef as D}from"react";function H(j,q){let m=D(null);return B(()=>{let{publish:x,unsubscribe:y}=j(q??((w,z)=>{if(w){console.error("BRPC subscription error:",w);return}console.log("New data received",z)}));return m.current=x,()=>{m.current=null,y()}},[j,q]),{publish:A((x)=>{m.current?.(x)},[])}}export{H as useSubscription};
+import{useCallback as B,useEffect as D,useRef as F}from"react";function I(q,w,x={}){let m=F(null);return D(()=>{if(x.enabled===!1){m.current=null;return}let{publish:j,unsubscribe:z}=q(w??((y,A)=>{if(y){console.error("BRPC subscription error:",y);return}console.log("New data received",A)}),x);return m.current=j,()=>{m.current=null,z()}},[q,w,x]),{publish:B((j)=>{m.current?.(j)},[])}}export{I as useSubscription};
 
-//# debugId=22280F97277F1D8B64756E2164756E21
+//# debugId=DBE7A95679FC784164756E2164756E21

package/dist/client/react/use-subscription.d.ts

@@ -1,14 +1,14 @@
-import type { SubscriptionCallback } from "../types";
+import type { RuntimeSubscriptionOptions, SubscriptionCallback } from "../types";
+export type UseSubscriptionOptions = RuntimeSubscriptionOptions & {
+    enabled?: boolean;
+};
 /**
- * Custom hook for managing brpc subscriptions
- * @param subscription A function that sets up a subscription and returns publish/unsubscribe handlers
- * @param callback Optional error-first callback for incoming data
- * @returns A stable publish function that can be called directly
+ * Connects React state to a BRPC subscription.
  */
-declare function useSubscription<TInput, TOutput>(subscription: (callback: SubscriptionCallback<TOutput>) => {
+declare function useSubscription<TInput, TOutput>(subscription: (callback: SubscriptionCallback<TOutput>, options?: RuntimeSubscriptionOptions) => {
     publish: (data: TInput) => void;
     unsubscribe: () => void;
-}, callback?: SubscriptionCallback<TOutput>): {
+}, callback?: SubscriptionCallback<TOutput>, options?: UseSubscriptionOptions): {
     publish: (data: TInput) => void;
 };
 export { useSubscription };

package/dist/client/types.d.ts

@@ -16,55 +16,58 @@ export type InferRouterOutput<T> = {
 };
 export type IsOptionalInput<T> = undefined extends InferProcedureInput<T> ? true : {} extends InferProcedureInput<T> & {} ? true : false;
 export type SubscriptionCallback<T> = (error: BrpcClientSubscriptionError | undefined, message?: T) => void;
-export type RouteParams = Record<string, string | number | boolean>;
-export type ProcedureCallOptions = {
+type RouteParamValue = string | number | boolean;
+type EmptyRouteParams = Record<never, never>;
+export type RouteParams = Record<string, RouteParamValue>;
+type HasRouteParams<TParams extends RouteParams> = keyof TParams extends never ? false : true;
+/**
+ * Options for one typed procedure call.
+ */
+export type ProcedureCallOptions<TParams extends RouteParams> = HasRouteParams<TParams> extends true ? {
+    params: TParams;
+} : {
+    params?: never;
+};
+/**
+ * Runtime options used internally before a concrete client route is inferred.
+ */
+export type RuntimeProcedureCallOptions = {
     params?: RouteParams;
 };
-export type SubscriptionOptions = ProcedureCallOptions & {
+export type SubscriptionOptions<TParams extends RouteParams> = ProcedureCallOptions<TParams> & {
+    auth?: "required" | "none";
+};
+export type RuntimeSubscriptionOptions = RuntimeProcedureCallOptions & {
     auth?: "required" | "none";
 };
 export type SubscriptionHandlers<InputType, _OutputType> = {
     unsubscribe: () => void;
     publish: (data: InputType) => void;
 };
-export type ProcedureMethods<T extends BaseProcedure> = T["_type"] extends "query" | "streamQuery" | "file" | "html" ? IsOptionalInput<T> extends true ? {
-    query: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : {
-    query: (input: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : T["_type"] extends "mutation" | "streamMutation" ? IsOptionalInput<T> extends true ? {
-    mutation: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : {
-    mutation: (input: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : T["_type"] extends "formMutation" ? IsOptionalInput<T> extends true ? {
-    formMutation: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : {
-    formMutation: (input: InferProcedureInput<T>, options?: ProcedureCallOptions) => Promise<InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => (string | number | boolean)[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => (string | number | boolean)[];
-} : T["_type"] extends "subscription" ? {
-    subscription: (callback: SubscriptionCallback<InferProcedureOutput<T>>, options?: SubscriptionOptions) => SubscriptionHandlers<InferProcedureInput<T>, InferProcedureOutput<T>>;
-    getStringKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string;
-    getArrayKey: (input?: InferProcedureInput<T>, options?: ProcedureCallOptions) => string[];
-    getNoInputsArrayKey: (options?: ProcedureCallOptions) => string[];
-} : never;
-export type InferClientRoutes<T> = {
-    [K in keyof T]: T[K] extends BaseProcedure ? ProcedureMethods<T[K]> : T[K] extends Record<string, any> ? InferClientRoutes<T[K]> : never;
+type CallOptionsArgs<TParams extends RouteParams> = HasRouteParams<TParams> extends true ? [options: ProcedureCallOptions<TParams>] : [options?: ProcedureCallOptions<TParams>];
+type SubscriptionOptionsArgs<TParams extends RouteParams> = HasRouteParams<TParams> extends true ? [options: SubscriptionOptions<TParams>] : [options?: SubscriptionOptions<TParams>];
+type InputCallArgs<T extends BaseProcedure, TParams extends RouteParams> = HasRouteParams<TParams> extends true ? IsOptionalInput<T> extends true ? [input: InferProcedureInput<T> | undefined, ...CallOptionsArgs<TParams>] : [input: InferProcedureInput<T>, ...CallOptionsArgs<TParams>] : IsOptionalInput<T> extends true ? [input?: InferProcedureInput<T>, ...CallOptionsArgs<TParams>] : [input: InferProcedureInput<T>, ...CallOptionsArgs<TParams>];
+type CacheKeyMethods<T extends BaseProcedure, TParams extends RouteParams> = {
+    getStringKey: (...args: InputCallArgs<T, TParams>) => string;
+    getArrayKey: (...args: InputCallArgs<T, TParams>) => (string | number | boolean)[];
+    getNoInputsArrayKey: (...args: CallOptionsArgs<TParams>) => (string | number | boolean)[];
+};
+type QueryMethods<T extends BaseProcedure, TParams extends RouteParams> = {
+    query: (...args: InputCallArgs<T, TParams>) => Promise<InferProcedureOutput<T>>;
+};
+type MutationMethods<T extends BaseProcedure, TParams extends RouteParams> = {
+    mutation: (...args: InputCallArgs<T, TParams>) => Promise<InferProcedureOutput<T>>;
+};
+type FormMutationMethods<T extends BaseProcedure, TParams extends RouteParams> = {
+    formMutation: (...args: InputCallArgs<T, TParams>) => Promise<InferProcedureOutput<T>>;
+};
+type SubscriptionMethods<T extends BaseProcedure, TParams extends RouteParams> = {
+    subscription: (callback: SubscriptionCallback<InferProcedureOutput<T>>, ...args: SubscriptionOptionsArgs<TParams>) => SubscriptionHandlers<InferProcedureInput<T>, InferProcedureOutput<T>>;
+};
+export type ProcedureMethods<T extends BaseProcedure, TParams extends RouteParams = EmptyRouteParams> = T["_type"] extends "query" | "streamQuery" | "file" | "html" ? QueryMethods<T, TParams> & CacheKeyMethods<T, TParams> : T["_type"] extends "mutation" | "streamMutation" ? MutationMethods<T, TParams> & CacheKeyMethods<T, TParams> : T["_type"] extends "formMutation" ? FormMutationMethods<T, TParams> & CacheKeyMethods<T, TParams> : T["_type"] extends "subscription" ? SubscriptionMethods<T, TParams> & CacheKeyMethods<T, TParams> : never;
+type RouteParamsForKey<TParams extends RouteParams, TKey extends string> = TKey extends `:${infer TParamName}` ? TParams & Record<TParamName, RouteParamValue> : TParams;
+export type InferClientRoutes<T, TParams extends RouteParams = EmptyRouteParams> = {
+    [K in keyof T]: K extends string ? T[K] extends BaseProcedure ? ProcedureMethods<T[K], RouteParamsForKey<TParams, K>> : T[K] extends Record<string, any> ? InferClientRoutes<T[K], RouteParamsForKey<TParams, K>> : never : never;
 };
 export interface BrpcClientOptions {
     /**
@@ -85,7 +88,7 @@ export interface BrpcClientOptions {
      */
     prefix?: string;
     /**
-     * API path prefix. Will be prepended to all procedure and topic paths.
+     * API path prefix. Will be prepended to all procedure URLs only.
      * Example: "/api" for "https://example.com/api/procedure"
      */
     apiPrefix?: string;
@@ -107,10 +110,7 @@ export interface BrpcClientOptions {
     nodeEnv?: string;
 }
 /**
- * Creates a type-safe client for the BRPC API
- * @param baseUrl The base URL of the BRPC server
- * @param options Client configuration options
- * @returns A client object that mirrors the server routes
+ * Creates a type-safe client for the BRPC API.
  */
 export type BrpcClient<T> = {
     routes: InferClientRoutes<T>;
@@ -125,3 +125,4 @@ export type BrpcClient<T> = {
 };
 export type Headers = Record<string, string>;
 export type HeadersResolver = Headers | (() => Promise<Headers> | Headers);
+export {};

package/dist/client/ws-manager.d.ts

@@ -1,4 +1,4 @@
-import type { HeadersResolver, SubscriptionCallback, SubscriptionOptions } from "./types";
+import type { HeadersResolver, SubscriptionCallback, RuntimeSubscriptionOptions } from "./types";
 declare class WebSocketManager {
     private baseUrl;
     private ws;
@@ -24,7 +24,7 @@ declare class WebSocketManager {
     send(message: any, options?: {
         allowDuringPendingAuth?: boolean;
     }): void;
-    subscribe(topic: string, callback: SubscriptionCallback<any>, options?: SubscriptionOptions): {
+    subscribe(topic: string, callback: SubscriptionCallback<any>, options?: RuntimeSubscriptionOptions): {
         unsubscribe: () => void;
         publish: (data: any) => void;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mateosuarezdev/brpc",
-  "version": "1.0.84",
+  "version": "1.0.85",
   "description": "A Type-Safe, Flexible Web application framework for Bun",
   "type": "module",
   "main": "./dist/index.cjs",