@opendatalabs/vana-sdk 2.3.0 → 3.0.0

package/dist/utils/subgraphConsistency.js

@@ -1,155 +0,0 @@
-import { print } from "graphql";
-import { GetSubgraphMetaDocument } from "../generated/subgraph";
-import { globalMetaCache } from "./subgraphMetaCache";
-class StaleDataError extends Error {
-  constructor(requiredBlock, currentBlock, message) {
-    super(
-      message ?? `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`
-    );
-    this.requiredBlock = requiredBlock;
-    this.currentBlock = currentBlock;
-    this.name = "StaleDataError";
-  }
-}
-async function fetchSubgraphMeta(subgraphUrl, useCache = true) {
-  if (useCache) {
-    const cached = globalMetaCache.get(subgraphUrl);
-    if (cached) {
-      return cached;
-    }
-  }
-  const response = await fetch(subgraphUrl, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      query: print(GetSubgraphMetaDocument)
-    })
-  });
-  if (!response.ok) {
-    throw new Error(
-      `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`
-    );
-  }
-  const result = await response.json();
-  if (result.errors) {
-    throw new Error(
-      `Subgraph query errors: ${result.errors.map((e) => e.message).join(", ")}`
-    );
-  }
-  if (!result.data?._meta) {
-    throw new Error("No metadata returned from subgraph");
-  }
-  const meta = result.data._meta;
-  const subgraphMeta = {
-    blockNumber: meta.block.number,
-    blockTimestamp: meta.block.timestamp ?? void 0,
-    blockHash: meta.block.hash ?? void 0,
-    deployment: meta.deployment,
-    hasIndexingErrors: meta.hasIndexingErrors
-  };
-  if (useCache) {
-    globalMetaCache.set(subgraphUrl, subgraphMeta);
-  }
-  return subgraphMeta;
-}
-async function checkSubgraphConsistency(subgraphUrl, options) {
-  if (options?.signal?.aborted) {
-    throw new Error("Operation aborted");
-  }
-  if (!options?.minBlock) {
-    return fetchSubgraphMeta(subgraphUrl);
-  }
-  const meta = await fetchSubgraphMeta(subgraphUrl);
-  if (meta.blockNumber < options.minBlock) {
-    if (options.waitForSync && options.waitForSync > 0) {
-      return waitForSubgraphSync(
-        subgraphUrl,
-        options.minBlock,
-        options.waitForSync,
-        2e3,
-        // pollInterval
-        options.signal
-      );
-    }
-    throw new StaleDataError(options.minBlock, meta.blockNumber);
-  }
-  return meta;
-}
-async function waitForSubgraphSync(subgraphUrl, targetBlock, maxWait, pollInterval = 2e3, signal) {
-  const startTime = Date.now();
-  if (signal?.aborted) {
-    throw new Error("Operation aborted");
-  }
-  const checkAbort = () => {
-    if (signal?.aborted) {
-      throw new Error("Operation aborted");
-    }
-  };
-  while (Date.now() - startTime < maxWait) {
-    checkAbort();
-    const meta = await fetchSubgraphMeta(subgraphUrl);
-    if (meta.blockNumber >= targetBlock) {
-      return meta;
-    }
-    await new Promise((resolve, reject) => {
-      const timer = setTimeout(resolve, pollInterval);
-      if (signal) {
-        const abortHandler = () => {
-          clearTimeout(timer);
-          reject(new Error("Operation aborted"));
-        };
-        if (signal.aborted) {
-          abortHandler();
-        } else {
-          signal.addEventListener("abort", abortHandler, { once: true });
-        }
-      }
-    });
-  }
-  checkAbort();
-  const finalMeta = await fetchSubgraphMeta(subgraphUrl);
-  if (finalMeta.blockNumber >= targetBlock) {
-    return finalMeta;
-  }
-  throw new StaleDataError(
-    targetBlock,
-    finalMeta.blockNumber,
-    `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`
-  );
-}
-function calculateStaleness(meta, currentTimestamp) {
-  if (!meta.blockTimestamp) {
-    return void 0;
-  }
-  return Math.max(0, currentTimestamp - meta.blockTimestamp);
-}
-function addMetaToQuery(baseQuery) {
-  if (baseQuery.includes("_meta")) {
-    return baseQuery;
-  }
-  const queryMatch = baseQuery.match(/query\s+\w+[^{]*\{/);
-  if (!queryMatch) {
-    return baseQuery;
-  }
-  const insertPoint = queryMatch.index + queryMatch[0].length;
-  return baseQuery.slice(0, insertPoint) + `
-  _meta {
-    block {
-      number
-      timestamp
-    }
-    hasIndexingErrors
-  }
-  ` + baseQuery.slice(insertPoint);
-}
-export {
-  StaleDataError,
-  addMetaToQuery,
-  calculateStaleness,
-  checkSubgraphConsistency,
-  fetchSubgraphMeta,
-  waitForSubgraphSync
-};
-//# sourceMappingURL=subgraphConsistency.js.map

package/dist/utils/subgraphConsistency.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/subgraphConsistency.ts"],"sourcesContent":["/**\n * @file Utilities for handling subgraph data consistency\n * @module vana-sdk/utils/subgraphConsistency\n */\n\nimport { print } from \"graphql\";\nimport type { ConsistencyOptions } from \"../types/options\";\nimport type { GetSubgraphMetaQuery } from \"../generated/subgraph\";\nimport { GetSubgraphMetaDocument } from \"../generated/subgraph\";\nimport { globalMetaCache } from \"./subgraphMetaCache\";\n\n/**\n * Error thrown when subgraph data is stale relative to consistency requirements\n */\nexport class StaleDataError extends Error {\n  constructor(\n    public readonly requiredBlock: number,\n    public readonly currentBlock: number,\n    message?: string,\n  ) {\n    super(\n      message ??\n        `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`,\n    );\n    this.name = \"StaleDataError\";\n  }\n}\n\n/**\n * Subgraph metadata response structure\n */\nexport interface SubgraphMeta {\n  blockNumber: number;\n  blockTimestamp?: number;\n  blockHash?: string;\n  deployment: string;\n  hasIndexingErrors: boolean;\n}\n\n/**\n * Response structure from subgraph queries\n */\ninterface SubgraphResponse<T> {\n  data?: T;\n  errors?: Array<{ message: string }>;\n}\n\n/**\n * Fetches the current metadata from a subgraph\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @returns Current block information and indexing status\n */\nexport async function fetchSubgraphMeta(\n  subgraphUrl: string,\n  useCache = true,\n): Promise<SubgraphMeta> {\n  // Check cache first\n  if (useCache) {\n    const cached = globalMetaCache.get(subgraphUrl);\n    if (cached) {\n      return cached;\n    }\n  }\n\n  const response = await fetch(subgraphUrl, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      query: print(GetSubgraphMetaDocument),\n    }),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`,\n    );\n  }\n\n  const result =\n    (await response.json()) as SubgraphResponse<GetSubgraphMetaQuery>;\n\n  if (result.errors) {\n    throw new Error(\n      `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n    );\n  }\n\n  if (!result.data?._meta) {\n    throw new Error(\"No metadata returned from subgraph\");\n  }\n\n  const meta = result.data._meta;\n  const subgraphMeta: SubgraphMeta = {\n    blockNumber: meta.block.number,\n    blockTimestamp: meta.block.timestamp ?? undefined,\n    blockHash: meta.block.hash ?? undefined,\n    deployment: meta.deployment,\n    hasIndexingErrors: meta.hasIndexingErrors,\n  };\n\n  // Cache the result\n  if (useCache) {\n    globalMetaCache.set(subgraphUrl, subgraphMeta);\n  }\n\n  return subgraphMeta;\n}\n\n/**\n * Checks if subgraph meets consistency requirements\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param options - Consistency requirements\n * @returns The subgraph metadata if requirements are met\n * @throws {StaleDataError} If subgraph is behind required block\n */\nexport async function checkSubgraphConsistency(\n  subgraphUrl: string,\n  options?: ConsistencyOptions,\n): Promise<SubgraphMeta> {\n  // Check if already aborted\n  if (options?.signal?.aborted) {\n    throw new Error(\"Operation aborted\");\n  }\n\n  // If no consistency requirements, just return current metadata\n  if (!options?.minBlock) {\n    return fetchSubgraphMeta(subgraphUrl);\n  }\n\n  const meta = await fetchSubgraphMeta(subgraphUrl);\n\n  // Check if subgraph has reached required block\n  if (meta.blockNumber < options.minBlock) {\n    // If waitForSync is specified, poll until caught up\n    if (options.waitForSync && options.waitForSync > 0) {\n      return waitForSubgraphSync(\n        subgraphUrl,\n        options.minBlock,\n        options.waitForSync,\n        2000, // pollInterval\n        options.signal,\n      );\n    }\n\n    // Otherwise throw immediately\n    throw new StaleDataError(options.minBlock, meta.blockNumber);\n  }\n\n  return meta;\n}\n\n/**\n * Waits for subgraph to sync to a specific block\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param targetBlock - Block number to wait for\n * @param maxWait - Maximum milliseconds to wait\n * @param pollInterval - How often to check (default: 2000ms)\n * @returns The subgraph metadata when target is reached\n * @throws {StaleDataError} If timeout is reached before sync\n */\nexport async function waitForSubgraphSync(\n  subgraphUrl: string,\n  targetBlock: number,\n  maxWait: number,\n  pollInterval = 2000,\n  signal?: AbortSignal,\n): Promise<SubgraphMeta> {\n  const startTime = Date.now();\n\n  // Check if already aborted\n  if (signal?.aborted) {\n    throw new Error(\"Operation aborted\");\n  }\n\n  // Set up abort handling\n  const checkAbort = () => {\n    if (signal?.aborted) {\n      throw new Error(\"Operation aborted\");\n    }\n  };\n\n  while (Date.now() - startTime < maxWait) {\n    checkAbort();\n    const meta = await fetchSubgraphMeta(subgraphUrl);\n\n    // Check if we've reached the target\n    if (meta.blockNumber >= targetBlock) {\n      return meta;\n    }\n\n    // Wait before next check with abort support\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(resolve, pollInterval);\n\n      if (signal) {\n        const abortHandler = () => {\n          clearTimeout(timer);\n          reject(new Error(\"Operation aborted\"));\n        };\n\n        if (signal.aborted) {\n          abortHandler();\n        } else {\n          signal.addEventListener(\"abort\", abortHandler, { once: true });\n        }\n      }\n    });\n  }\n\n  // Timeout reached, check one more time\n  checkAbort();\n  const finalMeta = await fetchSubgraphMeta(subgraphUrl);\n  if (finalMeta.blockNumber >= targetBlock) {\n    return finalMeta;\n  }\n\n  throw new StaleDataError(\n    targetBlock,\n    finalMeta.blockNumber,\n    `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`,\n  );\n}\n\n/**\n * Calculates staleness in seconds based on block timestamps\n *\n * @param meta - Subgraph metadata\n * @param currentTimestamp - Current chain timestamp\n * @returns Seconds behind the chain, or undefined if timestamps unavailable\n */\nexport function calculateStaleness(\n  meta: SubgraphMeta,\n  currentTimestamp: number,\n): number | undefined {\n  if (!meta.blockTimestamp) {\n    return undefined;\n  }\n\n  return Math.max(0, currentTimestamp - meta.blockTimestamp);\n}\n\n/**\n * Builds a GraphQL query with _meta field included\n *\n * @param baseQuery - The original query string\n * @returns Query with _meta field added\n */\nexport function addMetaToQuery(baseQuery: string): string {\n  // Simple approach: inject _meta at the root level\n  // This is a basic implementation - could be enhanced with proper AST manipulation\n  if (baseQuery.includes(\"_meta\")) {\n    return baseQuery; // Already has meta\n  }\n\n  // Find the first { after query name and inject _meta\n  const queryMatch = baseQuery.match(/query\\s+\\w+[^{]*\\{/);\n  if (!queryMatch) {\n    return baseQuery; // Can't parse, return as-is\n  }\n\n  const insertPoint = queryMatch.index! + queryMatch[0].length;\n  return (\n    baseQuery.slice(0, insertPoint) +\n    `\n  _meta {\n    block {\n      number\n      timestamp\n    }\n    hasIndexingErrors\n  }\n  ` +\n    baseQuery.slice(insertPoint)\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/utils/subgraphMetaCache.cjs

@@ -1,101 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var subgraphMetaCache_exports = {};
-__export(subgraphMetaCache_exports, {
-  SubgraphMetaCache: () => SubgraphMetaCache,
-  globalMetaCache: () => globalMetaCache
-});
-module.exports = __toCommonJS(subgraphMetaCache_exports);
-class SubgraphMetaCache {
-  cache = /* @__PURE__ */ new Map();
-  maxSize;
-  ttl;
-  /**
-   * Create a new metadata cache
-   *
-   * @param ttl - Time to live in milliseconds (default: 2000ms)
-   * @param maxSize - Maximum cache entries (default: 10)
-   */
-  constructor(ttl = 2e3, maxSize = 10) {
-    this.ttl = ttl;
-    this.maxSize = maxSize;
-  }
-  /**
-   * Get cached metadata if fresh
-   *
-   * @param url - Subgraph URL as cache key
-   * @returns Cached metadata or undefined if stale/missing
-   */
-  get(url) {
-    const entry = this.cache.get(url);
-    if (!entry) {
-      return void 0;
-    }
-    if (Date.now() - entry.timestamp > this.ttl) {
-      this.cache.delete(url);
-      return void 0;
-    }
-    this.cache.delete(url);
-    this.cache.set(url, entry);
-    return entry.meta;
-  }
-  /**
-   * Store metadata in cache
-   *
-   * @param url - Subgraph URL as cache key
-   * @param meta - Metadata to cache
-   */
-  set(url, meta) {
-    if (this.cache.size >= this.maxSize && !this.cache.has(url)) {
-      const firstKey = this.cache.keys().next().value;
-      if (firstKey) {
-        this.cache.delete(firstKey);
-      }
-    }
-    this.cache.set(url, {
-      meta,
-      timestamp: Date.now()
-    });
-  }
-  /**
-   * Clear all cached entries
-   */
-  clear() {
-    this.cache.clear();
-  }
-  /**
-   * Get cache statistics
-   *
-   * @returns Cache size and TTL info
-   */
-  stats() {
-    return {
-      size: this.cache.size,
-      ttl: this.ttl,
-      maxSize: this.maxSize
-    };
-  }
-}
-const globalMetaCache = new SubgraphMetaCache();
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  SubgraphMetaCache,
-  globalMetaCache
-});
-//# sourceMappingURL=subgraphMetaCache.cjs.map

