mppx 0.6.30 → 0.7.0

package/src/tempo/{client → legacy/client}/SessionManager.ts

@@ -1,16 +1,18 @@
 import type { Hex } from 'ox'
 import { parseUnits, type Account as viem_Account, type Address } from 'viem'
 
-import * as Challenge from '../../Challenge.js'
-import * as Fetch from '../../client/internal/Fetch.js'
-import * as PaymentCredential from '../../Credential.js'
-import * as AcceptPayment from '../../internal/AcceptPayment.js'
-import type * as Account from '../../viem/Account.js'
-import type * as Client from '../../viem/Client.js'
-import { deserializeSessionReceipt } from '../session/Receipt.js'
-import { parseEvent } from '../session/Sse.js'
-import type { SessionCredentialPayload, SessionReceipt } from '../session/Types.js'
-import * as Ws from '../session/Ws.js'
+import * as Challenge from '../../../Challenge.js'
+import * as Fetch from '../../../client/internal/Fetch.js'
+import * as Constants from '../../../Constants.js'
+import * as PaymentCredential from '../../../Credential.js'
+import * as AcceptPayment from '../../../internal/AcceptPayment.js'
+import type * as Account from '../../../viem/Account.js'
+import type * as Client from '../../../viem/Client.js'
+import { deserializeSessionReceipt } from '../../session/precompile/Protocol.js'
+import type { SessionReceipt } from '../../session/precompile/Protocol.js'
+import { parseEvent } from '../../session/precompile/Protocol.js'
+import * as Ws from '../../session/precompile/Protocol.js'
+import type { LegacySessionCredentialPayload } from '../session/Types.js'
 import type { ChannelEntry } from './ChannelOps.js'
 import { session as sessionPlugin } from './Session.js'
 
