mppx 0.0.1 → 0.1.0

package/dist/tempo/server/Session.js

@@ -0,0 +1,529 @@
+/**
+ * Server-side session payment method for request/response flows.
+ *
+ * Handles the full channel lifecycle (open, voucher, top-up, close) and
+ * one-shot settlement. Each incoming request carries a stream credential
+ * with a cumulative voucher that the server validates and records.
+ *
+ * Use `session()` for standard HTTP request/response patterns where each
+ * request is a discrete paid unit (for example, a page scrape or API call).
+ * For long-lived connections that emit multiple paid events over a single
+ * request, use {@link ../stream/Sse} instead.
+ */
+import { parseUnits, } from 'viem';
+import { tempo as tempo_chain } from 'viem/chains';
+import { AmountExceedsDepositError, BadRequestError, ChannelClosedError, ChannelNotFoundError, DeltaTooSmallError, InsufficientBalanceError, InvalidSignatureError, VerificationFailedError, } from '../../Errors.js';
+import * as MethodIntent from '../../MethodIntent.js';
+import * as Store from '../../Store.js';
+import * as Client from '../../viem/Client.js';
+import * as Intents from '../Intents.js';
+import * as Account from '../internal/account.js';
+import * as defaults from '../internal/defaults.js';
+import { broadcastOpenTransaction, broadcastTopUpTransaction, closeOnChain, getOnChainChannel, settleOnChain, } from '../stream/Chain.js';
+import * as ChannelStore from '../stream/ChannelStore.js';
+import { createStreamReceipt } from '../stream/Receipt.js';
+import { parseVoucherFromPayload, verifyVoucher } from '../stream/Voucher.js';
+import * as Transport from './internal/transport.js';
+/**
+ * Creates a stream payment server using the mppx Method.toServer() pattern.
+ *
+ * @example
+ * ```ts
+ * import { Mppx, tempo } from 'mppx/server'
+ *
+ * const mppx = Mppx.create({
+ *   methods: [
+ *     tempo.session({
+ *       store: myStore,
+ *       recipient: '0x...',
+ *       currency: '0x...',
+ *       escrowContract: '0x...',
+ *     }),
+ *   ],
+ *   realm: 'my-app',
+ *   secretKey: '...',
+ * })
+ * ```
+ */
+export function session(p) {
+    const parameters = p;
+    const { amount, currency, decimals = defaults.decimals, store: rawStore = Store.memory(), suggestedDeposit, unitType, } = parameters;
+    const store = ChannelStore.fromStore(rawStore);
+    const getClient = Client.getResolver({
+        chain: tempo_chain,
+        getClient: parameters.getClient,
+        rpcUrl: defaults.rpcUrl,
+    });
+    const { account, recipient, feePayer } = Account.resolve(parameters);
+    const transport = parameters.stream
+        ? Transport.sse({
+            store,
+            ...(typeof parameters.stream === 'object' ? parameters.stream : undefined),
+        })
+        : undefined;
+    return MethodIntent.toServer(Intents.session, {
+        defaults: {
+            amount,
+            currency,
+            decimals,
+            recipient,
+            suggestedDeposit,
+            unitType,
+        },
+        transport: transport,
+        // TODO: dedupe `{charge,stream}.request`
+        async request({ credential, request }) {
+            // Extract chainId from request or default.
+            const chainId = await (async () => {
+                if (request.chainId)
+                    return request.chainId;
+                if (parameters.testnet)
+                    return defaults.testnetChainId;
+                return (await getClient({})).chain?.id;
+            })();
+            // Validate chainId.
+            const client = await (async () => {
+                try {
+                    return await getClient({ chainId });
+                }
+                catch {
+                    throw new Error(`No client configured with chainId ${chainId}.`);
+                }
+            })();
+            if (client.chain?.id !== chainId)
+                throw new Error(`Client not configured with chainId ${chainId}.`);
+            const resolvedEscrow = request.escrowContract ??
+                parameters.escrowContract ??
+                defaults.escrowContract[chainId];
+            // Extract feePayer.
+            const resolvedFeePayer = (() => {
+                const account = typeof request.feePayer === 'object' ? request.feePayer : feePayer;
+                const requested = request.feePayer !== false && (account ?? feePayer);
+                if (credential)
+                    return account;
+                if (requested)
+                    return true;
+                return undefined;
+            })();
+            return { ...request, chainId, escrowContract: resolvedEscrow, feePayer: resolvedFeePayer };
+        },
+        async verify({ credential }) {
+            const { challenge, payload } = credential;
+            const methodDetails = challenge.request.methodDetails;
+            const client = await getClient({ chainId: methodDetails.chainId });
+            const resolvedFeePayer = methodDetails.feePayer === true ? feePayer : undefined;
+            const minVoucherDelta = parseUnits(parameters.minVoucherDelta ?? '0', decimals);
+            const effectiveMinVoucherDelta = methodDetails.minVoucherDelta
+                ? BigInt(methodDetails.minVoucherDelta)
+                : minVoucherDelta;
+            let streamReceipt;
+            switch (payload.action) {
+                case 'open':
+                    streamReceipt = await handleOpen(store, client, challenge, payload, methodDetails, resolvedFeePayer);
+                    break;
+                case 'topUp':
+                    streamReceipt = await handleTopUp(store, client, challenge, payload, methodDetails, resolvedFeePayer);
+                    break;
+                case 'voucher':
+                    streamReceipt = await handleVoucher(store, client, effectiveMinVoucherDelta, challenge, payload, methodDetails);
+                    break;
+                case 'close':
+                    streamReceipt = await handleClose(store, client, challenge, payload, methodDetails, account);
+                    break;
+                default:
+                    throw new BadRequestError({
+                        reason: `unknown action: ${payload.action}`,
+                    });
+            }
+            return streamReceipt;
+        },
+        // This hook acts as a gate: when it returns a Response, `withReceipt()`
+        // in Mppx.ts short-circuits and returns that response directly without
+        // invoking the user's route handler. When it returns undefined, the
+        // user's handler runs normally and serves content.
+        //
+        // Management actions (open, topUp, close) are always gated — they
+        // return 204 regardless of request method.
+        //
+        // Voucher POSTs are gated only when they have no request body, which
+        // signals a mid-stream voucher update (the client is just topping up
+        // the channel balance). Voucher POSTs WITH a body are content requests
+        // (e.g., an API call to a POST endpoint) and fall through to the
+        // user's handler. GET requests with vouchers always fall through so
+        // auto-mode clients (whose fetch wrapper bundles open+voucher into a
+        // single GET retry) receive content as expected.
+        respond({ credential, input }) {
+            const { payload } = credential;
+            if (payload.action === 'close')
+                return new Response(null, { status: 204 });
+            const isManagement = payload.action === 'open' || payload.action === 'topUp';
+            if (isManagement && input.method === 'POST')
+                return new Response(null, { status: 204 });
+            const isVoucher = payload.action === 'voucher';
+            if (!isVoucher)
+                return undefined;
+            // Only gate voucher POSTs with no body (mid-stream balance updates).
+            // POSTs with a body are content requests that should reach the handler.
+            if (input.method !== 'POST')
+                return undefined;
+            const contentLength = input.headers.get('content-length');
+            if (contentLength !== null && contentLength !== '0')
+                return undefined;
+            if (input.headers.has('transfer-encoding'))
+                return undefined;
+            return new Response(null, { status: 204 });
+        },
+    });
+}
+/**
+ * One-shot settle: reads highest voucher from store and submits on-chain.
+ */
+export async function settle(store, client, channelId, escrowContract) {
+    const channel = await store.getChannel(channelId);
+    if (!channel)
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    if (!channel.highestVoucher)
+        throw new VerificationFailedError({ reason: 'no voucher to settle' });
+    const chainId = client.chain?.id;
+    const resolvedEscrow = escrowContract ?? defaults.escrowContract[chainId];
+    if (!resolvedEscrow)
+        throw new Error(`No escrow contract for chainId ${chainId}.`);
+    const settledAmount = channel.highestVoucher.cumulativeAmount;
+    const txHash = await settleOnChain(client, resolvedEscrow, channel.highestVoucher);
+    await store.updateChannel(channelId, (current) => {
+        if (!current)
+            return null;
+        const nextSettled = settledAmount > current.settledOnChain ? settledAmount : current.settledOnChain;
+        return { ...current, settledOnChain: nextSettled };
+    });
+    return txHash;
+}
+/**
+ * Charge against a channel's balance.
+ *
+ * Exported so consumers can deduct from a channel outside the `stream()`
+ * handler (e.g., custom middleware, the SSE `serve()` loop, or direct tests).
+ *
+ * Delegates to the shared `deductFromChannel` atomic helper and translates
+ * failure modes into typed errors (`InsufficientBalanceError`, `ChannelClosedError`).
+ */
+export async function charge(store, channelId, amount) {
+    let result;
+    try {
+        result = await ChannelStore.deductFromChannel(store, channelId, amount);
+    }
+    catch {
+        throw new ChannelClosedError({ reason: 'channel not found' });
+    }
+    if (!result.ok) {
+        const available = result.channel.highestVoucherAmount - result.channel.spent;
+        throw new InsufficientBalanceError({
+            reason: `requested ${amount}, available ${available}`,
+        });
+    }
+    return result.channel;
+}
+/**
+ * Validate on-chain channel state.
+ */
+function validateOnChainChannel(onChain, recipient, currency, amount) {
+    if (onChain.deposit === 0n) {
+        throw new ChannelNotFoundError({ reason: 'channel not funded on-chain' });
+    }
+    if (onChain.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is finalized on-chain' });
+    }
+    if (onChain.closeRequestedAt !== 0n) {
+        throw new ChannelClosedError({ reason: 'channel has a pending close request' });
+    }
+    if (onChain.payee.toLowerCase() !== recipient.toLowerCase()) {
+        throw new VerificationFailedError({
+            reason: 'on-chain payee does not match server destination',
+        });
+    }
+    if (onChain.token.toLowerCase() !== currency.toLowerCase()) {
+        throw new VerificationFailedError({ reason: 'on-chain token does not match server token' });
+    }
+    if (amount !== undefined && onChain.deposit - onChain.settled < amount) {
+        throw new InsufficientBalanceError({
+            reason: 'channel available balance insufficient for requested amount',
+        });
+    }
+}
+/**
+ * Shared logic for verifying an incremental voucher and updating channel state.
+ * Used by both handleVoucher and (indirectly) handleOpen.
+ */
+async function verifyAndAcceptVoucher(parameters) {
+    const { store, minVoucherDelta, challenge, channel, channelId, voucher, onChain, methodDetails } = parameters;
+    if (onChain.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is finalized on-chain' });
+    }
+    if (onChain.closeRequestedAt !== 0n) {
+        throw new ChannelClosedError({ reason: 'channel has a pending close request' });
+    }
+    if (voucher.cumulativeAmount < onChain.settled) {
+        throw new VerificationFailedError({
+            reason: 'voucher cumulativeAmount is below on-chain settled amount',
+        });
+    }
+    if (voucher.cumulativeAmount > onChain.deposit) {
+        throw new AmountExceedsDepositError({ reason: 'voucher amount exceeds on-chain deposit' });
+    }
+    if (voucher.cumulativeAmount <= channel.highestVoucherAmount) {
+        return createStreamReceipt({
+            challengeId: challenge.id,
+            channelId,
+            acceptedCumulative: channel.highestVoucherAmount,
+            spent: channel.spent,
+            units: channel.units,
+        });
+    }
+    const delta = voucher.cumulativeAmount - channel.highestVoucherAmount;
+    if (delta < minVoucherDelta) {
+        throw new DeltaTooSmallError({
+            reason: `voucher delta ${delta} below minimum ${minVoucherDelta}`,
+        });
+    }
+    const isValid = await verifyVoucher(methodDetails.escrowContract, methodDetails.chainId, voucher, channel.authorizedSigner);
+    if (!isValid) {
+        throw new InvalidSignatureError({ reason: 'invalid voucher signature' });
+    }
+    const updated = await store.updateChannel(channelId, (current) => {
+        if (!current)
+            throw new ChannelNotFoundError({ reason: 'channel not found' });
+        if (voucher.cumulativeAmount > current.highestVoucherAmount) {
+            return {
+                ...current,
+                deposit: onChain.deposit,
+                highestVoucherAmount: voucher.cumulativeAmount,
+                highestVoucher: voucher,
+            };
+        }
+        return current;
+    });
+    if (!updated)
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    return createStreamReceipt({
+        challengeId: challenge.id,
+        channelId,
+        acceptedCumulative: updated.highestVoucherAmount,
+        spent: updated.spent,
+        units: updated.units,
+    });
+}
+/**
+ * Handle 'open' action - broadcast open transaction, verify voucher, and create channel.
+ */
+async function handleOpen(store, client, challenge, payload, methodDetails, feePayer) {
+    const voucher = parseVoucherFromPayload(payload.channelId, payload.cumulativeAmount, payload.signature);
+    const recipient = challenge.request.recipient;
+    const currency = challenge.request.currency;
+    const amount = challenge.request.amount ? BigInt(challenge.request.amount) : undefined;
+    const { onChain, txHash } = await broadcastOpenTransaction({
+        client,
+        serializedTransaction: payload.transaction,
+        escrowContract: methodDetails.escrowContract,
+        channelId: payload.channelId,
+        recipient,
+        currency,
+        feePayer,
+    });
+    validateOnChainChannel(onChain, recipient, currency, amount);
+    const authorizedSigner = onChain.authorizedSigner === '0x0000000000000000000000000000000000000000'
+        ? onChain.payer
+        : onChain.authorizedSigner;
+    if (voucher.cumulativeAmount > onChain.deposit) {
+        throw new AmountExceedsDepositError({ reason: 'voucher amount exceeds on-chain deposit' });
+    }
+    if (voucher.cumulativeAmount < onChain.settled) {
+        throw new VerificationFailedError({
+            reason: 'voucher cumulativeAmount is below on-chain settled amount',
+        });
+    }
+    const isValid = await verifyVoucher(methodDetails.escrowContract, methodDetails.chainId, voucher, authorizedSigner);
+    if (!isValid) {
+        throw new InvalidSignatureError({ reason: 'invalid voucher signature' });
+    }
+    const updated = await store.updateChannel(payload.channelId, (existing) => {
+        if (existing) {
+            if (voucher.cumulativeAmount < existing.settledOnChain) {
+                throw new VerificationFailedError({
+                    reason: 'voucher amount is below settled on-chain amount',
+                });
+            }
+            if (voucher.cumulativeAmount > existing.highestVoucherAmount) {
+                return {
+                    ...existing,
+                    deposit: onChain.deposit,
+                    highestVoucherAmount: voucher.cumulativeAmount,
+                    highestVoucher: voucher,
+                    authorizedSigner,
+                };
+            }
+            return {
+                ...existing,
+                deposit: onChain.deposit,
+                authorizedSigner,
+            };
+        }
+        return {
+            channelId: payload.channelId,
+            chainId: methodDetails.chainId,
+            escrowContract: methodDetails.escrowContract,
+            payer: onChain.payer,
+            payee: onChain.payee,
+            token: onChain.token,
+            authorizedSigner,
+            deposit: onChain.deposit,
+            settledOnChain: 0n,
+            highestVoucherAmount: voucher.cumulativeAmount,
+            highestVoucher: voucher,
+            spent: 0n,
+            units: 0,
+            finalized: false,
+            createdAt: new Date().toISOString(),
+        };
+    });
+    if (!updated)
+        throw new VerificationFailedError({ reason: 'failed to create channel' });
+    return createStreamReceipt({
+        challengeId: challenge.id,
+        channelId: payload.channelId,
+        acceptedCumulative: updated.highestVoucherAmount,
+        spent: updated.spent,
+        units: updated.units,
+        txHash,
+    });
+}
+/**
+ * Handle 'topUp' action - broadcast topUp transaction and update channel deposit.
+ *
+ * Per spec Section 8.3.2, topUp payloads contain only the transaction and
+ * additionalDeposit — no voucher. The client must send a separate 'voucher'
+ * action to authorize spending the new funds.
+ */
+async function handleTopUp(store, client, challenge, payload, methodDetails, feePayer) {
+    const channel = await store.getChannel(payload.channelId);
+    if (!channel) {
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    }
+    const declaredDeposit = BigInt(payload.additionalDeposit);
+    const { newDeposit: onChainDeposit } = await broadcastTopUpTransaction({
+        client,
+        serializedTransaction: payload.transaction,
+        escrowContract: methodDetails.escrowContract,
+        channelId: payload.channelId,
+        declaredDeposit,
+        previousDeposit: channel.deposit,
+        feePayer,
+    });
+    const updated = await store.updateChannel(payload.channelId, (current) => {
+        if (!current)
+            throw new ChannelNotFoundError({ reason: 'channel not found' });
+        return { ...current, deposit: onChainDeposit };
+    });
+    return createStreamReceipt({
+        challengeId: challenge.id,
+        channelId: payload.channelId,
+        acceptedCumulative: updated?.highestVoucherAmount ?? channel.highestVoucherAmount,
+        spent: updated?.spent ?? channel.spent,
+        units: updated?.units ?? channel.units,
+    });
+}
+/**
+ * Handle 'voucher' action - verify and accept a new voucher.
+ */
+async function handleVoucher(store, _client, minVoucherDelta, challenge, payload, methodDetails) {
+    const channel = await store.getChannel(payload.channelId);
+    if (!channel) {
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    }
+    if (channel.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is finalized' });
+    }
+    const voucher = parseVoucherFromPayload(payload.channelId, payload.cumulativeAmount, payload.signature);
+    // Use locally-stored channel state as a trusted cache instead of
+    // reading on-chain for every voucher. The on-chain state is verified
+    // during `open` and `topUp` actions — subsequent vouchers within the
+    // same session can safely use the cached deposit/signer values.
+    // This avoids an RPC round-trip per voucher, which is critical for
+    // high-frequency SSE streaming where vouchers arrive per-token.
+    const cachedOnChain = {
+        payer: channel.payer,
+        payee: channel.payee,
+        token: channel.token,
+        deposit: channel.deposit,
+        settled: channel.settledOnChain,
+        finalized: channel.finalized,
+        authorizedSigner: channel.authorizedSigner,
+        closeRequestedAt: 0n,
+    };
+    return verifyAndAcceptVoucher({
+        store,
+        minVoucherDelta,
+        challenge,
+        channel,
+        channelId: payload.channelId,
+        voucher,
+        onChain: cachedOnChain,
+        methodDetails,
+    });
+}
+/**
+ * Handle 'close' action - verify final voucher and close channel.
+ */
+async function handleClose(store, client, challenge, payload, methodDetails, account) {
+    const channel = await store.getChannel(payload.channelId);
+    if (!channel) {
+        throw new ChannelNotFoundError({ reason: 'channel not found' });
+    }
+    if (channel.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is already finalized' });
+    }
+    const voucher = parseVoucherFromPayload(payload.channelId, payload.cumulativeAmount, payload.signature);
+    if (voucher.cumulativeAmount < channel.highestVoucherAmount) {
+        throw new VerificationFailedError({
+            reason: 'close voucher amount must be >= highest accepted voucher',
+        });
+    }
+    const onChain = await getOnChainChannel(client, methodDetails.escrowContract, payload.channelId);
+    if (onChain.finalized) {
+        throw new ChannelClosedError({ reason: 'channel is finalized on-chain' });
+    }
+    if (voucher.cumulativeAmount < onChain.settled) {
+        throw new VerificationFailedError({
+            reason: 'close voucher cumulativeAmount is below on-chain settled amount',
+        });
+    }
+    if (voucher.cumulativeAmount > onChain.deposit) {
+        throw new AmountExceedsDepositError({
+            reason: 'close voucher amount exceeds on-chain deposit',
+        });
+    }
+    const isValid = await verifyVoucher(methodDetails.escrowContract, methodDetails.chainId, voucher, channel.authorizedSigner);
+    if (!isValid) {
+        throw new InvalidSignatureError({ reason: 'invalid voucher signature' });
+    }
+    const txHash = await closeOnChain(client, methodDetails.escrowContract, voucher, account);
+    const updated = await store.updateChannel(payload.channelId, (current) => {
+        if (!current)
+            return null;
+        return {
+            ...current,
+            deposit: onChain.deposit,
+            highestVoucherAmount: voucher.cumulativeAmount,
+            highestVoucher: voucher,
+            finalized: true,
+        };
+    });
+    return createStreamReceipt({
+        challengeId: challenge.id,
+        channelId: payload.channelId,
+        acceptedCumulative: voucher.cumulativeAmount,
+        spent: updated?.spent ?? channel.spent,
+        units: updated?.units ?? channel.units,
+        ...(txHash !== undefined && { txHash }),
+    });
+}
+//# sourceMappingURL=Session.js.map

