mppx 0.6.31 → 0.8.0

package/dist/tempo/session/server/Settlement.d.ts

@@ -0,0 +1,185 @@
+import { type Account as viem_Account, type Address, type Hex } from 'viem';
+import type * as Credential from '../../../Credential.js';
+import type * as Method from '../../../Method.js';
+import * as Store from '../../../Store.js';
+import type * as FeePayer from '../../internal/fee-payer.js';
+import * as Chain from '../precompile/Chain.js';
+import { type SessionCredentialPayload, type SessionReceipt } from '../precompile/Protocol.js';
+import * as ChannelStore from './ChannelStore.js';
+/** Fee-payer parameter accepted by the server session method. */
+export type ParameterFeePayer = viem_Account | string | true | undefined;
+/** Minimum method details needed to decide credential-time fee sponsorship. */
+export type CredentialFeePayerMethodDetails = {
+    /** Whether the challenge advertised fee-payer support. */
+    feePayer?: boolean | undefined;
+};
+/** Inputs used to resolve request-time fee sponsorship policy. */
+export type ResolveRequestFeePayerParameters = {
+    /** Incoming credential, present for verification/management requests. */
+    credential: Credential.Credential | null | undefined;
+    /** Default fee-payer account resolved from server parameters. */
+    defaultFeePayer?: viem_Account | undefined;
+    /** Server-level fee-payer parameter. */
+    parameterFeePayer?: ParameterFeePayer;
+    /** Per-request fee-payer override. */
+    requestFeePayer?: boolean | viem_Account | undefined;
+};
+/** Inputs used to resolve credential-time fee sponsorship account. */
+export type ResolveCredentialFeePayerParameters = {
+    /** Request object being verified. */
+    request: unknown;
+    /** Challenge method details echoed by the credential. */
+    methodDetails: CredentialFeePayerMethodDetails;
+    /** Default fee-payer account resolved from server parameters. */
+    feePayer?: viem_Account | undefined;
+};
+/** Fee-payer value read from an untrusted credential challenge request. */
+export type RequestFeePayerValue = boolean | viem_Account | undefined;
+/** Reads the optional `feePayer` field from an untrusted request object. */
+export declare function readRequestFeePayer(value: unknown): RequestFeePayerValue;
+/** Resolves whether a challenge should advertise fee sponsorship or a credential can use it. */
+export declare function resolveRequestFeePayer(parameters: ResolveRequestFeePayerParameters): boolean | viem_Account | undefined;
+/** Resolves the fee-payer account allowed for an incoming credential. */
+export declare function resolveCredentialFeePayer(parameters: ResolveCredentialFeePayerParameters): viem_Account | undefined;
+/** Declarative server-side settlement cadence for automatic session settlement. */
+export type SettlementSchedule = {
+    /** Settle after this many additional paid units since the previous scheduled settlement. */
+    units?: number | undefined;
+    /** Settle after this much additional settlement amount since the previous scheduled settlement. */
+    amount?: string | bigint | undefined;
+    /** Settle after this many milliseconds since the previous scheduled settlement. */
+    intervalMs?: number | undefined;
+};
+/** Settlement schedule normalized into raw token units. */
+export type ResolvedSettlementSchedule = {
+    /** Raw token amount threshold. */
+    amount?: bigint | undefined;
+    /** Elapsed-time threshold since previous settlement. */
+    intervalMs?: number | undefined;
+    /** Paid unit threshold. */
+    units?: number | undefined;
+};
+/** Progress counters compared against a server-owned settlement schedule. */
+export type SettlementProgress = {
+    /** Additional raw spend since the previous scheduled settlement boundary. */
+    amount: bigint;
+    /** Milliseconds elapsed since the previous scheduled settlement boundary. */
+    elapsedMs?: number | undefined;
+    /** Additional paid units since the previous scheduled settlement boundary. */
+    units: number;
+};
+/** Inputs used to mark a channel after automatic scheduled settlement succeeds. */
+export type MarkSettlementCompleteParameters = {
+    channelId: ChannelStore.State['channelId'];
+    settledAt?: string | undefined;
+    store: ChannelStore.ChannelStore;
+};
+/** Converts a public settlement schedule into raw-unit thresholds. */
+export declare function resolveSettlementSchedule(schedule: SettlementSchedule | undefined, decimals: number): ResolvedSettlementSchedule | undefined;
+/**
+ * Computes the schedule progress for an unsettled precompile-backed channel.
+ *
+ * Returns `undefined` for channels that cannot be scheduled: non-precompile
+ * records, channels without an accepted voucher, or channels with no unsettled
+ * voucher amount.
+ */
+export declare function resolveSettlementProgress(channel: ChannelStore.State): SettlementProgress | undefined;
+/** Returns whether the precompile channel has crossed any configured settlement threshold. */
+export declare function isSettlementDue(channel: ChannelStore.State, schedule: ResolvedSettlementSchedule | undefined): boolean;
+/** Records the channel spend/unit counters that a scheduled settlement captured. */
+export declare function markSettlementComplete(parameters: MarkSettlementCompleteParameters): Promise<void>;
+/** Callback used by post-verification accounting to deduct spend from a channel. */
+export type ChargeSessionChannel = (channelId: Hex, amount: bigint) => Promise<ChannelStore.State>;
+/** Callback used by post-verification accounting to run server-owned settlement policy. */
+export type SettleChargedSessionChannel = (channel: ChannelStore.State) => Promise<Hex | undefined>;
+/** Inputs for charging a precompile-backed session channel. */
+export type ChargeParameters = {
+    /** Server-side channel store. */
+    store: ChannelStore.ChannelStore;
+    /** Channel ID to deduct from. */
+    channelId: Hex;
+    /** Raw token amount to charge. */
+    amount: bigint;
+};
+/** Inputs used to apply default HTTP request/response accounting after credential verification. */
+export type ApplyVerifiedHttpAccountingParameters = {
+    /** Captured request metadata from the verified envelope, when this is a request-backed flow. */
+    capturedRequest?: Method.CapturedRequest | undefined;
+    /** Deducts the configured request amount from channel spend. */
+    charge: ChargeSessionChannel;
+    /** Returns the raw request amount to deduct for one content response. Called only when charging. */
+    getRequestAmount: () => bigint;
+    /** Credential action that produced the receipt. Only open/voucher can pay for content. */
+    payloadAction: SessionCredentialPayload['action'];
+    /** Receipt returned by credential verification before content accounting. */
+    receipt: SessionReceipt;
+    /** Marks an SSE receipt whose first content unit was charged during verification. */
+    markPrepaidReceipt?: ((receipt: SessionReceipt) => SessionReceipt) | undefined;
+    /** Whether SSE transport is enabled. SSE accounting is stream-driven, not HTTP-response-driven. */
+    sseEnabled: boolean;
+    /** Runs optional server settlement policy after a successful content charge. */
+    settleCharged: SettleChargedSessionChannel;
+};
+/** Applies the default HTTP content charge after a session credential has been accepted. */
+export declare function applyVerifiedHttpAccounting(parameters: ApplyVerifiedHttpAccountingParameters): Promise<SessionReceipt>;
+/** Atomically deducts spend from a channel and maps store failures to typed session errors. */
+export declare function chargeSessionChannel(parameters: ChargeParameters): Promise<ChannelStore.State>;
+/** Store accepted by public settlement controls. */
+export type SessionStoreInput = Store.Store | ChannelStore.ChannelStore;
+/** Inputs used to validate who may submit payee-side settlement transactions. */
+export type SettlementSenderParameters = {
+    channelId: Hex;
+    operation: 'close' | 'settle';
+    operator: Address;
+    payee: Address;
+    sender: Address | undefined;
+};
+/** Options for server-driven precompile settlement transactions. */
+export type SettlementTransactionOptions = {
+    /** Account used to send the settlement transaction. Defaults to the viem client account. */
+    account?: viem_Account | undefined;
+    /** Candidate fee tokens for sponsored settlement. Defaults to the channel token. */
+    candidateFeeTokens?: readonly Address[] | undefined;
+    /** TIP20EscrowChannel precompile address override. */
+    escrowContract?: Address | undefined;
+    /** Optional fee-payer account for sponsored settlement. */
+    feePayer?: viem_Account | undefined;
+    /** Optional policy for sponsored settlement. */
+    feePayerPolicy?: Partial<FeePayer.Policy> | undefined;
+    /** Optional fee token override for settlement. */
+    feeToken?: Address | undefined;
+};
+/** Inputs for applying a server-owned automatic settlement schedule. */
+export type MaybeSettleScheduledParameters = {
+    /** Account used to send the settlement transaction. */
+    account?: viem_Account | undefined;
+    /** Channel that was just charged. */
+    channel: ChannelStore.State;
+    /** viem client used to settle on-chain. */
+    client: Chain.TransactionClient;
+    /** Optional fee-payer account for sponsored settlement. */
+    feePayer?: viem_Account | undefined;
+    /** Optional policy for sponsored settlement. */
+    feePayerPolicy?: Partial<FeePayer.Policy> | undefined;
+    /** Optional fee token override for settlement. */
+    feeToken?: Address | undefined;
+    /** Resolved server-owned settlement cadence. */
+    schedule: ResolvedSettlementSchedule | undefined;
+    /** Server-side channel store. */
+    store: ChannelStore.ChannelStore;
+};
+/** Resolves either a generic mppx store or an already-wrapped channel store. */
+export declare function resolveChannelStore(store: SessionStoreInput): ChannelStore.ChannelStore;
+/** Returns the account attached to a viem client, when one exists. */
+export declare function getClientAccount(client: {
+    account?: viem_Account | undefined;
+}): viem_Account | undefined;
+/** Validates that the transaction sender is the channel payee or nonzero operator. */
+export declare function assertSettlementSender(parameters: SettlementSenderParameters): void;
+/** Applies automatic settlement when the server-owned schedule is due. */
+export declare function maybeSettleScheduled(parameters: MaybeSettleScheduledParameters): Promise<Hex | undefined>;
+/** Settles the highest accepted voucher for a precompile-backed session channel. */
+export declare function settle(store_: SessionStoreInput, client: Chain.TransactionClient, channelId_: Hex, options?: SettlementTransactionOptions): Promise<Hex>;
+/** Settles multiple precompile-backed session channels with the same validation as {@link settle}. */
+export declare function settleBatch(store: SessionStoreInput, client: Chain.TransactionClient, channelIds: readonly Hex[], options?: SettlementTransactionOptions): Promise<Hex[]>;
+//# sourceMappingURL=Settlement.d.ts.map

