{"version":3,"file":"krpc_client-673448e5.mjs","sources":["../src/krpc_client.ts"],"sourcesContent":["// kRPC JSON protocol client. Wire contract: buckyos-base/src/kRPC/src/protocol.rs\n// (Beta2.2). `sys` carries the protocol metadata tuple:\n// - request:  [seq] | [seq, session_token] | [seq, null, trace_id] | [seq, session_token, trace_id]\n// - response: [seq] | [seq, trace_id]\n// The second element of a *response* sys is the trace id echoed by the server.\n// It is NOT a session token: Beta2.2 responses never rotate tokens, so nothing\n// from a response may be written back into the session token state.\n\n// Request sys tuple; the token slot is kept as null when only a trace id is\n// present (mirrors RPCRequest::serialize).\ntype KRPCRequestSys = [number] | [number, string] | [number, string | null, string]\n\n// Response sys tuple: [seq] or [seq, trace_id] (mirrors RPCResponse::serialize).\ntype KRPCResponseSys = [number] | [number, string]\n\ntype KRPCSys = KRPCRequestSys\n\ninterface KRPCRequest<TParams> {\n  method: string\n  params: TParams\n  sys: KRPCRequestSys\n}\n\ninterface KRPCSuccessResponse<TResult> {\n  result: TResult\n  sys?: KRPCResponseSys\n  error?: undefined\n}\n\ninterface KRPCErrorResponse {\n  error: string\n  // Machine-readable error class and payload (RPCErrorDetail on the Rust\n  // side); branch on these, never on the `error` text.\n  code?: string\n  data?: unknown\n  sys?: KRPCResponseSys\n  result?: undefined\n}\n\ntype KRPCResponse<TResult> = KRPCSuccessResponse<TResult> | KRPCErrorResponse\n\nenum RPCProtocolType {\n  HttpPostJson = 'HttpPostJson',\n}\n\n/** `RPCError.code` of a non-2xx HTTP response; `data` is `{ status }` (same shape as Rust's `http_error`). */\nconst RPC_HTTP_ERROR_CODE = 'http_error'\n/** `RPCError.code` when the request did not complete (network, fetch failure, unreadable body). */\nconst RPC_TRANSPORT_ERROR_CODE = 'transport'\n\nclass RPCError extends Error {\n  /** Wire error code of a detailed failure (e.g. `access_denied`). */\n  readonly code?: string\n  /** Typed payload of `code`. */\n  readonly data?: unknown\n\n  constructor(message: string, code?: string, data?: unknown) {\n    super(message)\n    this.name = 'RPCError'\n    this.code = code\n    this.data = data\n  }\n}\n\ntype Fetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>\ntype SessionTokenProvider = () => Promise<string | null | undefined> | string | null | undefined\ntype SessionTokenListener = (token: string | null) => void\n\ninterface KRPCCallOptions {\n  sessionToken?: string | null\n  // Per-call trace id: `undefined` uses the client-level trace id, `null`\n  // (or '') suppresses it for this call.\n  traceId?: string | null\n}\n\ninterface KRPCClientOptions {\n  fetcher?: Fetcher\n  sessionTokenProvider?: SessionTokenProvider\n  // Retained for API compatibility with pre-Beta2.2 callers. Beta2.2 kRPC\n  // responses carry a trace id (not a rotated session token) in sys[1], so\n  // the client never invokes this listener anymore.\n  onSessionTokenChanged?: SessionTokenListener\n  // Initial trace id sent with every request (see setTraceId()).\n  traceId?: string | null\n}\n\nconst defaultFetcher: Fetcher = async (input, init) => {\n  if (typeof window !== 'undefined' && typeof window.fetch === 'function') {\n    return window.fetch(input, init)\n  }\n\n  if (typeof globalThis !== 'undefined' && typeof globalThis.fetch === 'function') {\n    return globalThis.fetch(input, init)\n  }\n\n  throw new RPCError('fetch is not available in this runtime')\n}\n\nclass kRPCClient {\n  private serverUrl: string\n  private protocolType: RPCProtocolType\n  private seq: number\n  private sessionToken: string | null\n  private initToken: string | null\n  private traceId: string | null\n  private fetcher: Fetcher\n  private sessionTokenProvider: SessionTokenProvider | null\n  private sessionTokenOverride: string | null | undefined\n\n  constructor(url: string, token: string | null = null, seq: number | null = null, options: KRPCClientOptions = {}) {\n    this.serverUrl = url\n    this.protocolType = RPCProtocolType.HttpPostJson\n    this.seq = seq ?? Date.now()\n    this.sessionToken = token || null\n    this.initToken = token || null\n    this.traceId = options.traceId || null\n    this.fetcher = options.fetcher ?? defaultFetcher\n    this.sessionTokenProvider = options.sessionTokenProvider ?? null\n    this.sessionTokenOverride = undefined\n  }\n\n  async call<TResult, TParams>(method: string, params: TParams, options: KRPCCallOptions = {}): Promise<TResult> {\n    return this._call<TResult, TParams>(method, params, options)\n  }\n\n  async callWithSessionToken<TResult, TParams>(\n    sessionToken: string | null,\n    method: string,\n    params: TParams,\n  ): Promise<TResult> {\n    return this._call<TResult, TParams>(method, params, { sessionToken })\n  }\n\n  setSeq(seq: number) {\n    this.seq = seq\n  }\n\n  resetSessionToken() {\n    this.sessionToken = this.initToken\n    this.sessionTokenOverride = undefined\n  }\n\n  setSessionToken(token: string | null) {\n    this.sessionToken = token || null\n    this.sessionTokenOverride = token || null\n  }\n\n  getSessionToken(): string | null {\n    return this.sessionToken\n  }\n\n  // Trace id attached to subsequent requests (request sys trace slot), for\n  // correlating a call chain across services. Pass null to clear.\n  setTraceId(traceId: string | null) {\n    this.traceId = traceId || null\n  }\n\n  getTraceId(): string | null {\n    return this.traceId\n  }\n\n  private buildRequest<TParams>(\n    method: string,\n    params: TParams,\n    seq: number,\n    sessionToken: string | null,\n    traceId: string | null,\n  ): KRPCRequest<TParams> {\n    let sys: KRPCRequestSys\n    if (traceId) {\n      sys = [seq, sessionToken, traceId]\n    } else {\n      sys = sessionToken ? [seq, sessionToken] : [seq]\n    }\n    return {\n      method,\n      params,\n      sys,\n    }\n  }\n\n  // Validates a response sys tuple and returns its trace id (if any). The\n  // trace id is only checked for well-formedness; it must never be stored as\n  // a session token.\n  private parseResponseSys(sys: unknown, currentSeq: number): string | null {\n    if (sys === undefined || sys === null) {\n      return null\n    }\n\n    if (!Array.isArray(sys)) {\n      throw new RPCError('sys is not array')\n    }\n\n    if (sys.length < 1) {\n      throw new RPCError('sys is empty')\n    }\n\n    const responseSeq = sys[0]\n    if (typeof responseSeq !== 'number') {\n      throw new RPCError('sys[0] is not number')\n    }\n    if (responseSeq !== currentSeq) {\n      throw new RPCError(`seq not match: ${responseSeq}!=${currentSeq}`)\n    }\n\n    if (sys.length >= 2) {\n      const traceId = sys[1]\n      if (typeof traceId !== 'string') {\n        throw new RPCError('sys[1] trace_id is not string')\n      }\n      return traceId\n    }\n\n    return null\n  }\n\n  private async prepareSessionToken(options: KRPCCallOptions): Promise<string | null> {\n    if (Object.prototype.hasOwnProperty.call(options, 'sessionToken')) {\n      return options.sessionToken || null\n    }\n\n    if (this.sessionTokenOverride !== undefined) {\n      return this.sessionTokenOverride\n    }\n\n    if (this.sessionTokenProvider) {\n      const preparedToken = await this.sessionTokenProvider()\n      if (preparedToken !== undefined) {\n        this.sessionToken = preparedToken || null\n      }\n    }\n\n    return this.sessionToken\n  }\n\n  private prepareTraceId(options: KRPCCallOptions): string | null {\n    if (Object.prototype.hasOwnProperty.call(options, 'traceId')) {\n      return options.traceId || null\n    }\n    return this.traceId\n  }\n\n  private async _call<TResult, TParams>(\n    method: string,\n    params: TParams,\n    options: KRPCCallOptions,\n  ): Promise<TResult> {\n    const sessionToken = await this.prepareSessionToken(options)\n    const traceId = this.prepareTraceId(options)\n    const currentSeq = this.seq\n    this.seq += 1\n    const requestBody = this.buildRequest(method, params, currentSeq, sessionToken, traceId)\n\n    try {\n      const response = await this.fetcher(this.serverUrl, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(requestBody),\n      })\n\n      if (!response.ok) {\n        throw new RPCError(`RPC call error: ${response.status}`, RPC_HTTP_ERROR_CODE, { status: response.status })\n      }\n\n      let rpcResponse: KRPCResponse<TResult>\n      try {\n        rpcResponse = await response.json()\n      } catch (error) {\n        throw new RPCError(`RPC call failed: invalid response body: ${error instanceof Error ? error.message : String(error)}`)\n      }\n\n      this.parseResponseSys(rpcResponse.sys, currentSeq)\n\n      if ('error' in rpcResponse && rpcResponse.error) {\n        throw new RPCError(\n          `RPC call error: ${rpcResponse.error}`,\n          typeof rpcResponse.code === 'string' ? rpcResponse.code : undefined,\n          rpcResponse.data,\n        )\n      }\n\n      if (!('result' in rpcResponse) || rpcResponse.result === undefined) {\n        throw new RPCError('RPC response missing result')\n      }\n\n      return rpcResponse.result\n    } catch (error) {\n      if (error instanceof RPCError) {\n        throw error\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      throw new RPCError(`RPC call failed: ${message}`, RPC_TRANSPORT_ERROR_CODE)\n    }\n  }\n}\n\nexport { kRPCClient, RPCProtocolType, RPCError, RPC_HTTP_ERROR_CODE, RPC_TRANSPORT_ERROR_CODE }\nexport type {\n  KRPCRequest,\n  KRPCResponse,\n  KRPCSys,\n  KRPCRequestSys,\n  KRPCResponseSys,\n  KRPCCallOptions,\n  KRPCClientOptions,\n}\n"],"names":[],"mappings":"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"}