mppx 0.6.31 → 0.7.0

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

@@ -0,0 +1,208 @@
+import { type Account as viem_Account, type Address, type Hex } from 'viem';
+import * as Constants from '../../../Constants.js';
+import type * as Credential from '../../../Credential.js';
+import type { Challenge } from '../../../index.js';
+import type * as z from '../../../zod.js';
+import * as Methods from '../../Methods.js';
+import { isSessionContentRequest, type RequestBodyProbe } from '../../server/internal/request-body.js';
+import type * as PrecompileChain from '../precompile/Chain.js';
+import { type SessionCredentialPayload } from '../precompile/Protocol.js';
+import type { SessionSnapshot } from '../Snapshot.js';
+import * as ChannelStore from './ChannelStore.js';
+import { type ParameterFeePayer } from './Settlement.js';
+/** Inputs used to build server bootstrap hints for a reusable session channel. */
+export type ResolveSessionSnapshotParameters = {
+    /** Raw request amount that must be covered by the next voucher. */
+    amount: bigint;
+    /** Channel ID from credential or challenge request, when available. */
+    channelId: Hex | undefined;
+    /** Payment fields the reusable channel must match before it is advertised. */
+    expected?: SessionSnapshotPaymentFields | undefined;
+    /** Server channel store. */
+    store: ChannelStore.ChannelStore;
+};
+/** Payment fields used to bind a reusable channel hint to the current challenge. */
+export type SessionSnapshotPaymentFields = {
+    /** Tempo chain ID expected by the challenge. */
+    chainId: number;
+    /** Token address expected by the challenge. */
+    currency: Address;
+    /** Escrow precompile address expected by the challenge. */
+    escrowContract: Address;
+    /** Payee address expected by the challenge. */
+    recipient: Address;
+};
+/** Request metadata available to `resolveChannelId` without exposing a mutable `Request`. */
+export type SessionChannelIdRequest = {
+    /** Request headers, useful for cookies or auth/session headers. */
+    readonly headers: Headers;
+    /** Whether the original request had a body, when known. */
+    readonly hasBody?: boolean | undefined;
+    /** HTTP method for the protected request. */
+    readonly method: string;
+    /** Request URL, when the transport captured it. */
+    readonly url?: URL | undefined;
+};
+/** Inputs for resolving a reusable channel when the request did not include a channel ID. */
+export type ResolveSessionChannelIdParameters = {
+    /** Captured HTTP request metadata, when the transport provides it. */
+    request?: SessionChannelIdRequest | undefined;
+    /** Credential submitted with the request, when present. */
+    credential: Credential.Credential | null | undefined;
+    /** Cryptographic payer identity from a verified zero-amount bootstrap proof. */
+    source?: string | undefined;
+    /** Session payment request being challenged. */
+    paymentRequest: SessionPaymentRequestInput;
+    /** Channel store backing this session method. */
+    store: ChannelStore.ChannelStore;
+};
+/** Application hook for mapping request identity to an existing session channel. */
+export type ResolveSessionChannelId = (parameters: ResolveSessionChannelIdParameters) => Promise<string | null | undefined> | string | null | undefined;
+/** Normalizes a session channel ID hint when one is present. */
+export declare function normalizeSessionChannelId(value: unknown): Hex | undefined;
+/** Extracts and normalizes a credential channel ID after credential verification. */
+export declare function getCredentialChannelId(credential: Credential.Credential | null | undefined): `0x${string}` | undefined;
+/** Resolves the channel ID used to build server-side session bootstrap hints. */
+export declare function resolveSessionChannelId(parameters: {
+    capturedRequest?: RequestBodyProbe | undefined;
+    credential: Credential.Credential | null | undefined;
+    request: SessionPaymentRequestInput;
+    resolveChannelId?: ResolveSessionChannelId | undefined;
+    source?: string | undefined;
+    store: ChannelStore.ChannelStore;
+}): Promise<Hex | undefined>;
+/** Builds server bootstrap hints for a reusable precompile session channel. */
+export declare function resolveSessionSnapshot(parameters: ResolveSessionSnapshotParameters): Promise<SessionSnapshot | undefined>;
+/** Inputs for deciding whether a verified session credential should serve content. */
+export type SessionResponseGateParameters = {
+    /** Captured request metadata from the verification envelope, when available. */
+    capturedRequest?: Parameters<typeof isSessionContentRequest>[0] | undefined;
+    /** Raw HTTP request used as a fallback when no captured metadata exists. */
+    input: Request;
+    /** Credential payload or minimal action-bearing payload. */
+    payload: SessionCredentialPayload | {
+        action?: unknown;
+    };
+};
+/**
+ * Returns a management response for non-content session actions.
+ *
+ * `close` and `topUp` are always management-only. `open` and `voucher` serve
+ * content only when the request classifier says the request is billable.
+ */
+export declare function respondToSessionCredential(parameters: SessionResponseGateParameters): Response | undefined;
+type ChainIdClient = {
+    chain?: {
+        id?: number | undefined;
+    } | undefined;
+};
+/** Public request input accepted by the tempo session method before schema normalization. */
+export type SessionPaymentRequestInput = z.input<typeof Methods.session.schema.request>;
+/** Canonical request shape embedded in signed `tempo/session` challenges. */
+export type CanonicalSessionPaymentRequest = z.output<typeof Methods.session.schema.request>;
+/** Canonical challenge request after required TIP-1034 method details have been proven present. */
+export type VerifiedSessionPaymentRequest = CanonicalSessionPaymentRequest & {
+    /** Required TIP-1034 method details for credential verification. */
+    methodDetails: SessionMethodDetails;
+};
+/** Session request input after server-side chain, escrow, fee-payer, and snapshot defaults are added. */
+export type ResolvedSessionPaymentRequest = SessionPaymentRequestInput & {
+    chainId: number;
+    escrowContract: Address;
+    feePayer?: boolean | viem_Account | undefined;
+    operator?: Address | undefined;
+    sessionSnapshot?: SessionSnapshot | undefined;
+};
+/** TIP-1034 session details embedded in a payment challenge request. */
+export type SessionMethodDetails = {
+    /** Tempo chain ID used for voucher domain and channel ID checks. */
+    chainId: number;
+    /** TIP20EscrowChannel precompile address for this challenge. */
+    escrowContract: Address;
+    /** Whether this challenge allows fee-sponsored management transactions. */
+    feePayer?: boolean | undefined;
+    /** Minimum raw-unit increase required for voucher credentials. */
+    minVoucherDelta?: string | undefined;
+    /** Channel operator address the client should encode in new open transactions. */
+    operator?: Address | undefined;
+    /** Tempo session protocol version for this challenge. */
+    sessionProtocol?: Constants.SessionProtocol | undefined;
+};
+/** Inputs used to resolve the chain ID for a session challenge. */
+export type ResolveRequestChainIdParameters = {
+    getClient(parameters: {
+        chainId?: number | undefined;
+    }): ChainIdClient | Promise<ChainIdClient>;
+    parameterChainId?: number | undefined;
+    requestChainId?: number | undefined;
+};
+/** Inputs used to enrich a server session payment request before challenge creation. */
+export type ResolveSessionPaymentRequestParameters = {
+    capturedRequest?: RequestBodyProbe | undefined;
+    credential: Credential.Credential | null | undefined;
+    decimals: number;
+    defaultFeePayer?: viem_Account | undefined;
+    getClient: ResolveRequestChainIdParameters['getClient'];
+    parameterChainId?: number | undefined;
+    parameterEscrowContract?: Address | undefined;
+    parameterFeePayer?: ParameterFeePayer;
+    request: SessionPaymentRequestInput;
+    resolveChannelId?: ResolveSessionChannelId | undefined;
+    source?: string | undefined;
+    store: ChannelStore.ChannelStore;
+};
+/** Inputs used to resolve shared context for credential verification. */
+export type ResolveCredentialVerificationContextParameters = {
+    /** Default configured fee-payer account, when enabled. */
+    feePayer?: viem_Account | undefined;
+    /** Resolves a viem client for the challenge chain ID. */
+    getClient(parameters: {
+        chainId: number;
+    }): PrecompileChain.TransactionClient | Promise<PrecompileChain.TransactionClient>;
+    /** Default human-readable minimum voucher delta configured on `session()`. */
+    minVoucherDelta?: string | undefined;
+    /** Token decimals used to parse default minimum voucher delta. */
+    decimals: number;
+    /** Canonical or schema-input request being verified. */
+    request: unknown;
+};
+/** Shared context derived from the HMAC-bound challenge request for credential verification. */
+export type CredentialVerificationContext = {
+    /** Canonical session request shape. */
+    request: VerifiedSessionPaymentRequest;
+    /** Required TIP-1034 method details embedded in the challenge request. */
+    methodDetails: SessionMethodDetails;
+    /** Challenge chain ID. */
+    chainId: number;
+    /** Challenge escrow precompile address. */
+    escrow: Address;
+    /** Client for precompile reads and transaction broadcasts. */
+    client: PrecompileChain.TransactionClient;
+    /** Fee payer authorized for this credential, when allowed. */
+    feePayer?: viem_Account | undefined;
+    /** Minimum allowed voucher delta in raw token units. */
+    minVoucherDelta: bigint;
+};
+/** Payment fields extracted from the credential challenge request. */
+export type ChallengePaymentFields = {
+    /** Raw request amount in token units. */
+    amount: bigint;
+    /** Token address expected by the server. */
+    currency: Address;
+    /** Payee address expected by the server. */
+    recipient: Address;
+};
+/** Reads the destination, token, and raw amount from a session challenge request. */
+export declare function getChallengePaymentFields(challenge: Challenge.Challenge): ChallengePaymentFields;
+/** Resolves the chain ID from request override, method parameters, or client config. */
+export declare function resolveRequestChainId(parameters: ResolveRequestChainIdParameters): Promise<number | undefined>;
+/** Resolves request-time TIP-1034 details and server bootstrap hints for a challenge. */
+export declare function resolveSessionPaymentRequest(parameters: ResolveSessionPaymentRequestParameters): Promise<ResolvedSessionPaymentRequest>;
+/** Parses the canonical session request shape used during credential verification. */
+export declare function resolveVerificationRequest(request: unknown): VerifiedSessionPaymentRequest;
+/** Returns required TIP-1034 method details from a canonical session request. */
+export declare function requireMethodDetails(request: VerifiedSessionPaymentRequest): SessionMethodDetails;
+/** Resolves all non-payload verification context from a session challenge request. */
+export declare function resolveCredentialVerificationContext(parameters: ResolveCredentialVerificationContextParameters): Promise<CredentialVerificationContext>;
+export {};
+//# sourceMappingURL=RequestState.d.ts.map

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

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

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