package/dist/tempo/server/Session.js.map

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

package/dist/tempo/server/internal/transport.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tempo-specific SSE transport that wraps the base HTTP transport
+ * with metering logic (context capture from credentials, per-token
+ * charging via Sse.serve).
+ *
+ * @internal
+ */
+import * as Transport from '../../../server/Transport.js';
+import type * as ChannelStore from '../../stream/ChannelStore.js';
+import * as Sse_core from '../../stream/Sse.js';
+/** SSE transport with Tempo stream controller. */
+export type Sse = Transport.Sse<Sse_core.StreamController>;
+/**
+ * Creates a Tempo-metered SSE transport.
+ *
+ * Wraps an HTTP transport with:
+ * - Context capture from credentials (channelId, tickCost)
+ * - Per-token charging via Sse.serve for generator/iterable responses
+ * - Auto-detection of upstream SSE responses
+ * - Fallback to standard HTTP receipt handling for plain Response
+ */
+export declare function sse(options: sse.Options & {
+    store: ChannelStore.ChannelStore;
+}): Sse;
+export declare namespace sse {
+    type Options = {
+        /**
+         * When true, the charge loop uses polling instead of `waitForUpdate()`.
+         *
+         * Required for runtimes like Cloudflare Workers where resolving promises
+         * across request contexts is not supported. Without this flag, a mid-stream
+         * voucher POST (Request B) would resolve a waiter created in the streaming
+         * request context (Request A), causing a Workers error.
+         *
+         * @default false
+         */
+        poll?: boolean | undefined;
+        /** Polling interval (in milliseconds). @default 10 */
+        pollingInterval?: number | undefined;
+    };
+}
+/** Default SSE serve: iterates values and emits `event: message` per value. */
+export declare function defaultServe(options: {
+    generate: AsyncIterable<string> | ((...args: any[]) => AsyncIterable<string>);
+    challengeId: string;
+}): Response;
+//# sourceMappingURL=transport.d.ts.map

package/dist/tempo/server/internal/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/tempo/server/internal/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,SAAS,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,KAAK,YAAY,MAAM,8BAA8B,CAAA;AACjE,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAE/C,kDAAkD;AAClD,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG;IAAE,KAAK,EAAE,YAAY,CAAC,YAAY,CAAA;CAAE,GAAG,GAAG,CAsEpF;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,KAAK,OAAO,GAAG;QACb;;;;;;;;;WASG;QACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC1B,sDAAsD;QACtD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACrC,CAAA;CACF;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,QAAQ,CAwBX"}