package/dist/tempo/session/server/Settlement.d.ts.map

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

package/dist/tempo/session/server/Settlement.js

@@ -0,0 +1,252 @@
+import { isAddress, isAddressEqual, parseUnits, zeroAddress, } from 'viem';
+import { BadRequestError, ChannelClosedError, ChannelNotFoundError, InsufficientBalanceError, VerificationFailedError, } from '../../../Errors.js';
+import { isSessionContentRequest } from '../../server/internal/request-body.js';
+import * as Chain from '../precompile/Chain.js';
+import { readSettledReceiptFields } from '../precompile/Chain.js';
+import { uint96, } from '../precompile/Protocol.js';
+import * as ChannelStore from './ChannelStore.js';
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isAccount(value) {
+    return isObject(value) && typeof value.address === 'string' && isAddress(value.address);
+}
+/** Reads the optional `feePayer` field from an untrusted request object. */
+export function readRequestFeePayer(value) {
+    if (!isObject(value))
+        return undefined;
+    const feePayer = value.feePayer;
+    if (feePayer === undefined || typeof feePayer === 'boolean')
+        return feePayer;
+    if (isAccount(feePayer))
+        return feePayer;
+    return undefined;
+}
+/** Resolves whether a challenge should advertise fee sponsorship or a credential can use it. */
+export function resolveRequestFeePayer(parameters) {
+    const { credential, defaultFeePayer, parameterFeePayer, requestFeePayer } = parameters;
+    if (requestFeePayer === false)
+        return credential ? false : undefined;
+    const account = typeof requestFeePayer === 'object' ? requestFeePayer : defaultFeePayer;
+    if (credential)
+        return account ?? undefined;
+    if (account || defaultFeePayer || parameterFeePayer === true)
+        return true;
+    return undefined;
+}
+/** Resolves the fee-payer account allowed for an incoming credential. */
+export function resolveCredentialFeePayer(parameters) {
+    const { feePayer, methodDetails, request } = parameters;
+    const requestFeePayer = readRequestFeePayer(request);
+    const requestAllowsFeePayer = requestFeePayer === undefined || requestFeePayer === true || typeof requestFeePayer === 'object';
+    if (methodDetails.feePayer !== true || !requestAllowsFeePayer)
+        return undefined;
+    return typeof requestFeePayer === 'object' ? requestFeePayer : feePayer;
+}
+/** Converts a public settlement schedule into raw-unit thresholds. */
+export function resolveSettlementSchedule(schedule, decimals) {
+    if (!schedule)
+        return undefined;
+    return {
+        ...(schedule.amount !== undefined && {
+            amount: typeof schedule.amount === 'bigint'
+                ? schedule.amount
+                : parseUnits(schedule.amount, decimals),
+        }),
+        ...(schedule.intervalMs !== undefined && { intervalMs: schedule.intervalMs }),
+        ...(schedule.units !== undefined && { units: schedule.units }),
+    };
+}
+/**
+ * Computes the schedule progress for an unsettled precompile-backed channel.
+ *
+ * Returns `undefined` for channels that cannot be scheduled: non-precompile
+ * records, channels without an accepted voucher, or channels with no unsettled
+ * voucher amount.
+ */
+export function resolveSettlementProgress(channel) {
+    if (!ChannelStore.isPrecompileState(channel))
+        return undefined;
+    if (!channel.highestVoucher)
+        return undefined;
+    if (channel.highestVoucher.cumulativeAmount <= channel.settledOnChain)
+        return undefined;
+    const amountBoundary = channel.lastSettlementSpent ?? channel.settledOnChain;
+    const timestampBoundary = Date.parse(channel.lastSettlementAt ?? channel.createdAt);
+    return {
+        amount: channel.spent - amountBoundary,
+        ...(Number.isFinite(timestampBoundary) && {
+            elapsedMs: Date.now() - timestampBoundary,
+        }),
+        units: channel.units - (channel.lastSettlementUnits ?? 0),
+    };
+}
+/** Returns whether the precompile channel has crossed any configured settlement threshold. */
+export function isSettlementDue(channel, schedule) {
+    if (!schedule)
+        return false;
+    const progress = resolveSettlementProgress(channel);
+    if (!progress)
+        return false;
+    if (schedule.units !== undefined && progress.units >= schedule.units)
+        return true;
+    if (schedule.amount !== undefined && progress.amount >= schedule.amount)
+        return true;
+    if (schedule.intervalMs !== undefined && (progress.elapsedMs ?? 0) >= schedule.intervalMs)
+        return true;
+    return false;
+}
+/** Records the channel spend/unit counters that a scheduled settlement captured. */
+export async function markSettlementComplete(parameters) {
+    const { channelId, store, settledAt = new Date().toISOString() } = parameters;
+    await store.updateChannel(channelId, (current) => current
+        ? {
+            ...current,
+            lastSettlementAt: settledAt,
+            lastSettlementSpent: current.spent,
+            lastSettlementUnits: current.units,
+        }
+        : current);
+}
+/** Applies the default HTTP content charge after a session credential has been accepted. */
+export async function applyVerifiedHttpAccounting(parameters) {
+    const { capturedRequest, payloadAction, receipt, sseEnabled } = parameters;
+    if (!capturedRequest)
+        return receipt;
+    if (payloadAction !== 'open' && payloadAction !== 'voucher')
+        return receipt;
+    if (sseEnabled && capturedRequest.method === 'POST')
+        return receipt;
+    if (!isSessionContentRequest(capturedRequest))
+        return receipt;
+    const requestAmount = parameters.getRequestAmount();
+    const charged = await parameters.charge(receipt.channelId, requestAmount);
+    const settlementTxHash = await parameters.settleCharged(charged);
+    const chargedReceipt = {
+        ...receipt,
+        spent: charged.spent.toString(),
+        units: charged.units,
+        ...(settlementTxHash ? { txHash: settlementTxHash } : {}),
+    };
+    return sseEnabled
+        ? (parameters.markPrepaidReceipt?.(chargedReceipt) ?? chargedReceipt)
+        : chargedReceipt;
+}
+/** Atomically deducts spend from a channel and maps store failures to typed session errors. */
+export async function chargeSessionChannel(parameters) {
+    const { store, channelId, amount } = parameters;
+    let result;
+    try {
+        result = await ChannelStore.deductFromChannel(store, channelId, amount);
+    }
+    catch {
+        throw new ChannelClosedError({ reason: 'channel not found' });
+    }
+    if (!result.ok) {
+        if (result.channel.finalized)
+            throw new ChannelClosedError({ reason: 'channel is finalized' });
+        if (result.channel.closeRequestedAt !== 0n)
+            throw new ChannelClosedError({ reason: 'channel has a pending close request' });
+        const available = result.channel.highestVoucherAmount - result.channel.spent;
+        throw new InsufficientBalanceError({
+            reason: `requested ${amount}, available ${available}`,
+        });
+    }
+    return result.channel;
+}
+/** Resolves either a generic mppx store or an already-wrapped channel store. */
+export function resolveChannelStore(store) {
+    return 'getChannel' in store ? store : ChannelStore.fromStore(store);
+}
+/** Returns the account attached to a viem client, when one exists. */
+export function getClientAccount(client) {
+    return client.account;
+}
+/** Validates that the transaction sender is the channel payee or nonzero operator. */
+export function assertSettlementSender(parameters) {
+    const { operation, channelId, operator, payee, sender } = parameters;
+    if (!sender)
+        throw new Error(`Cannot ${operation} precompile channel ${channelId}: no account available. Pass an account override, or provide a getClient() that returns an account-bearing client.`);
+    if (isAddressEqual(sender, payee))
+        return;
+    if (!isAddressEqual(operator, zeroAddress) && isAddressEqual(sender, operator))
+        return;
+    throw new BadRequestError({
+        reason: `Cannot ${operation} precompile channel ${channelId}: tx sender ${sender} is not the channel payee ${payee}` +
+            (isAddressEqual(operator, zeroAddress) ? '.' : ` or operator ${operator}.`) +
+            ' If using an access key, pass a Tempo access-key account whose address is the payee/operator wallet, not the raw delegated key address.',
+    });
+}
+/** Applies automatic settlement when the server-owned schedule is due. */
+export async function maybeSettleScheduled(parameters) {
+    const { channel, schedule, store } = parameters;
+    if (!isSettlementDue(channel, schedule))
+        return undefined;
+    const txHash = await settle(store, parameters.client, channel.channelId, {
+        account: parameters.account,
+        ...(parameters.feePayer ? { feePayer: parameters.feePayer } : {}),
+        ...(parameters.feePayerPolicy ? { feePayerPolicy: parameters.feePayerPolicy } : {}),
+        ...(parameters.feeToken ? { feeToken: parameters.feeToken } : {}),
+    });
+    await markSettlementComplete({ channelId: channel.channelId, store });
+    return txHash;
+}
+/** Settles the highest accepted voucher for a precompile-backed session channel. */
+export async function settle(store_, client, channelId_, options) {
+    const store = resolveChannelStore(store_);
+    const channelId = ChannelStore.normalizeChannelId(channelId_);
+    const channel = await store.getChannel(channelId);
+    if (!channel)
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    if (!ChannelStore.isPrecompileState(channel))
+        throw new VerificationFailedError({ reason: 'channel is not precompile-backed' });
+    if (!channel.highestVoucher)
+        throw new VerificationFailedError({ reason: 'no voucher to settle' });
+    const escrow = options?.escrowContract ?? channel.escrowContract;
+    const account = options?.account ?? getClientAccount(client);
+    assertSettlementSender({
+        operation: 'settle',
+        channelId,
+        operator: channel.operator,
+        payee: channel.payee,
+        sender: account?.address,
+    });
+    const amount = uint96(channel.highestVoucher.cumulativeAmount);
+    const txHash = await Chain.settleOnChain(client, channel.descriptor, amount, channel.highestVoucher.signature, escrow, account
+        ? {
+            account,
+            ...(options?.feePayer ? { feePayer: options.feePayer } : {}),
+            ...(options?.feePayerPolicy ? { feePayerPolicy: options.feePayerPolicy } : {}),
+            ...(options?.feeToken ? { feeToken: options.feeToken } : {}),
+            candidateFeeTokens: options?.candidateFeeTokens ?? [channel.token],
+        }
+        : undefined);
+    const receipt = await Chain.waitForSuccessfulReceipt(client, txHash);
+    const settled = readSettledReceiptFields(Chain.getChannelEvent(receipt, 'Settled', channelId));
+    const { newSettled } = settled;
+    if (newSettled < amount)
+        throw new VerificationFailedError({ reason: 'Settled event is below voucher amount' });
+    const state = await Chain.getChannelState(client, channelId, escrow);
+    if (state.settled !== newSettled)
+        throw new VerificationFailedError({
+            reason: 'on-chain channel state does not match settle receipt',
+        });
+    await store.updateChannel(channelId, (current) => current
+        ? {
+            ...current,
+            settledOnChain: newSettled > current.settledOnChain ? newSettled : current.settledOnChain,
+            lastSettlementAt: new Date().toISOString(),
+            lastSettlementSpent: current.spent,
+            lastSettlementUnits: current.units,
+        }
+        : current);
+    return txHash;
+}
+/** Settles multiple precompile-backed session channels with the same validation as {@link settle}. */
+export async function settleBatch(store, client, channelIds, options) {
+    const hashes = [];
+    for (const channelId of channelIds)
+        hashes.push(await settle(store, client, channelId, options));
+    return hashes;
+}
+//# sourceMappingURL=Settlement.js.map