@@ -0,0 +1,252 @@
+import { isAddress, isAddressEqual, parseUnits, } from 'viem';
+import * as Constants from '../../../Constants.js';
+import { VerificationFailedError } from '../../../Errors.js';
+import * as Methods from '../../Methods.js';
+import { captureRequestBodyProbe, isSessionContentRequest, } from '../../server/internal/request-body.js';
+import { tip20ChannelEscrow } from '../precompile/Protocol.js';
+import * as ChannelStore from './ChannelStore.js';
+import { requireSessionCredentialAction } from './CredentialVerification.js';
+import { resolveCredentialFeePayer, resolveRequestFeePayer, } from './Settlement.js';
+/** Normalizes a session channel ID hint when one is present. */
+export function normalizeSessionChannelId(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    try {
+        return ChannelStore.normalizeChannelId(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extracts and normalizes a credential channel ID after credential verification. */
+export function getCredentialChannelId(credential) {
+    if (!isObject(credential?.payload))
+        return undefined;
+    return normalizeSessionChannelId(credential.payload.channelId);
+}
+function normalizeResolvedSessionChannelId(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    return ChannelStore.normalizeChannelId(value);
+}
+/** Resolves the channel ID used to build server-side session bootstrap hints. */
+export async function resolveSessionChannelId(parameters) {
+    const { capturedRequest, credential, request, resolveChannelId, source, store } = parameters;
+    const explicitChannelId = normalizeSessionChannelId(request.channelId);
+    if (explicitChannelId)
+        return explicitChannelId;
+    if (!resolveChannelId)
+        return undefined;
+    return normalizeResolvedSessionChannelId(await resolveChannelId({
+        request: capturedRequest,
+        credential: source ? credential : null,
+        source,
+        paymentRequest: request,
+        store,
+    }));
+}
+/** Builds server bootstrap hints for a reusable precompile session channel. */
+export async function resolveSessionSnapshot(parameters) {
+    const { amount, channelId, expected, store } = parameters;
+    if (!channelId)
+        return undefined;
+    const channel = await store.getChannel(ChannelStore.normalizeChannelId(channelId));
+    if (!channel || !ChannelStore.isPrecompileState(channel))
+        return undefined;
+    if (channel.finalized)
+        return undefined;
+    if (expected && !matchesSnapshotPaymentFields(channel, expected))
+        return undefined;
+    const requiredCumulative = channel.spent + amount;
+    const acceptedCumulative = channel.highestVoucherAmount > requiredCumulative
+        ? channel.highestVoucherAmount
+        : requiredCumulative;
+    return {
+        acceptedCumulative: acceptedCumulative.toString(),
+        chainId: channel.chainId,
+        channelId: channel.channelId,
+        closeRequestedAt: channel.closeRequestedAt === 0n ? undefined : channel.closeRequestedAt.toString(),
+        deposit: channel.deposit.toString(),
+        descriptor: channel.descriptor,
+        escrow: channel.escrowContract,
+        requiredCumulative: requiredCumulative.toString(),
+        settled: channel.settledOnChain.toString(),
+        spent: channel.spent.toString(),
+        units: channel.units,
+    };
+}
+function matchesSnapshotPaymentFields(channel, expected) {
+    return (channel.chainId === expected.chainId &&
+        isAddressEqual(channel.escrowContract, expected.escrowContract) &&
+        isAddressEqual(channel.payee, expected.recipient) &&
+        isAddressEqual(channel.token, expected.currency));
+}
+/**
+ * Returns a management response for non-content session actions.
+ *
+ * `close` and `topUp` are always management-only. `open` and `voucher` serve
+ * content only when the request classifier says the request is billable.
+ */
+export function respondToSessionCredential(parameters) {
+    const action = requireSessionCredentialAction(parameters.payload);
+    if (action === 'close')
+        return new Response(null, { status: 204 });
+    if (action === 'topUp')
+        return new Response(null, { status: 204 });
+    const request = parameters.capturedRequest ?? captureRequestBodyProbe(parameters.input);
+    if (isSessionContentRequest(request))
+        return undefined;
+    return new Response(null, { status: 204 });
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isCanonicalSessionMethodDetails(value) {
+    return (isObject(value) &&
+        typeof value.chainId === 'number' &&
+        typeof value.escrowContract === 'string' &&
+        isAddress(value.escrowContract, { strict: false }) &&
+        (value.feePayer === undefined || typeof value.feePayer === 'boolean') &&
+        (value.minVoucherDelta === undefined || typeof value.minVoucherDelta === 'string') &&
+        (value.operator === undefined ||
+            (typeof value.operator === 'string' && isAddress(value.operator, { strict: false }))) &&
+        (value.sessionProtocol === undefined || value.sessionProtocol === Constants.SessionProtocols.v2));
+}
+function isVerifiedSessionPaymentRequest(request) {
+    return (isObject(request) &&
+        typeof request.amount === 'string' &&
+        typeof request.currency === 'string' &&
+        typeof request.unitType === 'string' &&
+        isCanonicalSessionMethodDetails(request.methodDetails));
+}
+function readChallengeAddress(value, label) {
+    if (typeof value === 'string' && isAddress(value, { strict: false }))
+        return value;
+    throw new VerificationFailedError({ reason: `missing challenge ${label}` });
+}
+function readChallengeAmount(value) {
+    if (typeof value === 'string')
+        return BigInt(value);
+    throw new VerificationFailedError({ reason: 'missing challenge amount' });
+}
+/** Reads the destination, token, and raw amount from a session challenge request. */
+export function getChallengePaymentFields(challenge) {
+    return {
+        amount: readChallengeAmount(challenge.request.amount),
+        currency: readChallengeAddress(challenge.request.currency, 'currency'),
+        recipient: readChallengeAddress(challenge.request.recipient, 'recipient'),
+    };
+}
+/** Resolves the chain ID from request override, method parameters, or client config. */
+export async function resolveRequestChainId(parameters) {
+    const { getClient, parameterChainId, requestChainId } = parameters;
+    if (requestChainId)
+        return requestChainId;
+    if (parameterChainId)
+        return parameterChainId;
+    return (await getClient({})).chain?.id;
+}
+/** Resolves request-time TIP-1034 details and server bootstrap hints for a challenge. */
+export async function resolveSessionPaymentRequest(parameters) {
+    const { capturedRequest, credential, decimals, defaultFeePayer, getClient, parameterChainId, parameterEscrowContract, parameterFeePayer, request, resolveChannelId, source, store, } = parameters;
+    const chainId = await resolveRequestChainId({
+        getClient,
+        parameterChainId,
+        requestChainId: request.chainId,
+    });
+    if (!chainId)
+        throw new Error('No chainId configured for tempo.session().');
+    const client = await getClient({ chainId });
+    if (client.chain?.id !== chainId)
+        throw new Error(`Client not configured with chainId ${chainId}.`);
+    const escrowContract = resolveRequestEscrowContract(request.escrowContract, parameterEscrowContract);
+    const operator = resolveRequestOperator(request.operator);
+    const requestAmount = parseUnits(request.amount, decimals);
+    const channelId = await resolveSessionChannelId({
+        capturedRequest,
+        credential,
+        request,
+        resolveChannelId,
+        source,
+        store,
+    });
+    const sessionSnapshot = await resolveSessionSnapshot({
+        amount: capturedRequest && !isSessionContentRequest(capturedRequest) ? 0n : requestAmount,
+        channelId,
+        expected: {
+            chainId,
+            currency: readChallengeAddress(request.currency, 'currency'),
+            escrowContract,
+            recipient: readChallengeAddress(request.recipient, 'recipient'),
+        },
+        store,
+    });
+    const { operator: _operator, ...requestWithoutOperator } = request;
+    return {
+        ...requestWithoutOperator,
+        chainId,
+        escrowContract,
+        feePayer: resolveRequestFeePayer({
+            credential,
+            defaultFeePayer,
+            parameterFeePayer,
+            requestFeePayer: request.feePayer,
+        }),
+        ...(operator ? { operator } : {}),
+        ...(sessionSnapshot ? { sessionSnapshot } : {}),
+    };
+}
+function resolveRequestEscrowContract(requestEscrowContract, parameterEscrowContract) {
+    if (typeof requestEscrowContract === 'string') {
+        if (!isAddress(requestEscrowContract, { strict: false }))
+            throw new Error('Invalid escrowContract configured for tempo.session().');
+        return requestEscrowContract;
+    }
+    return parameterEscrowContract ?? tip20ChannelEscrow;
+}
+function resolveRequestOperator(requestOperator) {
+    if (requestOperator === undefined)
+        return undefined;
+    if (typeof requestOperator === 'string' && isAddress(requestOperator, { strict: false }))
+        return requestOperator;
+    throw new Error('Invalid operator configured for tempo.session().');
+}
+/** Parses the canonical session request shape used during credential verification. */
+export function resolveVerificationRequest(request) {
+    const parsed = Methods.session.schema.request.safeParse(request);
+    if (parsed.success && isVerifiedSessionPaymentRequest(parsed.data))
+        return parsed.data;
+    // verifyCredential() passes the HMAC-bound challenge request, which is
+    // already in canonical output form and should not be transformed again.
+    if (isVerifiedSessionPaymentRequest(request))
+        return request;
+    throw new VerificationFailedError({ reason: 'invalid session request' });
+}
+/** Returns required TIP-1034 method details from a canonical session request. */
+export function requireMethodDetails(request) {
+    return request.methodDetails;
+}
+/** Resolves all non-payload verification context from a session challenge request. */
+export async function resolveCredentialVerificationContext(parameters) {
+    const { decimals, feePayer, getClient, minVoucherDelta, request } = parameters;
+    const resolvedRequest = resolveVerificationRequest(request);
+    const methodDetails = requireMethodDetails(resolvedRequest);
+    const chainId = methodDetails.chainId;
+    const client = await getClient({ chainId });
+    return {
+        request: resolvedRequest,
+        methodDetails,
+        chainId,
+        escrow: methodDetails.escrowContract,
+        client,
+        feePayer: resolveCredentialFeePayer({
+            feePayer,
+            methodDetails,
+            request: resolvedRequest,
+        }),
+        minVoucherDelta: methodDetails.minVoucherDelta
+            ? BigInt(methodDetails.minVoucherDelta)
+            : parseUnits(minVoucherDelta ?? '0', decimals),
+    };
+}
+//# sourceMappingURL=RequestState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestState.js","sourceRoot":"","sources":["../../../../src/tempo/session/server/RequestState.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACd,UAAU,GAIX,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAG5D,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAiC,MAAM,2BAA2B,CAAA;AAE7F,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,iBAAiB,CAAA;AAyDxB,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,UAAoD;IACzF,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAAE,OAAO,SAAS,CAAA;IACpD,OAAO,yBAAyB,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,iCAAiC,CAAC,KAAgC;IACzE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC3D,OAAO,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAO7C;IACC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAA;IAC5F,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACtE,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAA;IAC/C,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAA;IACvC,OAAO,iCAAiC,CACtC,MAAM,gBAAgB,CAAC;QACrB,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QACtC,MAAM;QACN,cAAc,EAAE,OAAO;QACvB,KAAK;KACN,CAAC,CACH,CAAA;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA4C;IAE5C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,UAAU,CAAA;IACzD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAChC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAA;IAClF,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAA;IAC1E,IAAI,OAAO,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,IAAI,QAAQ,IAAI,CAAC,4BAA4B,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAA;IAClF,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,GAAG,MAAM,CAAA;IACjD,MAAM,kBAAkB,GACtB,OAAO,CAAC,oBAAoB,GAAG,kBAAkB;QAC/C,CAAC,CAAC,OAAO,CAAC,oBAAoB;QAC9B,CAAC,CAAC,kBAAkB,CAAA;IACxB,OAAO;QACL,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACjD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,gBAAgB,EACd,OAAO,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE;QACnF,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,cAAc;QAC9B,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACjD,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAA;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,OAA6C,EAC7C,QAAsC;IAEtC,OAAO,CACL,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QACpC,cAAc,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC;QAC/D,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;QACjD,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACjD,CAAA;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAyC;IAEzC,MAAM,MAAM,GAAG,8BAA8B,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IAEjE,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IAClE,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IAElE,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,IAAI,uBAAuB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IACvF,IAAI,uBAAuB,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAA;IACtD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;AAC5C,CAAC;AA8GD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAc;IACrD,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QACxC,SAAS,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;QACrE,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC;QAClF,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;YAC3B,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC,CACjG,CAAA;AACH,CAAC;AAED,SAAS,+BAA+B,CACtC,OAAgB;IAEhB,OAAO,CACL,QAAQ,CAAC,OAAO,CAAC;QACjB,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAClC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,+BAA+B,CAAC,OAAO,CAAC,aAAa,CAAC,CACvD,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAClF,MAAM,IAAI,uBAAuB,CAAC,EAAE,MAAM,EAAE,qBAAqB,KAAK,EAAE,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,MAAM,IAAI,uBAAuB,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,SAA8B;IACtE,OAAO;QACL,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QACrD,QAAQ,EAAE,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;QACtE,SAAS,EAAE,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;KAC1E,CAAA;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAA2C;IACrF,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,UAAU,CAAA;IAClE,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IACzC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAA;IAC7C,OAAO,CAAC,MAAM,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAA;AACxC,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAAkD;IAElD,MAAM,EACJ,eAAe,EACf,UAAU,EACV,QAAQ,EACR,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,KAAK,GACN,GAAG,UAAU,CAAA;IAEd,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC;QAC1C,SAAS;QACT,gBAAgB;QAChB,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC,CAAA;IACF,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAE3E,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC3C,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,OAAO;QAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,GAAG,CAAC,CAAA;IAEnE,MAAM,cAAc,GAAG,4BAA4B,CACjD,OAAO,CAAC,cAAc,EACtB,uBAAuB,CACxB,CAAA;IACD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzD,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC1D,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC;QAC9C,eAAe;QACf,UAAU;QACV,OAAO;QACP,gBAAgB;QAChB,MAAM;QACN,KAAK;KACN,CAAC,CAAA;IACF,MAAM,eAAe,GAAG,MAAM,sBAAsB,CAAC;QACnD,MAAM,EAAE,eAAe,IAAI,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa;QACzF,SAAS;QACT,QAAQ,EAAE;YACR,OAAO;YACP,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;YAC5D,cAAc;YACd,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;SAChE;QACD,KAAK;KACN,CAAC,CAAA;IACF,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,GAAG,OAAO,CAAA;IAElE,OAAO;QACL,GAAG,sBAAsB;QACzB,OAAO;QACP,cAAc;QACd,QAAQ,EAAE,sBAAsB,CAAC;YAC/B,UAAU;YACV,eAAe;YACf,iBAAiB;YACjB,eAAe,EAAE,OAAO,CAAC,QAAQ;SAClC,CAAC;QACF,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAA;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,qBAA8B,EAC9B,uBAA4C;IAE5C,IAAI,OAAO,qBAAqB,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC3E,OAAO,qBAAqB,CAAA;IAC9B,CAAC;IACD,OAAO,uBAAuB,IAAI,kBAAkB,CAAA;AACtD,CAAC;AAED,SAAS,sBAAsB,CAAC,eAAwB;IACtD,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACnD,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,SAAS,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACtF,OAAO,eAA0B,CAAA;IACnC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;AACrE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAChE,IAAI,MAAM,CAAC,OAAO,IAAI,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IACtF,uEAAuE;IACvE,wEAAwE;IACxE,IAAI,+BAA+B,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC5D,MAAM,IAAI,uBAAuB,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAA;AAC1E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,OAAsC;IACzE,OAAO,OAAO,CAAC,aAAa,CAAA;AAC9B,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,UAA0D;IAE1D,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,UAAU,CAAA;IAC9E,MAAM,eAAe,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAC3D,MAAM,aAAa,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAA;IACrC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,aAAa;QACb,OAAO;QACP,MAAM,EAAE,aAAa,CAAC,cAAc;QACpC,MAAM;QACN,QAAQ,EAAE,yBAAyB,CAAC;YAClC,QAAQ;YACR,aAAa;YACb,OAAO,EAAE,eAAe;SACzB,CAAC;QACF,eAAe,EAAE,aAAa,CAAC,eAAe;YAC5C,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;YACvC,CAAC,CAAC,UAAU,CAAC,eAAe,IAAI,GAAG,EAAE,QAAQ,CAAC;KACjD,CAAA;AACH,CAAC"}