package/dist/utils/subgraphMetaCache.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/subgraphMetaCache.ts"],"sourcesContent":["/**\n * @file Simple cache for subgraph metadata to reduce redundant queries\n * @module vana-sdk/utils/subgraphMetaCache\n */\n\nimport type { SubgraphMeta } from \"./subgraphConsistency\";\n\ninterface CacheEntry {\n  meta: SubgraphMeta;\n  timestamp: number;\n}\n\n/**\n * Simple LRU cache for subgraph metadata\n *\n * @remarks\n * Reduces redundant _meta queries when multiple SDK methods are called\n * in quick succession. Uses a very short TTL to avoid masking staleness.\n */\nexport class SubgraphMetaCache {\n  private cache = new Map<string, CacheEntry>();\n  private readonly maxSize: number;\n  private readonly ttl: number;\n\n  /**\n   * Create a new metadata cache\n   *\n   * @param ttl - Time to live in milliseconds (default: 2000ms)\n   * @param maxSize - Maximum cache entries (default: 10)\n   */\n  constructor(ttl = 2000, maxSize = 10) {\n    this.ttl = ttl;\n    this.maxSize = maxSize;\n  }\n\n  /**\n   * Get cached metadata if fresh\n   *\n   * @param url - Subgraph URL as cache key\n   * @returns Cached metadata or undefined if stale/missing\n   */\n  get(url: string): SubgraphMeta | undefined {\n    const entry = this.cache.get(url);\n\n    if (!entry) {\n      return undefined;\n    }\n\n    // Check if still fresh\n    if (Date.now() - entry.timestamp > this.ttl) {\n      // Expired, remove it\n      this.cache.delete(url);\n      return undefined;\n    }\n\n    // Move to end (LRU)\n    this.cache.delete(url);\n    this.cache.set(url, entry);\n\n    return entry.meta;\n  }\n\n  /**\n   * Store metadata in cache\n   *\n   * @param url - Subgraph URL as cache key\n   * @param meta - Metadata to cache\n   */\n  set(url: string, meta: SubgraphMeta): void {\n    // Remove oldest if at capacity\n    if (this.cache.size >= this.maxSize && !this.cache.has(url)) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey) {\n        this.cache.delete(firstKey);\n      }\n    }\n\n    this.cache.set(url, {\n      meta,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Clear all cached entries\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics\n   *\n   * @returns Cache size and TTL info\n   */\n  stats(): { size: number; ttl: number; maxSize: number } {\n    return {\n      size: this.cache.size,\n      ttl: this.ttl,\n      maxSize: this.maxSize,\n    };\n  }\n}\n\n/**\n * Global cache instance (optional, can be configured per SDK instance)\n */\nexport const globalMetaCache = new SubgraphMetaCache();\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBO,MAAM,kBAAkB;AAAA,EACrB,QAAQ,oBAAI,IAAwB;AAAA,EAC3B;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjB,YAAY,MAAM,KAAM,UAAU,IAAI;AACpC,SAAK,MAAM;AACX,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAuC;AACzC,UAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;AAEhC,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,IAAI,IAAI,MAAM,YAAY,KAAK,KAAK;AAE3C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAGA,SAAK,MAAM,OAAO,GAAG;AACrB,SAAK,MAAM,IAAI,KAAK,KAAK;AAEzB,WAAO,MAAM;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAa,MAA0B;AAEzC,QAAI,KAAK,MAAM,QAAQ,KAAK,WAAW,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AAC3D,YAAM,WAAW,KAAK,MAAM,KAAK,EAAE,KAAK,EAAE;AAC1C,UAAI,UAAU;AACZ,aAAK,MAAM,OAAO,QAAQ;AAAA,MAC5B;AAAA,IACF;AAEA,SAAK,MAAM,IAAI,KAAK;AAAA,MAClB;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAwD;AACtD,WAAO;AAAA,MACL,MAAM,KAAK,MAAM;AAAA,MACjB,KAAK,KAAK;AAAA,MACV,SAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAKO,MAAM,kBAAkB,IAAI,kBAAkB;","names":[]}