package/dist/tempo/session/server/Settlement.js.map

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

package/dist/tempo/session/{Sse.d.ts → server/Sse.d.ts}

@@ -1,3 +1,6 @@
+import type { Hex } from 'viem';
+import * as ChannelStore from './ChannelStore.js';
+import { type SessionController } from './MeteredStream.js';
 /**
  * SSE (Server-Sent Events) utilities for metered streaming payments.
  *
@@ -6,62 +9,9 @@
  * of SSE events, and helpers (`toResponse`, `fromRequest`) for
  * building HTTP responses from the stream.
  */
-import type { Hex } from 'viem';
-import * as ChannelStore from './ChannelStore.js';
-import type { NeedVoucherEvent, SessionReceipt } from './Types.js';
-/**
- * Format a session receipt as a Server-Sent Event.
- *
- * Produces a valid SSE event string with `event: payment-receipt`
- * and the receipt JSON as the `data` field.
- */
-export declare function formatReceiptEvent(receipt: SessionReceipt): string;
-/**
- * Format a need-voucher event as a Server-Sent Event.
- *
- * Emitted when the channel balance is exhausted mid-stream.
- * The client responds by sending a new voucher credential to
- * any mppx-protected endpoint.
- */
-export declare function formatNeedVoucherEvent(params: NeedVoucherEvent): string;
-/**
- * Format an application message as SSE, preserving embedded newlines.
- *
- * SSE requires multi-line payloads to be emitted as separate `data:` fields.
- */
-export declare function formatMessageEvent(value: string): string;
-/**
- * Parsed SSE event (discriminated union by `type`).
- */
-export type SseEvent = {
-    type: 'message';
-    data: string;
-} | {
-    type: 'payment-need-voucher';
-    data: NeedVoucherEvent;
-} | {
-    type: 'payment-receipt';
-    data: SessionReceipt;
-};
-/**
- * Parse a raw SSE event string into a typed event.
- *
- * Handles the three event types used by mppx streaming:
- * - `message` (default / no event field) — application data
- * - `payment-need-voucher` — balance exhausted, client should send voucher
- * - `payment-receipt` — final receipt
- */
-export declare function parseEvent(raw: string): SseEvent | null;
-export type SessionController = {
-    /**
-     * Reserve voucher coverage for the next emitted chunk.
-     *
-     * The reservation blocks until sufficient voucher headroom exists, but the
-     * charge is only committed once a chunk is actually emitted. If the stream
-     * ends or aborts before that emission, the reservation is dropped.
-     */
-    charge(): Promise<void>;
-};
+export { extractData, formatMessageEvent, formatNeedVoucherEvent, formatReceiptEvent, parseEvent, readSessionChallengeAmount, requireSessionCredentialContext, type SseEvent, } from '../precompile/Protocol.js';
+/** Controller passed to manual-charge SSE generators. */
+export type { SessionController } from './MeteredStream.js';
 /**
  * Wrap an async iterable with payment metering, producing an SSE stream.
  *
@@ -83,6 +33,7 @@ export type SessionController = {
  * Returns a `ReadableStream<Uint8Array>` suitable for use as an HTTP response body.
  */
 export declare function serve(options: serve.Options): ReadableStream<Uint8Array>;
