@oobe-protocol-labs/synapse-sap-sdk 0.15.0 → 0.15.1

package/dist/types/core/connection.d.ts

@@ -1,305 +0,0 @@
-/**
- * @module core/connection
- * @description RPC connection factory for SAP v2 SDK.
- *
- * Provides a high-level, synapse-client-sdk–compatible entry point
- * for creating {@link SapClient} instances from an RPC URL and wallet.
- *
- * @category Core
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { SapConnection } from "@synapse-sap/sdk";
- *
- * // Quick start — RPC URL + Keypair
- * const sap = SapConnection.fromKeypair("https://api.devnet.solana.com", keypair);
- * const agent = await sap.client.agent.fetch();
- *
- * // Or build step-by-step
- * const conn = new SapConnection({
- *   rpcUrl: "https://us-1-mainnet.oobeprotocol.ai/rpc?api_key=xxx",
- *   cluster: "mainnet-beta",
- *   commitment: "confirmed",
- * });
- * const client = conn.createClient(wallet);
- * ```
- */
-import { Connection, type Commitment, Keypair, type PublicKey, type Transaction, type VersionedTransaction } from "@solana/web3.js";
-import { SapClient } from "./client";
-/**
- * @interface SapWallet
- * @description Minimal wallet/signer interface compatible with
- * Anchor's `AnchorProvider`. Avoids importing `Wallet` from
- * `@coral-xyz/anchor` which is absent in ESM builds.
- * @category Core
- * @since v0.4.1
- */
-export interface SapWallet {
-    readonly publicKey: PublicKey;
-    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
-    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
-}
-/**
- * @name KeypairWallet
- * @description Simple wallet wrapper around a `Keypair`.
- * Drop-in replacement for Anchor's `NodeWallet` / `Wallet` class.
- * @category Core
- * @since v0.4.1
- */
-export declare class KeypairWallet implements SapWallet {
-    readonly payer: Keypair;
-    readonly publicKey: PublicKey;
-    constructor(payer: Keypair);
-    signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
-    signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
-}
-/**
- * @name SapCluster
- * @description Supported Solana cluster names used to select the RPC endpoint
- * and corresponding SAP program ID.
- * @category Core
- * @since v0.1.0
- */
-export type SapCluster = "mainnet-beta" | "devnet" | "localnet";
-/**
- * @interface SapConnectionConfig
- * @description Configuration object used to initialise a {@link SapConnection}.
- * @category Core
- * @since v0.1.0
- * @see {@link SapConnection}
- */
-export interface SapConnectionConfig {
-    /**
-     * @property {string} rpcUrl
-     * @description Solana JSON-RPC endpoint URL (e.g. `https://api.devnet.solana.com`).
-     */
-    rpcUrl: string;
-    /**
-     * @property {string} [wsUrl]
-     * @description WebSocket endpoint URL. When omitted the SDK derives it
-     * automatically from {@link rpcUrl} by swapping the protocol scheme.
-     */
-    wsUrl?: string;
-    /**
-     * @property {Commitment} [commitment]
-     * @description Commitment level for queries and transaction confirmations.
-     * Defaults to `"confirmed"` when not provided.
-     */
-    commitment?: Commitment;
-    /**
-     * @property {SapCluster} [cluster]
-     * @description Cluster hint (`mainnet-beta` | `devnet` | `localnet`).
-     * When omitted the SDK infers it from {@link rpcUrl} via
-     * {@link SapConnection.detectCluster}.
-     */
-    cluster?: SapCluster;
-}
-/**
- * @name SapConnection
- * @description Lightweight RPC connection wrapper that creates
- * properly-configured {@link SapClient} instances.
- *
- * Compatible with the `synapse-client-sdk` connection model:
- * start from an RPC URL, attach a wallet, get a typed client.
- *
- * @category Core
- * @since v0.1.0
- * @see {@link SapClient}
- * @see {@link SapConnectionConfig}
- *
- * @example
- * ```ts
- * // Factory shortcut for devnet
- * const conn = SapConnection.devnet();
- * const client = conn.createClient(wallet);
- *
- * // One-liner with Keypair
- * const { client } = SapConnection.fromKeypair(
- *   "https://api.devnet.solana.com",
- *   keypair,
- * );
- * ```
- */
-export declare class SapConnection {
-    /**
-     * @readonly
-     * @description Raw Solana {@link Connection}. Exposed for advanced
-     * use-cases that need direct RPC access.
-     */
-    readonly connection: Connection;
-    /**
-     * @readonly
-     * @description The resolved Solana cluster for this connection,
-     * either explicitly provided or auto-detected from the RPC URL.
-     */
-    readonly cluster: SapCluster;
-    /**
-     * @readonly
-     * @description Commitment level used for all queries and
-     * transaction confirmations on this connection.
-     */
-    readonly commitment: Commitment;
-    /**
-     * @readonly
-     * @description The SAP on-chain program {@link PublicKey} resolved
-     * for the current {@link cluster}.
-     * @see {@link SapConnection.programIdForCluster}
-     */
-    readonly programId: PublicKey;
-    constructor(config: SapConnectionConfig);
-    /**
-     * Create a {@link SapConnection} for **devnet** with sensible defaults.
-     *
-     * @static
-     * @param {Commitment} [commitment="confirmed"] — Commitment level.
-     * @returns {SapConnection} A connection targeting Solana devnet.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const conn = SapConnection.devnet();
-     * ```
-     */
-    static devnet(commitment?: Commitment): SapConnection;
-    /**
-     * Create a {@link SapConnection} for **mainnet-beta** with sensible defaults.
-     *
-     * @static
-     * @param {string} [rpcUrl="https://api.mainnet-beta.solana.com"] — Custom RPC URL.
-     * @param {Commitment} [commitment="confirmed"] — Commitment level.
-     * @returns {SapConnection} A connection targeting Solana mainnet-beta.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const conn = SapConnection.mainnet("https://my-rpc.example.com");
-     * ```
-     */
-    static mainnet(rpcUrl?: string, commitment?: Commitment): SapConnection;
-    /**
-     * Create a {@link SapConnection} for **localnet** (`localhost:8899`).
-     *
-     * @static
-     * @param {Commitment} [commitment="confirmed"] — Commitment level.
-     * @returns {SapConnection} A connection targeting a local validator.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const conn = SapConnection.localnet();
-     * ```
-     */
-    static localnet(commitment?: Commitment): SapConnection;
-    /**
-     * One-liner: create a {@link SapConnection} + {@link SapClient} from
-     * an RPC URL and a `Keypair`. Perfect for scripts and CLI tools.
-     *
-     * @static
-     * @param {string} rpcUrl — Solana JSON-RPC endpoint.
-     * @param {Keypair} keypair — Signer keypair.
-     * @param {object} [opts] — Optional overrides.
-     * @param {Commitment} [opts.commitment] — Commitment level.
-     * @param {SapCluster} [opts.cluster] — Explicit cluster hint.
-     * @returns {SapConnection & { readonly client: SapClient }} Connection with an attached client.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const { client, connection } = SapConnection.fromKeypair(
-     *   "https://api.devnet.solana.com",
-     *   Keypair.generate(),
-     * );
-     * ```
-     */
-    static fromKeypair(rpcUrl: string, keypair: Keypair, opts?: {
-        commitment?: Commitment;
-        cluster?: SapCluster;
-    }): SapConnection & {
-        readonly client: SapClient;
-    };
-    /**
-     * Create a {@link SapClient} from a {@link SapWallet} (signer).
-     *
-     * @param {SapWallet} wallet — A wallet/signer implementing {@link SapWallet}.
-     * @returns {SapClient} A fully-configured SAP client.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const client = conn.createClient(new KeypairWallet(keypair));
-     * ```
-     */
-    createClient(wallet: SapWallet): SapClient;
-    /**
-     * Create a {@link SapClient} from a raw {@link Keypair}.
-     *
-     * @param {Keypair} keypair — The signer keypair.
-     * @returns {SapClient} A fully-configured SAP client.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const client = conn.fromKeypair(Keypair.generate());
-     * ```
-     */
-    fromKeypair(keypair: Keypair): SapClient;
-    /**
-     * Request an airdrop (devnet / localnet only).
-     *
-     * @param {PublicKey} to — Recipient public key.
-     * @param {number} solAmount — Amount of SOL to airdrop.
-     * @returns {Promise<string>} The confirmed transaction signature.
-     * @throws {Error} If the airdrop request or confirmation fails (e.g. on mainnet).
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const sig = await conn.airdrop(wallet.publicKey, 2);
-     * ```
-     */
-    airdrop(to: PublicKey, solAmount: number): Promise<string>;
-    /**
-     * Get the SOL balance of an address in **lamports**.
-     *
-     * @param {PublicKey} address — The account to query.
-     * @returns {Promise<number>} Balance in lamports.
-     * @since v0.1.0
-     */
-    getBalance(address: PublicKey): Promise<number>;
-    /**
-     * Get the SOL balance of an address in **SOL** (human-readable).
-     *
-     * @param {PublicKey} address — The account to query.
-     * @returns {Promise<number>} Balance in SOL.
-     * @since v0.1.0
-     *
-     * @example
-     * ```ts
-     * const sol = await conn.getBalanceSol(wallet.publicKey);
-     * console.log(`Balance: ${sol} SOL`);
-     * ```
-     */
-    getBalanceSol(address: PublicKey): Promise<number>;
-    /**
-     * Infer the {@link SapCluster} from an RPC URL by inspecting
-     * well-known substrings (`devnet`, `localhost`, `:8899`).
-     *
-     * @static
-     * @param {string} rpcUrl — The RPC endpoint to inspect.
-     * @returns {SapCluster} The detected cluster, defaulting to `"mainnet-beta"`.
-     * @since v0.1.0
-     */
-    static detectCluster(rpcUrl: string): SapCluster;
-    /**
-     * Map a {@link SapCluster} to the canonical SAP on-chain program ID.
-     *
-     * @static
-     * @param {SapCluster} cluster — Target cluster.
-     * @returns {PublicKey} The program {@link PublicKey} for the given cluster.
-     * @since v0.1.0
-     * @see {@link SAP_PROGRAM_ID}
-     */
-    static programIdForCluster(cluster: SapCluster): PublicKey;
-}
-//# sourceMappingURL=connection.d.ts.map