package/dist/utils/subgraphMetaCache.d.ts

@@ -1,56 +0,0 @@
-/**
- * @file Simple cache for subgraph metadata to reduce redundant queries
- * @module vana-sdk/utils/subgraphMetaCache
- */
-import type { SubgraphMeta } from "./subgraphConsistency";
-/**
- * Simple LRU cache for subgraph metadata
- *
- * @remarks
- * Reduces redundant _meta queries when multiple SDK methods are called
- * in quick succession. Uses a very short TTL to avoid masking staleness.
- */
-export declare class SubgraphMetaCache {
-    private cache;
-    private readonly maxSize;
-    private readonly ttl;
-    /**
-     * Create a new metadata cache
-     *
-     * @param ttl - Time to live in milliseconds (default: 2000ms)
-     * @param maxSize - Maximum cache entries (default: 10)
-     */
-    constructor(ttl?: number, maxSize?: number);
-    /**
-     * Get cached metadata if fresh
-     *
-     * @param url - Subgraph URL as cache key
-     * @returns Cached metadata or undefined if stale/missing
-     */
-    get(url: string): SubgraphMeta | undefined;
-    /**
-     * Store metadata in cache
-     *
-     * @param url - Subgraph URL as cache key
-     * @param meta - Metadata to cache
-     */
-    set(url: string, meta: SubgraphMeta): void;
-    /**
-     * Clear all cached entries
-     */
-    clear(): void;
-    /**
-     * Get cache statistics
-     *
-     * @returns Cache size and TTL info
-     */
-    stats(): {
-        size: number;
-        ttl: number;
-        maxSize: number;
-    };
-}
-/**
- * Global cache instance (optional, can be configured per SDK instance)
- */
-export declare const globalMetaCache: SubgraphMetaCache;