+/** Type helpers for {@link serve}. */
 export declare namespace serve {
     type Options = {
         store: ChannelStore.ChannelStore;
@@ -108,6 +59,7 @@ export declare function toResponse(body: ReadableStream<Uint8Array>): Response;
  * the parameters required by {@link serve}.
  */
 export declare function fromRequest(request: Request): fromRequest.Context;
+/** Type helpers for {@link fromRequest}. */
 export declare namespace fromRequest {
     type Context = {
         challengeId: string;
@@ -141,6 +93,7 @@ export declare function isEventStream(response: Response): boolean;
  * ```
  */
 export declare function iterateData(response: Response, options?: iterateData.Options): AsyncGenerator<string>;
+/** Type helpers for {@link iterateData}. */
 export declare namespace iterateData {
     type Options = {
         /** Predicate to skip specific data payloads (e.g. `d => d === '[DONE]'`). */

package/dist/tempo/session/server/Sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sse.d.ts","sourceRoot":"","sources":["../../../../src/tempo/session/server/Sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAa/B,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE1E;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,KAAK,QAAQ,GACd,MAAM,2BAA2B,CAAA;AAElC,yDAAyD;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAsDxE;AAED,sCAAsC;AACtC,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,OAAO,GAAG;QACb,KAAK,EAAE,YAAY,CAAC,YAAY,CAAA;QAChC,SAAS,EAAE,GAAG,CAAA;QACd,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,iBAAiB,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;QACxF,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACjC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KACjC,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,CAQrE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAcjE;AAED,4CAA4C;AAC5C,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,KAAK,OAAO,GAAG;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,GAAG,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAGzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAuB,WAAW,CAChC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,GAC5B,cAAc,CAAC,MAAM,CAAC,CAsCxB;AAED,4CAA4C;AAC5C,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,KAAK,OAAO,GAAG;QACb,6EAA6E;QAC7E,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAA;KAC/C,CAAA;CACF"}