@bananapus/nana-sdk-core 1.7.0 → 1.9.0

package/dist/cjs/utils/bendystraw.d.ts

@@ -0,0 +1,105 @@
+export declare const BENDYSTRAW_TIMEOUT_MS = 15000;
+export declare const MAX_BENDYSTRAW_RESPONSE_BYTES: number;
+export declare const BENDYSTRAW_PROJECT_REF_BATCH_SIZE = 200;
+export declare const BENDYSTRAW_CACHE_TTL_MS: {
+    readonly live: 15000;
+    readonly standard: 30000;
+    readonly stable: 60000;
+};
+export type BendystrawFilter = Record<string, unknown>;
+export type BendystrawNetwork = "mainnet" | "testnet";
+export type BendystrawCachePolicy = keyof typeof BENDYSTRAW_CACHE_TTL_MS;
+export type BendystrawValidator<T> = (value: unknown) => value is T;
+export type BendystrawNetworkSelection = {
+    chainId?: number;
+    defaultNetwork?: BendystrawNetwork;
+    network?: BendystrawNetwork;
+    variables?: unknown;
+};
+export type BendystrawEndpoints = {
+    mainnet: string;
+    testnet: string;
+};
+export type BendystrawProjectRef = {
+    chainId: number;
+    projectId: number;
+    version?: number;
+};
+export type BendystrawProjectRow = {
+    chainId?: unknown;
+    projectId?: unknown;
+    version?: unknown;
+};
+export declare class BendystrawRequestError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export type BendystrawRequestOptions<TResult = unknown, TVariables extends object = Record<string, never>> = {
+    fetch?: typeof fetch;
+    maxResponseBytes?: number;
+    operationName?: string;
+    retryDelaysMs?: readonly number[];
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    validateData?: BendystrawValidator<TResult>;
+    validateVariables?: BendystrawValidator<TVariables>;
+};
+/**
+ * Resolve the Bendystraw network for an operation from every chain selector in
+ * its variables. Unknown chains, mixed networks, and explicit contradictions
+ * fail closed instead of silently querying the wrong index.
+ */
+export declare function resolveBendystrawNetwork(selection?: BendystrawNetworkSelection): BendystrawNetwork;
+/** Normalize a Bendystraw origin or endpoint to one canonical GraphQL URL. */
+export declare function normalizeBendystrawEndpoint(endpoint: string): string;
+/** Select and normalize the endpoint for the operation's resolved network. */
+export declare function selectBendystrawEndpoint(endpoints: BendystrawEndpoints, selection?: BendystrawNetworkSelection): string;
+export declare function isBendystrawRecord(value: unknown): value is Record<string, unknown>;
+/** Build a lightweight guard for the required root fields of an operation. */
+export declare function bendystrawDataHasFields<const TKey extends string>(...fields: readonly TKey[]): BendystrawValidator<Record<TKey, unknown>>;
+export declare function assertBendystrawData<T>(value: unknown, validator: BendystrawValidator<T>, operationName?: string): T;
+export declare function assertBendystrawVariables<T extends object>(value: unknown, validator: BendystrawValidator<T>, operationName?: string): T;
+/**
+ * Shared freshness vocabulary for clients. The transport does not cache.
+ *
+ * - `live`: balances, activity, and mutable project state.
+ * - `standard`: lists, search, and aggregate charts.
+ * - `stable`: metadata and historical records.
+ *
+ * Writes should invalidate affected reads. An indexer failure may fall back to
+ * an authoritative RPC read only when the fallback preserves the same scoped
+ * identity; failures must never be converted into zero or empty data.
+ */
+export declare function bendystrawCacheTtl(policy: BendystrawCachePolicy): number;
+/**
+ * Build an explicit conjunction for one versioned deployment. Keeping each
+ * identity field in its own `AND` member prevents accidental project/chain
+ * cross-products when multiple deployments are combined with `OR`.
+ */
+export declare function bendystrawProjectRefFilter(ref: BendystrawProjectRef): BendystrawFilter;
+/**
+ * Build an exact filter for one or more deployments. An empty list throws
+ * instead of silently producing a broad, unscoped indexer query.
+ */
+export declare function bendystrawProjectRefsFilter(refs: readonly BendystrawProjectRef[]): BendystrawFilter;
+/**
+ * Build independently queryable exact-deployment filters without handing an
+ * indexer one unbounded `OR`. Empty input produces no queries; malformed refs
+ * still fail closed.
+ */
+export declare function bendystrawProjectRefsFilters(refs: readonly BendystrawProjectRef[], batchSize?: number): BendystrawFilter[];
+/**
+ * Verify that an indexer row belongs to one of the requested deployments.
+ * Use this at the response boundary as defense in depth against stale schemas,
+ * permissive filters, and indexer regressions.
+ */
+export declare function matchesBendystrawProjectRef(row: BendystrawProjectRow, refs: readonly BendystrawProjectRef[]): boolean;
+/**
+ * Execute a bounded, timeout-protected Bendystraw GraphQL request.
+ *
+ * The helper retries only transient transport failures. GraphQL errors,
+ * invalid envelopes, invalid content types, oversized bodies, and caller
+ * cancellation fail closed without being retried.
+ */
+export declare function requestBendystraw<TResult, TVariables extends object = Record<string, never>>(endpoint: string, query: string, variables: TVariables, options?: BendystrawRequestOptions<TResult, TVariables>): Promise<TResult>;
+//# sourceMappingURL=bendystraw.d.ts.map

package/dist/cjs/utils/bendystraw.d.ts.map

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