package/dist/utils/subgraphMetaCache.js

@@ -1,76 +0,0 @@
-class SubgraphMetaCache {
-  cache = /* @__PURE__ */ new Map();
-  maxSize;
-  ttl;
-  /**
-   * Create a new metadata cache
-   *
-   * @param ttl - Time to live in milliseconds (default: 2000ms)
-   * @param maxSize - Maximum cache entries (default: 10)
-   */
-  constructor(ttl = 2e3, maxSize = 10) {
-    this.ttl = ttl;
-    this.maxSize = maxSize;
-  }
-  /**
-   * Get cached metadata if fresh
-   *
-   * @param url - Subgraph URL as cache key
-   * @returns Cached metadata or undefined if stale/missing
-   */
-  get(url) {
-    const entry = this.cache.get(url);
-    if (!entry) {
-      return void 0;
-    }
-    if (Date.now() - entry.timestamp > this.ttl) {
-      this.cache.delete(url);
-      return void 0;
-    }
-    this.cache.delete(url);
-    this.cache.set(url, entry);
-    return entry.meta;
-  }
-  /**
-   * Store metadata in cache
-   *
-   * @param url - Subgraph URL as cache key
-   * @param meta - Metadata to cache
-   */
-  set(url, meta) {
-    if (this.cache.size >= this.maxSize && !this.cache.has(url)) {
-      const firstKey = this.cache.keys().next().value;
-      if (firstKey) {
-        this.cache.delete(firstKey);
-      }
-    }
-    this.cache.set(url, {
-      meta,
-      timestamp: Date.now()
-    });
-  }
-  /**
-   * Clear all cached entries
-   */
-  clear() {
-    this.cache.clear();
-  }
-  /**
-   * Get cache statistics
-   *
-   * @returns Cache size and TTL info
-   */
-  stats() {
-    return {
-      size: this.cache.size,
-      ttl: this.ttl,
-      maxSize: this.maxSize
-    };
-  }
-}
-const globalMetaCache = new SubgraphMetaCache();
-export {
-  SubgraphMetaCache,
-  globalMetaCache
-};
-//# sourceMappingURL=subgraphMetaCache.js.map