@@ -46,13 +48,20 @@ const WebSocketReadyState = {
 // Keep protocol/policy close codes on the server side and use an app-defined code here.
 const ClientWebSocketProtocolErrorCloseCode = 3008
 
+/** Auto-driving legacy client manager for HTTP, SSE, and WebSocket sessions. */
 export type SessionManager = {
+  /** Active legacy channel ID, when opened or recovered. */
   readonly channelId: Hex.Hex | undefined
+  /** Local cumulative voucher authorization in raw token units. */
   readonly cumulative: bigint
+  /** Whether the manager currently has an open local channel. */
   readonly opened: boolean
 
+  /** Opens a legacy contract-backed channel before the first paid request. */
   open(options?: { deposit?: bigint }): Promise<void>
+  /** Performs the HTTP 402 challenge/retry flow and returns receipt metadata. */
   fetch(input: RequestInfo | URL, init?: SessionRequestInit): Promise<PaymentResponse>
+  /** Opens a paid SSE stream and responds to voucher requests. */
   sse(
     input: RequestInfo | URL,
     init?: SessionRequestInit & {
@@ -60,6 +69,7 @@ export type SessionManager = {
       signal?: AbortSignal | undefined
     },
   ): Promise<AsyncIterable<string>>
+  /** Opens a paid WebSocket session and manages in-band payment frames. */
   ws(
     input: string | URL,
     init?: {
@@ -69,13 +79,19 @@ export type SessionManager = {
       signal?: AbortSignal | undefined
     },
   ): Promise<WebSocket>
+  /** Cooperatively closes the active legacy channel. */
   close(): Promise<SessionReceipt | undefined>
 }
 
+/** HTTP response enriched with latest legacy session metadata. */
 export type PaymentResponse = Response & {
+  /** Parsed payment receipt, when the response included one. */
   receipt: SessionReceipt | null
+  /** Last session challenge observed by the manager. */
   challenge: Challenge.Challenge | null
+  /** Active channel ID, when available. */
   channelId: Hex.Hex | null
+  /** Local cumulative voucher authorization in raw token units. */
   cumulative: bigint
 }
 
@@ -250,7 +266,7 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
   }
 
   function toPaymentResponse(response: Response): PaymentResponse {
-    const receiptHeader = response.headers.get('Payment-Receipt')
+    const receiptHeader = response.headers.get(Constants.Headers.paymentReceipt)
     const receipt = receiptHeader ? deserializeSessionReceipt(receiptHeader) : null
     updateSpentFromReceipt(receipt)
     return Object.assign(response, {
@@ -425,13 +441,13 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
       if (!lastUrl) throw new Error('No URL available — call fetch() or sse() before open().')
       const response = await fetchFn(lastUrl, {
         method: 'POST',
-        headers: { Authorization: credential },
+        headers: { [Constants.Headers.authorization]: credential },
       })
       if (!response.ok) {
         const body = await response.text().catch(() => '')
-        const wwwAuth = response.headers.get('WWW-Authenticate') ?? ''
+        const wwwAuth = response.headers.get(Constants.Headers.wwwAuthenticate) ?? ''
         throw new Error(
-          `Open request failed with status ${response.status}${body ? `: ${body}` : ''}${wwwAuth ? ` [WWW-Authenticate: ${wwwAuth}]` : ''}`,
+          `Open request failed with status ${response.status}${body ? `: ${body}` : ''}${wwwAuth ? ` [${Constants.Headers.wwwAuthenticate}: ${wwwAuth}]` : ''}`,
         )
       }
     },
@@ -504,7 +520,10 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
                   })
                   const voucherResponse = await fetchFn(input, {
                     method: 'POST',
-                    headers: { Authorization: credential },
+                    headers: {
+                      Accept: 'text/event-stream',
+                      [Constants.Headers.authorization]: credential,
+                    },
                   })
                   if (!voucherResponse.ok) {
                     throw new Error(`Voucher POST failed with status ${voucherResponse.status}`)
@@ -575,7 +594,8 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
       activeSocketChallenge = challenge
       wsDeliveredChunks = 0n
       wsTickCost = BigInt(challenge.request.amount as string)
-      const openCredential = PaymentCredential.deserialize<SessionCredentialPayload>(credential)
+      const openCredential =
+        PaymentCredential.deserialize<LegacySessionCredentialPayload>(credential)
       activeSocketChannelId = openCredential.payload.channelId
       const rawSocket = new WebSocketImpl(wsUrl, protocols)
       activeSocket = rawSocket
@@ -819,7 +839,7 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
 
       const response = await fetchFn(lastUrl, {
         method: 'POST',
-        headers: { Authorization: credential },
+        headers: { [Constants.Headers.authorization]: credential },
       })
       if (!response.ok) {
         const body = await response.text().catch(() => '')
@@ -835,12 +855,12 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
             return body
           }
         })()
-        const wwwAuth = response.headers.get('WWW-Authenticate') ?? ''
+        const wwwAuth = response.headers.get(Constants.Headers.wwwAuthenticate) ?? ''
         throw new Error(
-          `Close request failed with status ${response.status}${detail ? `: ${detail}` : ''}${wwwAuth ? ` [WWW-Authenticate: ${wwwAuth}]` : ''}`,
+          `Close request failed with status ${response.status}${detail ? `: ${detail}` : ''}${wwwAuth ? ` [${Constants.Headers.wwwAuthenticate}: ${wwwAuth}]` : ''}`,
         )
       }
-      const receiptHeader = response.headers.get('Payment-Receipt')
+      const receiptHeader = response.headers.get(Constants.Headers.paymentReceipt)
       const receipt = receiptHeader ? deserializeSessionReceipt(receiptHeader) : undefined
 
       return receipt
@@ -850,6 +870,7 @@ export function sessionManager(parameters: sessionManager.Parameters): SessionMa
   return self
 }
 
+/** Type helpers for the legacy auto-driving session manager. */
 export declare namespace sessionManager {
   type Parameters = Account.getResolver.Parameters &
     Client.getResolver.Parameters & {

package/src/tempo/legacy/client/index.ts

@@ -0,0 +1,6 @@
+/** Legacy contract-backed session client method. */
+export { session } from './Session.js'
+/** Legacy contract-backed session manager. */
+export { sessionManager } from './SessionManager.js'
+/** Legacy client session manager types. */
+export type { PaymentResponse, SessionManager } from './SessionManager.js'

package/src/tempo/legacy/index.ts

@@ -0,0 +1,6 @@
+/** Legacy contract-backed session client surface. */
+export * as Client from './client/index.js'
+/** Legacy contract-backed session server surface. */
+export * as Server from './server/index.js'
+/** Legacy contract-backed session channel primitives. */
+export * as Session from './session/index.js'