package/dist/types/core/connection.d.ts.map

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

package/dist/types/core/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * @module core
- * @description Core infrastructure — client creation and RPC connection.
- *
- * @example
- * ```ts
- * import { SapClient, SapConnection } from "@synapse-sap/sdk";
- *
- * // From Anchor provider
- * const client = SapClient.from(provider);
- *
- * // From RPC URL + keypair (synapse-client-sdk compatible)
- * const conn = SapConnection.devnet();
- * const client2 = conn.fromKeypair(keypair);
- * ```
- */
-export { SapClient } from "./client";
-export { SapConnection, KeypairWallet } from "./connection";
-export type { SapCluster, SapConnectionConfig, SapWallet } from "./connection";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/core/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/errors/index.d.ts

@@ -1,335 +0,0 @@
-/**
- * @module errors
- * @description Typed error classes for the SAP v2 SDK.
- *
- * All SDK errors extend {@link SapError} to allow catch-all handling,
- * while concrete subclasses enable fine-grained error matching.
- *
- * @category Errors
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { SapError, SapRpcError, SapAccountNotFoundError } from "@synapse-sap/sdk/errors";
- *
- * try {
- *   const agent = await client.agent.fetch();
- * } catch (err) {
- *   if (err instanceof SapAccountNotFoundError) {
- *     console.log("Agent not registered yet");
- *   } else if (err instanceof SapRpcError) {
- *     console.error("RPC failure:", err.rpcCode);
- *   } else if (err instanceof SapError) {
- *     console.error("SAP error:", err.message);
- *   }
- * }
- * ```
- *
- * @see {@link SapError}
- * @see {@link SapValidationError}
- * @see {@link SapRpcError}
- * @see {@link SapAccountNotFoundError}
- * @see {@link SapTimeoutError}
- * @see {@link SapPermissionError}
- */
-/**
- * @name SapError
- * @description Base class for all SAP SDK errors.
- *
- * Extends `Error` and sets `name` automatically so `instanceof`
- * checks work correctly in both CJS and ESM environments.
- *
- * @category Errors
- * @since v0.1.0
- * @extends {Error}
- *
- * @example
- * ```ts
- * try {
- *   await client.agent.fetch();
- * } catch (err) {
- *   if (err instanceof SapError) {
- *     console.error(`[${err.code}] ${err.message}`);
- *   }
- * }
- * ```
- *
- * @see {@link SapValidationError}
- * @see {@link SapRpcError}
- * @see {@link SapAccountNotFoundError}
- * @see {@link SapTimeoutError}
- * @see {@link SapPermissionError}
- */
-export declare class SapError extends Error {
-    /**
-     * @description Machine-readable error code for programmatic handling.
-     * @readonly
-     */
-    readonly code: string;
-    /**
-     * @param message - A human-readable description of the error.
-     * @param code    - Machine-readable error code (defaults to `"SAP_ERROR"`).
-     */
-    constructor(message: string, code?: string);
-}
-/**
- * @name SapValidationError
- * @description Thrown when SDK-side input validation fails before sending a
- * transaction or making an RPC call.
- *
- * @category Errors
- * @since v0.1.0
- * @extends {SapError}
- *
- * @example
- * ```ts
- * try {
- *   await client.agent.register({ name: "" });
- * } catch (err) {
- *   if (err instanceof SapValidationError) {
- *     console.error(`Validation failed on field "${err.field}": ${err.message}`);
- *   }
- * }
- * ```
- *
- * @see {@link SapError}
- */
-export declare class SapValidationError extends SapError {
-    /**
-     * @description Field or parameter that failed validation (if applicable).
-     * @readonly
-     */
-    readonly field?: string;
-    /**
-     * @param message - A human-readable description of the validation failure.
-     * @param field   - The name of the field or parameter that failed validation.
-     */
-    constructor(message: string, field?: string);
-}
-/**
- * @name SapRpcError
- * @description Wraps Solana RPC or Anchor transaction errors with additional
- * context (error code, logs).
- *
- * @category Errors
- * @since v0.1.0
- * @extends {SapError}
- *
- * @example
- * ```ts
- * try {
- *   await client.agent.register(params);
- * } catch (err) {
- *   if (err instanceof SapRpcError) {
- *     console.error(`RPC error ${err.rpcCode}: ${err.message}`);
- *     err.logs?.forEach((log) => console.debug(log));
- *   }
- * }
- * ```
- *
- * @see {@link SapRpcError.fromAnchor}
- * @see {@link SapError}
- */
-export declare class SapRpcError extends SapError {
-    /**
-     * @description Anchor / program error code, if available.
-     * @readonly
-     */
-    readonly rpcCode?: number;
-    /**
-     * @description Transaction logs returned by the RPC node.
-     * @readonly
-     */
-    readonly logs?: readonly string[];
-    /**
-     * @param message - A human-readable description of the RPC or transaction error.
-     * @param opts    - Optional additional context.
-     * @param opts.rpcCode - Anchor or Solana program error code.
-     * @param opts.logs    - Raw transaction logs from the RPC node.
-     */
-    constructor(message: string, opts?: {
-        rpcCode?: number;
-        logs?: readonly string[];
-    });
-    /**
-     * @static
-     * @description Create a {@link SapRpcError} from an Anchor-style error object.
-     * Extracts `code` and `logs` automatically from the Anchor error shape.
-     *
-     * @param err - The raw Anchor or Solana error object.
-     * @returns A new {@link SapRpcError} populated with extracted code, logs, and message.
-     *
-     * @example
-     * ```ts
-     * try {
-     *   await program.methods.registerAgent(args).rpc();
-     * } catch (raw) {
-     *   throw SapRpcError.fromAnchor(raw);
-     * }
-     * ```
-     *
-     * @see {@link SapRpcError}
-     */
-    static fromAnchor(err: any): SapRpcError;
-}
-/**
- * @name SapAccountNotFoundError
- * @description Thrown when an expected on-chain account does not exist or has
- * been closed.
- *
- * @category Errors
- * @since v0.1.0
- * @extends {SapError}
- *
- * @example
- * ```ts
- * try {
- *   const agent = await client.agent.fetch(agentPda);
- * } catch (err) {
- *   if (err instanceof SapAccountNotFoundError) {
- *     console.warn(`Missing ${err.accountType ?? "account"}: ${err.address}`);
- *   }
- * }
- * ```
- *
- * @see {@link SapError}
- */
-export declare class SapAccountNotFoundError extends SapError {
-    /**
-     * @description The base-58 encoded account address that was not found.
-     * @readonly
-     */
-    readonly address: string;
-    /**
-     * @description The expected account type (e.g. `"AgentRecord"`, `"VaultAccount"`).
-     * @readonly
-     */
-    readonly accountType?: string;
-    /**
-     * @param address     - The base-58 encoded address of the missing account.
-     * @param accountType - Optional label for the expected account type.
-     */
-    constructor(address: string, accountType?: string);
-}
-/**
- * @name SapTimeoutError
- * @description Thrown when an operation (e.g., transaction confirmation) exceeds
- * the configured timeout.
- *
- * @category Errors
- * @since v0.1.0
- * @extends {SapError}
- *
- * @example
- * ```ts
- * try {
- *   await client.agent.register(params, { timeoutMs: 30_000 });
- * } catch (err) {
- *   if (err instanceof SapTimeoutError) {
- *     console.error(`Timed out after ${err.timeoutMs}ms: ${err.message}`);
- *   }
- * }
- * ```
- *
- * @see {@link SapError}
- */
-export declare class SapTimeoutError extends SapError {
-    /**
-     * @description Timeout duration in milliseconds that was exceeded.
-     * @readonly
-     */
-    readonly timeoutMs: number;
-    /**
-     * @param message   - A human-readable description of the timeout.
-     * @param timeoutMs - The timeout threshold in milliseconds.
-     */
-    constructor(message: string, timeoutMs: number);
-}
-/**
- * @name SapPermissionError
- * @description Thrown when the current wallet lacks the required permission
- * (authority, delegate, etc.) for an operation.
- *
- * @category Errors
- * @since v0.1.0
- * @extends {SapError}
- *
- * @example
- * ```ts
- * try {
- *   await client.agent.update(agentPda, updates);
- * } catch (err) {
- *   if (err instanceof SapPermissionError) {
- *     console.error(`Permission denied: ${err.message}`);
- *   }
- * }
- * ```
- *
- * @see {@link SapError}
- */
-export declare class SapPermissionError extends SapError {
-    /**
-     * @param message - A human-readable description of the permission failure.
-     */
-    constructor(message: string);
-}
-/**
- * @name SapTransientError
- * @description Wraps RPC failures that are *retryable* — network errors,
- * 429 rate limits, 5xx, blockhash-not-found, node-behind, fetch-failed.
- *
- * SDK fetch helpers (`safeFetch`) auto-retry these with exponential backoff
- * before re-throwing. Callers can also catch and retry at higher layers.
- *
- * @category Errors
- * @since v0.13.1
- * @extends {SapError}
- */
-export declare class SapTransientError extends SapError {
-    readonly attempt: number;
-    readonly cause?: unknown;
-    constructor(message: string, opts?: {
-        attempt?: number;
-        cause?: unknown;
-    });
-}
-/**
- * @name SapAlreadyExistsError
- * @description Thrown when an `init` instruction would collide with an
- * already-existing PDA. Detected by SDK preflight — prevents a wasted tx
- * and surfaces an idempotent success path to callers.
- *
- * @category Errors
- * @since v0.13.1
- * @extends {SapError}
- */
-export declare class SapAlreadyExistsError extends SapError {
-    readonly address: string;
-    readonly accountType?: string;
-    constructor(address: string, accountType?: string, hint?: string);
-}
-/**
- * @name SapIdempotencyError
- * @description Thrown by `safeRpc` when a transaction would replay an action
- * that has already been recorded on-chain (e.g. settlement-receipt PDA already
- * exists). Treat as a non-fatal idempotent success and drop the queued action.
- *
- * @category Errors
- * @since v0.13.1
- * @extends {SapError}
- */
-export declare class SapIdempotencyError extends SapError {
-    readonly receiptAddress?: string;
-    constructor(message: string, receiptAddress?: string);
-}
-/**
- * @name isTransientRpcError
- * @description Heuristic classifier for RPC errors. Returns `true` for
- * network failures, rate limits, 5xx, blockhash-not-found, node-behind,
- * fetch-failed, ECONNRESET, ETIMEDOUT, socket hang up.
- *
- * @category Errors
- * @since v0.13.1
- */
-export declare function isTransientRpcError(err: unknown): boolean;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/errors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,SAAc;CAOhD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAK5C;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE;IAQvD;;;;;;;;;;;;;;;;;;OAkBG;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;CAOzC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOlD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK/C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C;;OAEG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAM1E;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAQjE;AAED;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAKrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAsBzD"}