package/dist/utils/subgraphMetaCache.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/subgraphMetaCache.ts"],"sourcesContent":["/**\n * @file Simple cache for subgraph metadata to reduce redundant queries\n * @module vana-sdk/utils/subgraphMetaCache\n */\n\nimport type { SubgraphMeta } from \"./subgraphConsistency\";\n\ninterface CacheEntry {\n  meta: SubgraphMeta;\n  timestamp: number;\n}\n\n/**\n * Simple LRU cache for subgraph metadata\n *\n * @remarks\n * Reduces redundant _meta queries when multiple SDK methods are called\n * in quick succession. Uses a very short TTL to avoid masking staleness.\n */\nexport class SubgraphMetaCache {\n  private cache = new Map<string, CacheEntry>();\n  private readonly maxSize: number;\n  private readonly ttl: number;\n\n  /**\n   * Create a new metadata cache\n   *\n   * @param ttl - Time to live in milliseconds (default: 2000ms)\n   * @param maxSize - Maximum cache entries (default: 10)\n   */\n  constructor(ttl = 2000, maxSize = 10) {\n    this.ttl = ttl;\n    this.maxSize = maxSize;\n  }\n\n  /**\n   * Get cached metadata if fresh\n   *\n   * @param url - Subgraph URL as cache key\n   * @returns Cached metadata or undefined if stale/missing\n   */\n  get(url: string): SubgraphMeta | undefined {\n    const entry = this.cache.get(url);\n\n    if (!entry) {\n      return undefined;\n    }\n\n    // Check if still fresh\n    if (Date.now() - entry.timestamp > this.ttl) {\n      // Expired, remove it\n      this.cache.delete(url);\n      return undefined;\n    }\n\n    // Move to end (LRU)\n    this.cache.delete(url);\n    this.cache.set(url, entry);\n\n    return entry.meta;\n  }\n\n  /**\n   * Store metadata in cache\n   *\n   * @param url - Subgraph URL as cache key\n   * @param meta - Metadata to cache\n   */\n  set(url: string, meta: SubgraphMeta): void {\n    // Remove oldest if at capacity\n    if (this.cache.size >= this.maxSize && !this.cache.has(url)) {\n      const firstKey = this.cache.keys().next().value;\n      if (firstKey) {\n        this.cache.delete(firstKey);\n      }\n    }\n\n    this.cache.set(url, {\n      meta,\n      timestamp: Date.now(),\n    });\n  }\n\n  /**\n   * Clear all cached entries\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics\n   *\n   * @returns Cache size and TTL info\n   */\n  stats(): { size: number; ttl: number; maxSize: number } {\n    return {\n      size: this.cache.size,\n      ttl: this.ttl,\n      maxSize: this.maxSize,\n    };\n  }\n}\n\n/**\n * Global cache instance (optional, can be configured per SDK instance)\n */\nexport const globalMetaCache = new SubgraphMetaCache();\n"],"mappings":"AAmBO,MAAM,kBAAkB;AAAA,EACrB,QAAQ,oBAAI,IAAwB;AAAA,EAC3B;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjB,YAAY,MAAM,KAAM,UAAU,IAAI;AACpC,SAAK,MAAM;AACX,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAuC;AACzC,UAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;AAEhC,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,IAAI,IAAI,MAAM,YAAY,KAAK,KAAK;AAE3C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAGA,SAAK,MAAM,OAAO,GAAG;AACrB,SAAK,MAAM,IAAI,KAAK,KAAK;AAEzB,WAAO,MAAM;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAa,MAA0B;AAEzC,QAAI,KAAK,MAAM,QAAQ,KAAK,WAAW,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AAC3D,YAAM,WAAW,KAAK,MAAM,KAAK,EAAE,KAAK,EAAE;AAC1C,UAAI,UAAU;AACZ,aAAK,MAAM,OAAO,QAAQ;AAAA,MAC5B;AAAA,IACF;AAEA,SAAK,MAAM,IAAI,KAAK;AAAA,MAClB;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAwD;AACtD,WAAO;AAAA,MACL,MAAM,KAAK,MAAM;AAAA,MACjB,KAAK,KAAK;AAAA,MACV,SAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAKO,MAAM,kBAAkB,IAAI,kBAAkB;","names":[]}

