@hfunlabs/hypurr-connect 0.1.21 → 0.1.22

package/README.md

@@ -44,6 +44,7 @@ pnpm add @hfunlabs/hyperliquid @protobuf-ts/grpcweb-transport @protobuf-ts/runti
 import { HypurrConnectProvider } from "@hfunlabs/hypurr-connect";
 
 const config = {
+  client_id: "your-client-id",
   isTestnet: false,
   grpcUrl: "https://grpc.hypurr.fun",
   telegram: {
@@ -118,6 +119,7 @@ function AppShell() {
 
 ```typescript
 interface HypurrConnectConfig {
+  client_id: string; // Auth hub client identifier
   grpcUrl?: string; // gRPC-web base URL (default: https://grpc.hypurr.fun)
   mediaUrl?: string; // Media base URL (default: https://media.hypurr.fun)
   grpcTimeout?: number; // Request timeout in ms (default: 15000)
@@ -144,8 +146,8 @@ for generated protobuf service clients.
 ### Telegram Login
 
 1. User clicks "Telegram" in the `LoginModal`.
-2. The SDK opens the configured auth hub in a popup with `return_to`, `state`,
-   and requested `scope`.
+2. The SDK opens the configured auth hub in a popup with `client_id`,
+   `return_to`, `state`, and requested `scope`.
 3. The auth hub performs Telegram login and redirects back to `return_to` with
    a scoped JWT.
 4. The popup callback page posts `{ token, state }` to the opener with
@@ -579,8 +581,8 @@ Creates a gRPC-Web client for the Telegram service.
 
 Creates a gRPC-Web client for the Static service.
 
-Both use `GrpcWebFetchTransport` with `config.grpcUrl` as `baseUrl` and
-`config.grpcTimeout` as `timeout`.
+Both use `GrpcWebFetchTransport` with `config.grpcUrl` or the default gRPC URL
+as `baseUrl`, and `config.grpcTimeout` as `timeout`.
 
 ## localStorage Keys
 

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export { HyperliquidWallet } from 'hypurr-grpc/ts/hypurr/wallet';
 import { AbstractViemLocalAccount } from '@hfunlabs/hyperliquid/signing';
 
 interface HypurrConnectConfig {
+    /** Auth hub client identifier. Sent as `client_id` during Telegram login. */
+    client_id: string;
     /** gRPC-web base URL. Defaults to https://grpc.hypurr.fun. */
     grpcUrl?: string;
     /** Media base URL for user-uploaded assets. Defaults to https://media.hypurr.fun. */

package/dist/index.js

@@ -140,9 +140,12 @@ import { GrpcWebFetchTransport } from "@protobuf-ts/grpcweb-transport";
 import { StaticClient } from "hypurr-grpc/ts/hypurr/static/static_service.client";
 import { TelegramClient } from "hypurr-grpc/ts/hypurr/telegram/telegram_service.client";
 var DEFAULT_GRPC_URL = "https://grpc.hypurr.fun";
+function resolveGrpcUrl(config) {
+  return config.grpcUrl?.trim() || DEFAULT_GRPC_URL;
+}
 function createTransport(config) {
   return new GrpcWebFetchTransport({
-    baseUrl: config.grpcUrl ?? DEFAULT_GRPC_URL,
+    baseUrl: resolveGrpcUrl(config),
     timeout: config.grpcTimeout ?? 15e3
   });
 }
@@ -448,6 +451,13 @@ function normalizeScopes(scope) {
   if (Array.isArray(scope)) return scope.join(" ");
   return scope?.trim() || DEFAULT_TELEGRAM_SCOPES.join(" ");
 }
+function normalizeClientId(clientId) {
+  const normalized = typeof clientId === "string" ? clientId.trim() : "";
+  if (!normalized) {
+    throw new Error("[HypurrConnect] config.client_id is required.");
+  }
+  return normalized;
+}
 function isTelegramAuthMessage(data) {
   return typeof data === "object" && data !== null && "type" in data && "token" in data && "state" in data && data.type === TELEGRAM_AUTH_MESSAGE && typeof data.token === "string" && typeof data.state === "string";
 }
@@ -1313,6 +1323,7 @@ function HypurrConnectProvider({
     const authUrl = new URL(
       config.telegram?.authHubUrl || DEFAULT_AUTH_HUB_URL
     );
+    authUrl.searchParams.set("client_id", normalizeClientId(config.client_id));
     authUrl.searchParams.set("return_to", returnTo);
     authUrl.searchParams.set("state", state);
     authUrl.searchParams.set("scope", normalizeScopes(config.telegram?.scope));
@@ -1338,6 +1349,7 @@ function HypurrConnectProvider({
     }
     window.location.assign(authUrl.toString());
   }, [
+    config.client_id,
     config.telegram?.authHubUrl,
     config.telegram?.returnTo,
     config.telegram?.scope