package/dist/cjs/utils/bendystraw.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BendystrawRequestError = exports.BENDYSTRAW_CACHE_TTL_MS = exports.BENDYSTRAW_PROJECT_REF_BATCH_SIZE = exports.MAX_BENDYSTRAW_RESPONSE_BYTES = exports.BENDYSTRAW_TIMEOUT_MS = void 0;
+exports.resolveBendystrawNetwork = resolveBendystrawNetwork;
+exports.normalizeBendystrawEndpoint = normalizeBendystrawEndpoint;
+exports.selectBendystrawEndpoint = selectBendystrawEndpoint;
+exports.isBendystrawRecord = isBendystrawRecord;
+exports.bendystrawDataHasFields = bendystrawDataHasFields;
+exports.assertBendystrawData = assertBendystrawData;
+exports.assertBendystrawVariables = assertBendystrawVariables;
+exports.bendystrawCacheTtl = bendystrawCacheTtl;
+exports.bendystrawProjectRefFilter = bendystrawProjectRefFilter;
+exports.bendystrawProjectRefsFilter = bendystrawProjectRefsFilter;
+exports.bendystrawProjectRefsFilters = bendystrawProjectRefsFilters;
+exports.matchesBendystrawProjectRef = matchesBendystrawProjectRef;
+exports.requestBendystraw = requestBendystraw;
+const constants_js_1 = require("../constants.js");
+exports.BENDYSTRAW_TIMEOUT_MS = 15_000;
+exports.MAX_BENDYSTRAW_RESPONSE_BYTES = 5 * 1024 * 1024;
+exports.BENDYSTRAW_PROJECT_REF_BATCH_SIZE = 200;
+exports.BENDYSTRAW_CACHE_TTL_MS = {
+    live: 15_000,
+    standard: 30_000,
+    stable: 60_000,
+};
+const RETRY_DELAYS_MS = [250, 750];
+const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+class BendystrawRequestError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "BendystrawRequestError";
+    }
+}
+exports.BendystrawRequestError = BendystrawRequestError;
+function collectBendystrawChainIds(value, chainIds, depth = 0) {
+    if (value === null || typeof value !== "object")
+        return;
+    if (depth > 12) {
+        throw new TypeError("Bendystraw variables exceed the nesting limit");
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectBendystrawChainIds(item, chainIds, depth + 1);
+        }
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (key === "chainId" || key === "chainId_in") {
+            const candidates = Array.isArray(item) ? item : [item];
+            for (const candidate of candidates) {
+                const chainId = typeof candidate === "string" && candidate.trim()
+                    ? Number(candidate)
+                    : candidate;
+                if (!Number.isSafeInteger(chainId) || Number(chainId) <= 0) {
+                    throw new TypeError(`Invalid Bendystraw ${key}`);
+                }
+                chainIds.add(Number(chainId));
+            }
+        }
+        else {
+            collectBendystrawChainIds(item, chainIds, depth + 1);
+        }
+    }
+}
+function networkForChainId(chainId) {
+    const metadata = constants_js_1.JB_CHAINS[chainId];
+    if (!metadata) {
+        throw new TypeError(`Unsupported Bendystraw chain ID: ${chainId}`);
+    }
+    return metadata.chain.testnet ? "testnet" : "mainnet";
+}
+/**
+ * Resolve the Bendystraw network for an operation from every chain selector in
+ * its variables. Unknown chains, mixed networks, and explicit contradictions
+ * fail closed instead of silently querying the wrong index.
+ */
+function resolveBendystrawNetwork(selection = {}) {
+    const chainIds = new Set();
+    if (selection.chainId !== undefined) {
+        if (!Number.isSafeInteger(selection.chainId) || selection.chainId <= 0) {
+            throw new TypeError("Invalid Bendystraw chainId");
+        }
+        chainIds.add(selection.chainId);
+    }
+    collectBendystrawChainIds(selection.variables, chainIds);
+    const inferred = new Set([...chainIds].map((chainId) => networkForChainId(chainId)));
+    if (inferred.size > 1) {
+        throw new TypeError("A Bendystraw request cannot mix mainnet and testnet chains");
+    }
+    const inferredNetwork = [...inferred][0];
+    if (selection.network &&
+        inferredNetwork &&
+        selection.network !== inferredNetwork) {
+        throw new TypeError(`Bendystraw network ${selection.network} conflicts with ${inferredNetwork} chain variables`);
+    }
+    return (selection.network ??
+        inferredNetwork ??
+        selection.defaultNetwork ??
+        "mainnet");
+}
+/** Normalize a Bendystraw origin or endpoint to one canonical GraphQL URL. */
+function normalizeBendystrawEndpoint(endpoint) {
+    const url = new URL(endpoint);
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+        throw new TypeError("Bendystraw endpoint must use HTTP or HTTPS");
+    }
+    url.pathname = `${url.pathname
+        .replace(/\/graphql\/?$/u, "")
+        .replace(/\/$/u, "")}/graphql`;
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+}
+/** Select and normalize the endpoint for the operation's resolved network. */
+function selectBendystrawEndpoint(endpoints, selection = {}) {
+    return normalizeBendystrawEndpoint(endpoints[resolveBendystrawNetwork(selection)]);
+}
+function isBendystrawRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Build a lightweight guard for the required root fields of an operation. */
+function bendystrawDataHasFields(...fields) {
+    return (value) => isBendystrawRecord(value) &&
+        fields.every((field) => Object.prototype.hasOwnProperty.call(value, field));
+}
+function assertBendystrawData(value, validator, operationName = "Bendystraw operation") {
+    if (!validator(value)) {
+        throw new BendystrawRequestError(`${operationName} returned invalid data`, 502);
+    }
+    return value;
+}
+function assertBendystrawVariables(value, validator, operationName = "Bendystraw operation") {
+    if (!validator(value)) {
+        throw new BendystrawRequestError(`${operationName} received invalid variables`, 400);
+    }
+    return value;
+}
+/**
+ * Shared freshness vocabulary for clients. The transport does not cache.
+ *
+ * - `live`: balances, activity, and mutable project state.
+ * - `standard`: lists, search, and aggregate charts.
+ * - `stable`: metadata and historical records.
+ *
+ * Writes should invalidate affected reads. An indexer failure may fall back to
+ * an authoritative RPC read only when the fallback preserves the same scoped
+ * identity; failures must never be converted into zero or empty data.
+ */
+function bendystrawCacheTtl(policy) {
+    return exports.BENDYSTRAW_CACHE_TTL_MS[policy];
+}
+function normalizeProjectRef(ref) {
+    const version = ref.version ?? 6;
+    if (!Number.isSafeInteger(ref.chainId) ||
+        ref.chainId <= 0 ||
+        !Number.isSafeInteger(ref.projectId) ||
+        ref.projectId <= 0 ||
+        !Number.isSafeInteger(version) ||
+        version <= 0) {
+        throw new TypeError("Invalid Bendystraw project reference");
+    }
+    return { chainId: ref.chainId, projectId: ref.projectId, version };
+}
+/**
+ * Build an explicit conjunction for one versioned deployment. Keeping each
+ * identity field in its own `AND` member prevents accidental project/chain
+ * cross-products when multiple deployments are combined with `OR`.
+ */
+function bendystrawProjectRefFilter(ref) {
+    const normalized = normalizeProjectRef(ref);
+    return {
+        AND: [
+            { chainId: normalized.chainId },
+            { projectId: normalized.projectId },
+            { version: normalized.version },
+        ],
+    };
+}
+/**
+ * Build an exact filter for one or more deployments. An empty list throws
+ * instead of silently producing a broad, unscoped indexer query.
+ */
+function bendystrawProjectRefsFilter(refs) {
+    const unique = new Map();
+    for (const ref of refs) {
+        const normalized = normalizeProjectRef(ref);
+        unique.set(`${normalized.chainId}:${normalized.projectId}:${normalized.version}`, normalized);
+    }
+    const filters = [...unique.values()].map(bendystrawProjectRefFilter);
+    if (filters.length === 0) {
+        throw new TypeError("At least one Bendystraw project reference is required");
+    }
+    return filters.length === 1 ? filters[0] : { OR: filters };
+}
+/**
+ * Build independently queryable exact-deployment filters without handing an
+ * indexer one unbounded `OR`. Empty input produces no queries; malformed refs
+ * still fail closed.
+ */
+function bendystrawProjectRefsFilters(refs, batchSize = exports.BENDYSTRAW_PROJECT_REF_BATCH_SIZE) {
+    if (!Number.isSafeInteger(batchSize) || batchSize <= 0) {
+        throw new TypeError("batchSize must be a positive safe integer");
+    }
+    const unique = new Map();
+    for (const ref of refs) {
+        const normalized = normalizeProjectRef(ref);
+        unique.set(`${normalized.chainId}:${normalized.projectId}:${normalized.version}`, normalized);
+    }
+    const normalized = [...unique.values()];
+    const batches = [];
+    for (let index = 0; index < normalized.length; index += batchSize) {
+        batches.push({
+            OR: normalized
+                .slice(index, index + batchSize)
+                .map(bendystrawProjectRefFilter),
+        });
+    }
+    return batches;
+}
+/**
+ * Verify that an indexer row belongs to one of the requested deployments.
+ * Use this at the response boundary as defense in depth against stale schemas,
+ * permissive filters, and indexer regressions.
+ */
+function matchesBendystrawProjectRef(row, refs) {
+    const chainId = Number(row.chainId);
+    const projectId = Number(row.projectId);
+    const version = Number(row.version);
+    if (!Number.isSafeInteger(chainId) ||
+        !Number.isSafeInteger(projectId) ||
+        !Number.isSafeInteger(version)) {
+        return false;
+    }
+    return refs.some((ref) => {
+        const normalized = normalizeProjectRef(ref);
+        return (chainId === normalized.chainId &&
+            projectId === normalized.projectId &&
+            version === normalized.version);
+    });
+}
+async function readBoundedBody(response, maxResponseBytes) {
+    const declaredSize = Number(response.headers.get("content-length") ?? 0);
+    if (Number.isFinite(declaredSize) && declaredSize > maxResponseBytes) {
+        await response.body?.cancel();
+        throw new BendystrawRequestError("Bendystraw response exceeds the size limit", 502);
+    }
+    if (!response.headers.get("content-type")?.toLowerCase().includes("json")) {
+        await response.body?.cancel();
+        throw new BendystrawRequestError("Bendystraw returned an invalid content type", 502);
+    }
+    if (!response.body)
+        return new Uint8Array();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (total > maxResponseBytes) {
+                await reader.cancel("Bendystraw response exceeds the size limit");
+                throw new BendystrawRequestError("Bendystraw response exceeds the size limit", 502);
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const body = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+function abortName(error) {
+    return error instanceof Error ? error.name : undefined;
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+/**
+ * Execute a bounded, timeout-protected Bendystraw GraphQL request.
+ *
+ * The helper retries only transient transport failures. GraphQL errors,
+ * invalid envelopes, invalid content types, oversized bodies, and caller
+ * cancellation fail closed without being retried.
+ */
+async function requestBendystraw(endpoint, query, variables, options = {}) {
+    const fetchImpl = options.fetch ?? fetch;
+    const maxResponseBytes = options.maxResponseBytes ?? exports.MAX_BENDYSTRAW_RESPONSE_BYTES;
+    const retryDelaysMs = options.retryDelaysMs ?? RETRY_DELAYS_MS;
+    const timeoutMs = options.timeoutMs ?? exports.BENDYSTRAW_TIMEOUT_MS;
+    if (!Number.isSafeInteger(maxResponseBytes) || maxResponseBytes <= 0) {
+        throw new TypeError("maxResponseBytes must be a positive safe integer");
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new TypeError("timeoutMs must be positive");
+    }
+    if (options.validateVariables) {
+        assertBendystrawVariables(variables, options.validateVariables, options.operationName);
+    }
+    for (let attempt = 0;; attempt += 1) {
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal?.reason);
+        options.signal?.addEventListener("abort", abort, { once: true });
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            if (options.signal?.aborted)
+                abort();
+            const response = await fetchImpl(endpoint, {
+                method: "POST",
+                headers: {
+                    Accept: "application/graphql-response+json, application/json",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    query,
+                    variables,
+                    ...(options.operationName
+                        ? { operationName: options.operationName }
+                        : {}),
+                }),
+                signal: controller.signal,
+            });
+            if (RETRYABLE_STATUSES.has(response.status) &&
+                attempt < retryDelaysMs.length) {
+                await response.body?.cancel();
+            }
+            else {
+                const bytes = await readBoundedBody(response, maxResponseBytes);
+                let envelope;
+                try {
+                    envelope = JSON.parse(new TextDecoder().decode(bytes));
+                }
+                catch {
+                    throw new BendystrawRequestError("Bendystraw returned invalid JSON", 502);
+                }
+                if (!response.ok) {
+                    throw new BendystrawRequestError(`Bendystraw request failed (${response.status})`, response.status);
+                }
+                const message = envelope.errors?.find((error) => typeof error?.message === "string")?.message;
+                if (envelope.errors?.length) {
+                    throw new BendystrawRequestError(typeof message === "string"
+                        ? message.slice(0, 500)
+                        : "Bendystraw query failed", 502);
+                }
+                if (!Object.prototype.hasOwnProperty.call(envelope, "data")) {
+                    throw new BendystrawRequestError("Bendystraw response is missing data", 502);
+                }
+                const data = envelope.data;
+                return options.validateData
+                    ? assertBendystrawData(data, options.validateData, options.operationName)
+                    : data;
+            }
+        }
+        catch (error) {
+            const aborted = options.signal?.aborted ||
+                abortName(error) === "AbortError" ||
+                abortName(error) === "TimeoutError";
+            if (aborted ||
+                error instanceof BendystrawRequestError ||
+                attempt >= retryDelaysMs.length) {
+                throw error;
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+            options.signal?.removeEventListener("abort", abort);
+        }
+        await delay(retryDelaysMs[attempt]);
+    }
+}
+//# sourceMappingURL=bendystraw.js.map

package/dist/cjs/utils/bendystraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bendystraw.js","sourceRoot":"","sources":["../../../src/utils/bendystraw.ts"],"names":[],"mappings":";;;AAkHA,4DAoCC;AAGD,kEAWC;AAGD,4DAOC;AAED,gDAIC;AAGD,0DAMC;AAED,oDAYC;AAED,8DAYC;AAaD,gDAEC;AAwBD,gEAWC;AAMD,kEAkBC;AAOD,oEA2BC;AAOD,kEAsBC;AAoED,8CA2HC;AAjiBD,kDAA4C;AAE/B,QAAA,qBAAqB,GAAG,MAAM,CAAC;AAC/B,QAAA,6BAA6B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,QAAA,iCAAiC,GAAG,GAAG,CAAC;AACxC,QAAA,uBAAuB,GAAG;IACrC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;CACN,CAAC;AAEX,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,CAAU,CAAC;AAC5C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AA+BnE,MAAa,sBAAuB,SAAQ,KAAK;IAC/C,YACE,OAAe,EACN,MAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAS;QAGxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AARD,wDAQC;AAgBD,SAAS,yBAAyB,CAChC,KAAc,EACd,QAAqB,EACrB,KAAK,GAAG,CAAC;IAET,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IACxD,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,OAAO,GACX,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE;oBAC/C,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;oBACnB,CAAC,CAAC,SAAS,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3D,MAAM,IAAI,SAAS,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;gBACnD,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,QAAQ,GAAG,wBAAS,CAAC,OAAiC,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CACtC,YAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,yBAAyB,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAC3D,CAAC;IACF,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CACjB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IACE,SAAS,CAAC,OAAO;QACjB,eAAe;QACf,SAAS,CAAC,OAAO,KAAK,eAAe,EACrC,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,sBAAsB,SAAS,CAAC,OAAO,mBAAmB,eAAe,kBAAkB,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,CACL,SAAS,CAAC,OAAO;QACjB,eAAe;QACf,SAAS,CAAC,cAAc;QACxB,SAAS,CACV,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAgB,2BAA2B,CAAC,QAAgB;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACpE,CAAC;IACD,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ;SAC3B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC;IACjC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,SAAgB,wBAAwB,CACtC,SAA8B,EAC9B,YAAwC,EAAE;IAE1C,OAAO,2BAA2B,CAChC,SAAS,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,KAAc;IAEd,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,8EAA8E;AAC9E,SAAgB,uBAAuB,CACrC,GAAG,MAAuB;IAE1B,OAAO,CAAC,KAAK,EAAkC,EAAE,CAC/C,kBAAkB,CAAC,KAAK,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAgB,oBAAoB,CAClC,KAAc,EACd,SAAiC,EACjC,aAAa,GAAG,sBAAsB;IAEtC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,aAAa,wBAAwB,EACxC,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,yBAAyB,CACvC,KAAc,EACd,SAAiC,EACjC,aAAa,GAAG,sBAAsB;IAEtC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,aAAa,6BAA6B,EAC7C,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAAC,MAA6B;IAC9D,OAAO,+BAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAyB;IAEzB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACjC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;QAClC,GAAG,CAAC,OAAO,IAAI,CAAC;QAChB,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;QACpC,GAAG,CAAC,SAAS,IAAI,CAAC;QAClB,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC,EACZ,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAgB,0BAA0B,CACxC,GAAyB;IAEzB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO;QACL,GAAG,EAAE;YACH,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE;YAC/B,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE;YACnC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE;SAChC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B,CACzC,IAAqC;IAErC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0C,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CACR,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,OAAO,EAAE,EACrE,UAAU,CACX,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CACjB,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAgB,4BAA4B,CAC1C,IAAqC,EACrC,SAAS,GAAG,yCAAiC;IAE7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0C,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CACR,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,OAAO,EAAE,EACrE,UAAU,CACX,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,UAAU;iBACX,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;iBAC/B,GAAG,CAAC,0BAA0B,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAgB,2BAA2B,CACzC,GAAyB,EACzB,IAAqC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;QAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAChC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,CACL,OAAO,KAAK,UAAU,CAAC,OAAO;YAC9B,SAAS,KAAK,UAAU,CAAC,SAAS;YAClC,OAAO,KAAK,UAAU,CAAC,OAAO,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAkB,EAClB,gBAAwB;IAExB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,gBAAgB,EAAE,CAAC;QACrE,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,sBAAsB,CAC9B,4CAA4C,EAC5C,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,sBAAsB,CAC9B,6CAA6C,EAC7C,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,OAAO,IAAI,UAAU,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1B,IAAI,KAAK,GAAG,gBAAgB,EAAE,CAAC;gBAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC;gBAClE,MAAM,IAAI,sBAAsB,CAC9B,4CAA4C,EAC5C,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAS,KAAK,CAAC,YAAoB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CAIrC,QAAgB,EAChB,KAAa,EACb,SAAqB,EACrB,UAAyD,EAAE;IAE3D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACzC,MAAM,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,IAAI,qCAA6B,CAAC;IAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,eAAe,CAAC;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,6BAAqB,CAAC;IAE7D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,yBAAyB,CACvB,SAAS,EACT,OAAO,CAAC,iBAAiB,EACzB,OAAO,CAAC,aAAa,CACtB,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,KAAK,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;gBACzC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,MAAM,EAAE,qDAAqD;oBAC7D,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK;oBACL,SAAS;oBACT,GAAG,CAAC,OAAO,CAAC,aAAa;wBACvB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;wBAC1C,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;gBACF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IACE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,OAAO,GAAG,aAAa,CAAC,MAAM,EAC9B,CAAC;gBACD,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBAChE,IAAI,QAGH,CAAC;gBACF,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CACnB,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CACb,CAAC;gBACvB,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,sBAAsB,CAC9B,kCAAkC,EAClC,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,sBAAsB,CAC9B,8BAA8B,QAAQ,CAAC,MAAM,GAAG,EAChD,QAAQ,CAAC,MAAM,CAChB,CAAC;gBACJ,CAAC;gBACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,CAC9C,EAAE,OAAO,CAAC;gBACX,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBAC5B,MAAM,IAAI,sBAAsB,CAC9B,OAAO,OAAO,KAAK,QAAQ;wBACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;wBACvB,CAAC,CAAC,yBAAyB,EAC7B,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;oBAC5D,MAAM,IAAI,sBAAsB,CAC9B,qCAAqC,EACrC,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAe,CAAC;gBACtC,OAAO,OAAO,CAAC,YAAY;oBACzB,CAAC,CAAC,oBAAoB,CAClB,IAAI,EACJ,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,aAAa,CACtB;oBACH,CAAC,CAAC,IAAI,CAAC;YACX,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,EAAE,OAAO;gBACvB,SAAS,CAAC,KAAK,CAAC,KAAK,YAAY;gBACjC,SAAS,CAAC,KAAK,CAAC,KAAK,cAAc,CAAC;YACtC,IACE,OAAO;gBACP,KAAK,YAAY,sBAAsB;gBACvC,OAAO,IAAI,aAAa,CAAC,MAAM,EAC/B,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/cjs/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./contracts.js";
+export * from "./bendystraw.js";
 export * from "./data.js";
 export * from "./debug.js";
 export * from "./deploy.js";

package/dist/cjs/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/cjs/utils/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./contracts.js"), exports);
+__exportStar(require("./bendystraw.js"), exports);
 __exportStar(require("./data.js"), exports);
 __exportStar(require("./debug.js"), exports);
 __exportStar(require("./deploy.js"), exports);

package/dist/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,kDAAgC;AAChC,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,kDAAgC;AAChC,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,kDAAgC;AAChC,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB"}

package/dist/esm/utils/bendystraw.d.ts

@@ -0,0 +1,105 @@
+export declare const BENDYSTRAW_TIMEOUT_MS = 15000;
+export declare const MAX_BENDYSTRAW_RESPONSE_BYTES: number;
+export declare const BENDYSTRAW_PROJECT_REF_BATCH_SIZE = 200;
+export declare const BENDYSTRAW_CACHE_TTL_MS: {
+    readonly live: 15000;
+    readonly standard: 30000;
+    readonly stable: 60000;
+};
+export type BendystrawFilter = Record<string, unknown>;
+export type BendystrawNetwork = "mainnet" | "testnet";
+export type BendystrawCachePolicy = keyof typeof BENDYSTRAW_CACHE_TTL_MS;
+export type BendystrawValidator<T> = (value: unknown) => value is T;
+export type BendystrawNetworkSelection = {
+    chainId?: number;
+    defaultNetwork?: BendystrawNetwork;
+    network?: BendystrawNetwork;
+    variables?: unknown;
+};
+export type BendystrawEndpoints = {
+    mainnet: string;
+    testnet: string;
+};
+export type BendystrawProjectRef = {
+    chainId: number;
+    projectId: number;
+    version?: number;
+};
+export type BendystrawProjectRow = {
+    chainId?: unknown;
+    projectId?: unknown;
+    version?: unknown;
+};
+export declare class BendystrawRequestError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export type BendystrawRequestOptions<TResult = unknown, TVariables extends object = Record<string, never>> = {
+    fetch?: typeof fetch;
+    maxResponseBytes?: number;
+    operationName?: string;
+    retryDelaysMs?: readonly number[];
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    validateData?: BendystrawValidator<TResult>;
+    validateVariables?: BendystrawValidator<TVariables>;
+};
+/**
+ * Resolve the Bendystraw network for an operation from every chain selector in
+ * its variables. Unknown chains, mixed networks, and explicit contradictions
+ * fail closed instead of silently querying the wrong index.
+ */
+export declare function resolveBendystrawNetwork(selection?: BendystrawNetworkSelection): BendystrawNetwork;
+/** Normalize a Bendystraw origin or endpoint to one canonical GraphQL URL. */
+export declare function normalizeBendystrawEndpoint(endpoint: string): string;
+/** Select and normalize the endpoint for the operation's resolved network. */
+export declare function selectBendystrawEndpoint(endpoints: BendystrawEndpoints, selection?: BendystrawNetworkSelection): string;
+export declare function isBendystrawRecord(value: unknown): value is Record<string, unknown>;
+/** Build a lightweight guard for the required root fields of an operation. */
+export declare function bendystrawDataHasFields<const TKey extends string>(...fields: readonly TKey[]): BendystrawValidator<Record<TKey, unknown>>;
+export declare function assertBendystrawData<T>(value: unknown, validator: BendystrawValidator<T>, operationName?: string): T;
+export declare function assertBendystrawVariables<T extends object>(value: unknown, validator: BendystrawValidator<T>, operationName?: string): T;
+/**
+ * Shared freshness vocabulary for clients. The transport does not cache.
+ *
+ * - `live`: balances, activity, and mutable project state.
+ * - `standard`: lists, search, and aggregate charts.
+ * - `stable`: metadata and historical records.
+ *
+ * Writes should invalidate affected reads. An indexer failure may fall back to
+ * an authoritative RPC read only when the fallback preserves the same scoped
+ * identity; failures must never be converted into zero or empty data.
+ */
+export declare function bendystrawCacheTtl(policy: BendystrawCachePolicy): number;
+/**
+ * Build an explicit conjunction for one versioned deployment. Keeping each
+ * identity field in its own `AND` member prevents accidental project/chain
+ * cross-products when multiple deployments are combined with `OR`.
+ */
+export declare function bendystrawProjectRefFilter(ref: BendystrawProjectRef): BendystrawFilter;
+/**
+ * Build an exact filter for one or more deployments. An empty list throws
+ * instead of silently producing a broad, unscoped indexer query.
+ */
+export declare function bendystrawProjectRefsFilter(refs: readonly BendystrawProjectRef[]): BendystrawFilter;
+/**
+ * Build independently queryable exact-deployment filters without handing an
+ * indexer one unbounded `OR`. Empty input produces no queries; malformed refs
+ * still fail closed.
+ */
+export declare function bendystrawProjectRefsFilters(refs: readonly BendystrawProjectRef[], batchSize?: number): BendystrawFilter[];
+/**
+ * Verify that an indexer row belongs to one of the requested deployments.
+ * Use this at the response boundary as defense in depth against stale schemas,
+ * permissive filters, and indexer regressions.
+ */
+export declare function matchesBendystrawProjectRef(row: BendystrawProjectRow, refs: readonly BendystrawProjectRef[]): boolean;
+/**
+ * Execute a bounded, timeout-protected Bendystraw GraphQL request.
+ *
+ * The helper retries only transient transport failures. GraphQL errors,
+ * invalid envelopes, invalid content types, oversized bodies, and caller
+ * cancellation fail closed without being retried.
+ */
+export declare function requestBendystraw<TResult, TVariables extends object = Record<string, never>>(endpoint: string, query: string, variables: TVariables, options?: BendystrawRequestOptions<TResult, TVariables>): Promise<TResult>;
+//# sourceMappingURL=bendystraw.d.ts.map

package/dist/esm/utils/bendystraw.d.ts.map

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

package/dist/esm/utils/bendystraw.js

@@ -0,0 +1,362 @@
+import { JB_CHAINS } from "../constants.js";
+export const BENDYSTRAW_TIMEOUT_MS = 15_000;
+export const MAX_BENDYSTRAW_RESPONSE_BYTES = 5 * 1024 * 1024;
+export const BENDYSTRAW_PROJECT_REF_BATCH_SIZE = 200;
+export const BENDYSTRAW_CACHE_TTL_MS = {
+    live: 15_000,
+    standard: 30_000,
+    stable: 60_000,
+};
+const RETRY_DELAYS_MS = [250, 750];
+const RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+export class BendystrawRequestError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "BendystrawRequestError";
+    }
+}
+function collectBendystrawChainIds(value, chainIds, depth = 0) {
+    if (value === null || typeof value !== "object")
+        return;
+    if (depth > 12) {
+        throw new TypeError("Bendystraw variables exceed the nesting limit");
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectBendystrawChainIds(item, chainIds, depth + 1);
+        }
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (key === "chainId" || key === "chainId_in") {
+            const candidates = Array.isArray(item) ? item : [item];
+            for (const candidate of candidates) {
+                const chainId = typeof candidate === "string" && candidate.trim()
+                    ? Number(candidate)
+                    : candidate;
+                if (!Number.isSafeInteger(chainId) || Number(chainId) <= 0) {
+                    throw new TypeError(`Invalid Bendystraw ${key}`);
+                }
+                chainIds.add(Number(chainId));
+            }
+        }
+        else {
+            collectBendystrawChainIds(item, chainIds, depth + 1);
+        }
+    }
+}
+function networkForChainId(chainId) {
+    const metadata = JB_CHAINS[chainId];
+    if (!metadata) {
+        throw new TypeError(`Unsupported Bendystraw chain ID: ${chainId}`);
+    }
+    return metadata.chain.testnet ? "testnet" : "mainnet";
+}
+/**
+ * Resolve the Bendystraw network for an operation from every chain selector in
+ * its variables. Unknown chains, mixed networks, and explicit contradictions
+ * fail closed instead of silently querying the wrong index.
+ */
+export function resolveBendystrawNetwork(selection = {}) {
+    const chainIds = new Set();
+    if (selection.chainId !== undefined) {
+        if (!Number.isSafeInteger(selection.chainId) || selection.chainId <= 0) {
+            throw new TypeError("Invalid Bendystraw chainId");
+        }
+        chainIds.add(selection.chainId);
+    }
+    collectBendystrawChainIds(selection.variables, chainIds);
+    const inferred = new Set([...chainIds].map((chainId) => networkForChainId(chainId)));
+    if (inferred.size > 1) {
+        throw new TypeError("A Bendystraw request cannot mix mainnet and testnet chains");
+    }
+    const inferredNetwork = [...inferred][0];
+    if (selection.network &&
+        inferredNetwork &&
+        selection.network !== inferredNetwork) {
+        throw new TypeError(`Bendystraw network ${selection.network} conflicts with ${inferredNetwork} chain variables`);
+    }
+    return (selection.network ??
+        inferredNetwork ??
+        selection.defaultNetwork ??
+        "mainnet");
+}
+/** Normalize a Bendystraw origin or endpoint to one canonical GraphQL URL. */
+export function normalizeBendystrawEndpoint(endpoint) {
+    const url = new URL(endpoint);
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+        throw new TypeError("Bendystraw endpoint must use HTTP or HTTPS");
+    }
+    url.pathname = `${url.pathname
+        .replace(/\/graphql\/?$/u, "")
+        .replace(/\/$/u, "")}/graphql`;
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+}
+/** Select and normalize the endpoint for the operation's resolved network. */
+export function selectBendystrawEndpoint(endpoints, selection = {}) {
+    return normalizeBendystrawEndpoint(endpoints[resolveBendystrawNetwork(selection)]);
+}
+export function isBendystrawRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Build a lightweight guard for the required root fields of an operation. */
+export function bendystrawDataHasFields(...fields) {
+    return (value) => isBendystrawRecord(value) &&
+        fields.every((field) => Object.prototype.hasOwnProperty.call(value, field));
+}
+export function assertBendystrawData(value, validator, operationName = "Bendystraw operation") {
+    if (!validator(value)) {
+        throw new BendystrawRequestError(`${operationName} returned invalid data`, 502);
+    }
+    return value;
+}
+export function assertBendystrawVariables(value, validator, operationName = "Bendystraw operation") {
+    if (!validator(value)) {
+        throw new BendystrawRequestError(`${operationName} received invalid variables`, 400);
+    }
+    return value;
+}
+/**
+ * Shared freshness vocabulary for clients. The transport does not cache.
+ *
+ * - `live`: balances, activity, and mutable project state.
+ * - `standard`: lists, search, and aggregate charts.
+ * - `stable`: metadata and historical records.
+ *
+ * Writes should invalidate affected reads. An indexer failure may fall back to
+ * an authoritative RPC read only when the fallback preserves the same scoped
+ * identity; failures must never be converted into zero or empty data.
+ */
+export function bendystrawCacheTtl(policy) {
+    return BENDYSTRAW_CACHE_TTL_MS[policy];
+}
+function normalizeProjectRef(ref) {
+    const version = ref.version ?? 6;
+    if (!Number.isSafeInteger(ref.chainId) ||
+        ref.chainId <= 0 ||
+        !Number.isSafeInteger(ref.projectId) ||
+        ref.projectId <= 0 ||
+        !Number.isSafeInteger(version) ||
+        version <= 0) {
+        throw new TypeError("Invalid Bendystraw project reference");
+    }
+    return { chainId: ref.chainId, projectId: ref.projectId, version };
+}
+/**
+ * Build an explicit conjunction for one versioned deployment. Keeping each
+ * identity field in its own `AND` member prevents accidental project/chain
+ * cross-products when multiple deployments are combined with `OR`.
+ */
+export function bendystrawProjectRefFilter(ref) {
+    const normalized = normalizeProjectRef(ref);
+    return {
+        AND: [
+            { chainId: normalized.chainId },
+            { projectId: normalized.projectId },
+            { version: normalized.version },
+        ],
+    };
+}
+/**
+ * Build an exact filter for one or more deployments. An empty list throws
+ * instead of silently producing a broad, unscoped indexer query.
+ */
+export function bendystrawProjectRefsFilter(refs) {
+    const unique = new Map();
+    for (const ref of refs) {
+        const normalized = normalizeProjectRef(ref);
+        unique.set(`${normalized.chainId}:${normalized.projectId}:${normalized.version}`, normalized);
+    }
+    const filters = [...unique.values()].map(bendystrawProjectRefFilter);
+    if (filters.length === 0) {
+        throw new TypeError("At least one Bendystraw project reference is required");
+    }
+    return filters.length === 1 ? filters[0] : { OR: filters };
+}
+/**
+ * Build independently queryable exact-deployment filters without handing an
+ * indexer one unbounded `OR`. Empty input produces no queries; malformed refs
+ * still fail closed.
+ */
+export function bendystrawProjectRefsFilters(refs, batchSize = BENDYSTRAW_PROJECT_REF_BATCH_SIZE) {
+    if (!Number.isSafeInteger(batchSize) || batchSize <= 0) {
+        throw new TypeError("batchSize must be a positive safe integer");
+    }
+    const unique = new Map();
+    for (const ref of refs) {
+        const normalized = normalizeProjectRef(ref);
+        unique.set(`${normalized.chainId}:${normalized.projectId}:${normalized.version}`, normalized);
+    }
+    const normalized = [...unique.values()];
+    const batches = [];
+    for (let index = 0; index < normalized.length; index += batchSize) {
+        batches.push({
+            OR: normalized
+                .slice(index, index + batchSize)
+                .map(bendystrawProjectRefFilter),
+        });
+    }
+    return batches;
+}
+/**
+ * Verify that an indexer row belongs to one of the requested deployments.
+ * Use this at the response boundary as defense in depth against stale schemas,
+ * permissive filters, and indexer regressions.
+ */
+export function matchesBendystrawProjectRef(row, refs) {
+    const chainId = Number(row.chainId);
+    const projectId = Number(row.projectId);
+    const version = Number(row.version);
+    if (!Number.isSafeInteger(chainId) ||
+        !Number.isSafeInteger(projectId) ||
+        !Number.isSafeInteger(version)) {
+        return false;
+    }
+    return refs.some((ref) => {
+        const normalized = normalizeProjectRef(ref);
+        return (chainId === normalized.chainId &&
+            projectId === normalized.projectId &&
+            version === normalized.version);
+    });
+}
+async function readBoundedBody(response, maxResponseBytes) {
+    const declaredSize = Number(response.headers.get("content-length") ?? 0);
+    if (Number.isFinite(declaredSize) && declaredSize > maxResponseBytes) {
+        await response.body?.cancel();
+        throw new BendystrawRequestError("Bendystraw response exceeds the size limit", 502);
+    }
+    if (!response.headers.get("content-type")?.toLowerCase().includes("json")) {
+        await response.body?.cancel();
+        throw new BendystrawRequestError("Bendystraw returned an invalid content type", 502);
+    }
+    if (!response.body)
+        return new Uint8Array();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (total > maxResponseBytes) {
+                await reader.cancel("Bendystraw response exceeds the size limit");
+                throw new BendystrawRequestError("Bendystraw response exceeds the size limit", 502);
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const body = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+function abortName(error) {
+    return error instanceof Error ? error.name : undefined;
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+/**
+ * Execute a bounded, timeout-protected Bendystraw GraphQL request.
+ *
+ * The helper retries only transient transport failures. GraphQL errors,
+ * invalid envelopes, invalid content types, oversized bodies, and caller
+ * cancellation fail closed without being retried.
+ */
+export async function requestBendystraw(endpoint, query, variables, options = {}) {
+    const fetchImpl = options.fetch ?? fetch;
+    const maxResponseBytes = options.maxResponseBytes ?? MAX_BENDYSTRAW_RESPONSE_BYTES;
+    const retryDelaysMs = options.retryDelaysMs ?? RETRY_DELAYS_MS;
+    const timeoutMs = options.timeoutMs ?? BENDYSTRAW_TIMEOUT_MS;
+    if (!Number.isSafeInteger(maxResponseBytes) || maxResponseBytes <= 0) {
+        throw new TypeError("maxResponseBytes must be a positive safe integer");
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new TypeError("timeoutMs must be positive");
+    }
+    if (options.validateVariables) {
+        assertBendystrawVariables(variables, options.validateVariables, options.operationName);
+    }
+    for (let attempt = 0;; attempt += 1) {
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal?.reason);
+        options.signal?.addEventListener("abort", abort, { once: true });
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            if (options.signal?.aborted)
+                abort();
+            const response = await fetchImpl(endpoint, {
+                method: "POST",
+                headers: {
+                    Accept: "application/graphql-response+json, application/json",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    query,
+                    variables,
+                    ...(options.operationName
+                        ? { operationName: options.operationName }
+                        : {}),
+                }),
+                signal: controller.signal,
+            });
+            if (RETRYABLE_STATUSES.has(response.status) &&
+                attempt < retryDelaysMs.length) {
+                await response.body?.cancel();
+            }
+            else {
+                const bytes = await readBoundedBody(response, maxResponseBytes);
+                let envelope;
+                try {
+                    envelope = JSON.parse(new TextDecoder().decode(bytes));
+                }
+                catch {
+                    throw new BendystrawRequestError("Bendystraw returned invalid JSON", 502);
+                }
+                if (!response.ok) {
+                    throw new BendystrawRequestError(`Bendystraw request failed (${response.status})`, response.status);
+                }
+                const message = envelope.errors?.find((error) => typeof error?.message === "string")?.message;
+                if (envelope.errors?.length) {
+                    throw new BendystrawRequestError(typeof message === "string"
+                        ? message.slice(0, 500)
+                        : "Bendystraw query failed", 502);
+                }
+                if (!Object.prototype.hasOwnProperty.call(envelope, "data")) {
+                    throw new BendystrawRequestError("Bendystraw response is missing data", 502);
+                }
+                const data = envelope.data;
+                return options.validateData
+                    ? assertBendystrawData(data, options.validateData, options.operationName)
+                    : data;
+            }
+        }
+        catch (error) {
+            const aborted = options.signal?.aborted ||
+                abortName(error) === "AbortError" ||
+                abortName(error) === "TimeoutError";
+            if (aborted ||
+                error instanceof BendystrawRequestError ||
+                attempt >= retryDelaysMs.length) {
+                throw error;
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+            options.signal?.removeEventListener("abort", abort);
+        }
+        await delay(retryDelaysMs[attempt]);
+    }
+}
+//# sourceMappingURL=bendystraw.js.map

package/dist/esm/utils/bendystraw.js.map

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

package/dist/esm/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./contracts.js";
+export * from "./bendystraw.js";
 export * from "./data.js";
 export * from "./debug.js";
 export * from "./deploy.js";

package/dist/esm/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/esm/utils/index.js

@@ -1,4 +1,5 @@
 export * from "./contracts.js";
+export * from "./bendystraw.js";
 export * from "./data.js";
 export * from "./debug.js";
 export * from "./deploy.js";

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bananapus/nana-sdk-core",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "type": "module",
   "repository": {
     "type": "git",