package/dist/utils/subgraphPagination.cjs

@@ -1,104 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var subgraphPagination_exports = {};
-__export(subgraphPagination_exports, {
-  executePaginatedQuery: () => executePaginatedQuery,
-  mapOrderByToEnum: () => mapOrderByToEnum,
-  mapOrderDirection: () => mapOrderDirection
-});
-module.exports = __toCommonJS(subgraphPagination_exports);
-var import_graphql = require("graphql");
-async function executePaginatedQuery(config) {
-  const {
-    endpoint,
-    document,
-    baseVariables,
-    options,
-    extractItems,
-    transformItem,
-    maxPerQuery = 1e3
-  } = config;
-  const limit = options?.fetchAll ? Number.MAX_SAFE_INTEGER : options?.limit ?? 100;
-  const offset = options?.offset ?? 0;
-  const orderBy = options?.orderBy;
-  const orderDirection = options?.orderDirection;
-  const allItems = [];
-  let currentOffset = offset;
-  const pageSize = Math.min(limit, maxPerQuery);
-  while (true) {
-    const currentLimit = options?.fetchAll ? pageSize : Math.min(pageSize, limit - allItems.length);
-    const variables = {
-      ...baseVariables,
-      first: currentLimit,
-      skip: currentOffset,
-      ...orderBy && { orderBy },
-      ...orderDirection && { orderDirection }
-    };
-    const response = await fetch(endpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        query: (0, import_graphql.print)(document),
-        variables
-      })
-    });
-    if (!response.ok) {
-      throw new Error(
-        `Subgraph request failed: ${response.status} ${response.statusText}`
-      );
-    }
-    const result = await response.json();
-    if (result.errors) {
-      throw new Error(
-        `Subgraph errors: ${result.errors.map((e) => e.message).join(", ")}`
-      );
-    }
-    const items = extractItems(result.data);
-    if (!items || items.length === 0) {
-      break;
-    }
-    const transformedItems = transformItem ? items.map(transformItem) : items;
-    allItems.push(...transformedItems);
-    if (!options?.fetchAll && allItems.length >= limit) {
-      return allItems.slice(0, limit);
-    }
-    if (items.length < currentLimit) {
-      break;
-    }
-    currentOffset += items.length;
-  }
-  return allItems;
-}
-function mapOrderByToEnum(orderBy, enumMap, defaultValue) {
-  if (!orderBy) return defaultValue;
-  return enumMap[orderBy] ?? defaultValue;
-}
-function mapOrderDirection(direction, ascValue, descValue, defaultValue) {
-  if (!direction) return defaultValue ?? descValue;
-  return direction === "asc" ? ascValue : descValue;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  executePaginatedQuery,
-  mapOrderByToEnum,
-  mapOrderDirection
-});
-//# sourceMappingURL=subgraphPagination.cjs.map

package/dist/utils/subgraphPagination.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/subgraphPagination.ts"],"sourcesContent":["/**\n * @file Utilities for handling paginated subgraph queries\n * @module vana-sdk/utils/subgraphPagination\n */\n\nimport { print, type DocumentNode } from \"graphql\";\nimport type { PaginationOptions } from \"../types/options\";\n\n/**\n * Generic subgraph response structure\n */\nexport interface SubgraphResponse<T> {\n  data?: T;\n  errors?: Array<{ message: string }>;\n}\n\n/**\n * Configuration for paginated subgraph queries\n */\nexport interface PaginatedQueryConfig<TData, TItem, TRawItem = any> {\n  /** The GraphQL endpoint URL */\n  endpoint: string;\n\n  /** The GraphQL document to execute */\n  document: DocumentNode;\n\n  /** Base variables for the query (e.g., userId) */\n  baseVariables: Record<string, any>;\n\n  /** Pagination options from the user */\n  options?: PaginationOptions;\n\n  /** Function to extract items from the response */\n  extractItems: (data: TData) => TRawItem[] | undefined;\n\n  /** Function to transform items if needed */\n  transformItem?: (item: TRawItem) => TItem;\n\n  /** Maximum items per GraphQL query (default: 1000) */\n  maxPerQuery?: number;\n}\n\n/**\n * Generic paginated query executor for subgraph queries\n *\n * @remarks\n * Handles pagination, fetchAll, and proper GraphQL query construction.\n * Abstracts the common pattern of paginated subgraph queries.\n *\n * @param config - Configuration for the paginated query\n * @returns Array of items from all pages\n *\n * @example\n * ```typescript\n * const files = await executePaginatedQuery({\n *   endpoint: subgraphUrl,\n *   document: GetUserFilesPaginatedDocument,\n *   baseVariables: { userId: owner.toLowerCase() },\n *   options: { limit: 50, orderBy: 'addedAtBlock' },\n *   extractItems: (data) => data?.user?.files,\n *   transformItem: (file) => ({\n *     id: parseInt(file.id),\n *     url: file.url,\n *     // ... transform to UserFile\n *   })\n * });\n * ```\n */\nexport async function executePaginatedQuery<TData, TItem, TRawItem = any>(\n  config: PaginatedQueryConfig<TData, TItem, TRawItem>,\n): Promise<TItem[]> {\n  const {\n    endpoint,\n    document,\n    baseVariables,\n    options,\n    extractItems,\n    transformItem,\n    maxPerQuery = 1000,\n  } = config;\n\n  // Set pagination defaults\n  const limit = options?.fetchAll\n    ? Number.MAX_SAFE_INTEGER\n    : (options?.limit ?? 100);\n  const offset = options?.offset ?? 0;\n  const orderBy = options?.orderBy;\n  const orderDirection = options?.orderDirection;\n\n  const allItems: TItem[] = [];\n  let currentOffset = offset;\n  const pageSize = Math.min(limit, maxPerQuery);\n\n  // Handle fetchAll by making multiple queries if needed\n  while (true) {\n    const currentLimit = options?.fetchAll\n      ? pageSize\n      : Math.min(pageSize, limit - allItems.length);\n\n    // Build query variables\n    const variables = {\n      ...baseVariables,\n      first: currentLimit,\n      skip: currentOffset,\n      ...(orderBy && { orderBy }),\n      ...(orderDirection && { orderDirection }),\n    };\n\n    // Execute query\n    const response = await fetch(endpoint, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        query: print(document),\n        variables,\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as SubgraphResponse<TData>;\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    // Extract items from response\n    const items = extractItems(result.data as TData);\n\n    if (!items || items.length === 0) {\n      // No more items\n      break;\n    }\n\n    // Transform items if transformer provided\n    const transformedItems: TItem[] = transformItem\n      ? items.map(transformItem)\n      : (items as unknown as TItem[]);\n\n    allItems.push(...transformedItems);\n\n    // Check if we have enough items or should continue\n    if (!options?.fetchAll && allItems.length >= limit) {\n      // We have enough items\n      return allItems.slice(0, limit); // Trim to exact limit\n    }\n\n    if (items.length < currentLimit) {\n      // No more items available\n      break;\n    }\n\n    // Continue to next page\n    currentOffset += items.length;\n  }\n\n  return allItems;\n}\n\n/**\n * Helper to map string orderBy values to GraphQL enums\n *\n * @param orderBy - String orderBy value from options\n * @param enumMap - Map of string values to GraphQL enum values\n * @returns The mapped enum value or undefined\n */\nexport function mapOrderByToEnum<T>(\n  orderBy: string | undefined,\n  enumMap: Record<string, T>,\n  defaultValue?: T,\n): T | undefined {\n  if (!orderBy) return defaultValue;\n  return enumMap[orderBy] ?? defaultValue;\n}\n\n/**\n * Helper to map string orderDirection to GraphQL enum\n *\n * @param direction - Direction string ('asc' or 'desc')\n * @param ascValue - The GraphQL enum value for ascending\n * @param descValue - The GraphQL enum value for descending\n * @returns The mapped enum value\n */\nexport function mapOrderDirection<T>(\n  direction: \"asc\" | \"desc\" | undefined,\n  ascValue: T,\n  descValue: T,\n  defaultValue?: T,\n): T {\n  if (!direction) return defaultValue ?? descValue;\n  return direction === \"asc\" ? ascValue : descValue;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAAyC;AA+DzC,eAAsB,sBACpB,QACkB;AAClB,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,EAChB,IAAI;AAGJ,QAAM,QAAQ,SAAS,WACnB,OAAO,mBACN,SAAS,SAAS;AACvB,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,UAAU,SAAS;AACzB,QAAM,iBAAiB,SAAS;AAEhC,QAAM,WAAoB,CAAC;AAC3B,MAAI,gBAAgB;AACpB,QAAM,WAAW,KAAK,IAAI,OAAO,WAAW;AAG5C,SAAO,MAAM;AACX,UAAM,eAAe,SAAS,WAC1B,WACA,KAAK,IAAI,UAAU,QAAQ,SAAS,MAAM;AAG9C,UAAM,YAAY;AAAA,MAChB,GAAG;AAAA,MACH,OAAO;AAAA,MACP,MAAM;AAAA,MACN,GAAI,WAAW,EAAE,QAAQ;AAAA,MACzB,GAAI,kBAAkB,EAAE,eAAe;AAAA,IACzC;AAGA,UAAM,WAAW,MAAM,MAAM,UAAU;AAAA,MACrC,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,WAAO,sBAAM,QAAQ;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,4BAA4B,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,SAAU,MAAM,SAAS,KAAK;AAEpC,QAAI,OAAO,QAAQ;AACjB,YAAM,IAAI;AAAA,QACR,oBAAoB,OAAO,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,MACpE;AAAA,IACF;AAGA,UAAM,QAAQ,aAAa,OAAO,IAAa;AAE/C,QAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAEhC;AAAA,IACF;AAGA,UAAM,mBAA4B,gBAC9B,MAAM,IAAI,aAAa,IACtB;AAEL,aAAS,KAAK,GAAG,gBAAgB;AAGjC,QAAI,CAAC,SAAS,YAAY,SAAS,UAAU,OAAO;AAElD,aAAO,SAAS,MAAM,GAAG,KAAK;AAAA,IAChC;AAEA,QAAI,MAAM,SAAS,cAAc;AAE/B;AAAA,IACF;AAGA,qBAAiB,MAAM;AAAA,EACzB;AAEA,SAAO;AACT;AASO,SAAS,iBACd,SACA,SACA,cACe;AACf,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,OAAO,KAAK;AAC7B;AAUO,SAAS,kBACd,WACA,UACA,WACA,cACG;AACH,MAAI,CAAC,UAAW,QAAO,gBAAgB;AACvC,SAAO,cAAc,QAAQ,WAAW;AAC1C;","names":[]}

package/dist/utils/subgraphPagination.d.ts

@@ -1,78 +0,0 @@
-/**
- * @file Utilities for handling paginated subgraph queries
- * @module vana-sdk/utils/subgraphPagination
- */
-import { type DocumentNode } from "graphql";
-import type { PaginationOptions } from "../types/options";
-/**
- * Generic subgraph response structure
- */
-export interface SubgraphResponse<T> {
-    data?: T;
-    errors?: Array<{
-        message: string;
-    }>;
-}
-/**
- * Configuration for paginated subgraph queries
- */
-export interface PaginatedQueryConfig<TData, TItem, TRawItem = any> {
-    /** The GraphQL endpoint URL */
-    endpoint: string;
-    /** The GraphQL document to execute */
-    document: DocumentNode;
-    /** Base variables for the query (e.g., userId) */
-    baseVariables: Record<string, any>;
-    /** Pagination options from the user */
-    options?: PaginationOptions;
-    /** Function to extract items from the response */
-    extractItems: (data: TData) => TRawItem[] | undefined;
-    /** Function to transform items if needed */
-    transformItem?: (item: TRawItem) => TItem;
-    /** Maximum items per GraphQL query (default: 1000) */
-    maxPerQuery?: number;
-}
-/**
- * Generic paginated query executor for subgraph queries
- *
- * @remarks
- * Handles pagination, fetchAll, and proper GraphQL query construction.
- * Abstracts the common pattern of paginated subgraph queries.
- *
- * @param config - Configuration for the paginated query
- * @returns Array of items from all pages
- *
- * @example
- * ```typescript
- * const files = await executePaginatedQuery({
- *   endpoint: subgraphUrl,
- *   document: GetUserFilesPaginatedDocument,
- *   baseVariables: { userId: owner.toLowerCase() },
- *   options: { limit: 50, orderBy: 'addedAtBlock' },
- *   extractItems: (data) => data?.user?.files,
- *   transformItem: (file) => ({
- *     id: parseInt(file.id),
- *     url: file.url,
- *     // ... transform to UserFile
- *   })
- * });
- * ```
- */
-export declare function executePaginatedQuery<TData, TItem, TRawItem = any>(config: PaginatedQueryConfig<TData, TItem, TRawItem>): Promise<TItem[]>;
-/**
- * Helper to map string orderBy values to GraphQL enums
- *
- * @param orderBy - String orderBy value from options
- * @param enumMap - Map of string values to GraphQL enum values
- * @returns The mapped enum value or undefined
- */
-export declare function mapOrderByToEnum<T>(orderBy: string | undefined, enumMap: Record<string, T>, defaultValue?: T): T | undefined;
-/**
- * Helper to map string orderDirection to GraphQL enum
- *
- * @param direction - Direction string ('asc' or 'desc')
- * @param ascValue - The GraphQL enum value for ascending
- * @param descValue - The GraphQL enum value for descending
- * @returns The mapped enum value
- */
-export declare function mapOrderDirection<T>(direction: "asc" | "desc" | undefined, ascValue: T, descValue: T, defaultValue?: T): T;