@opendatalabs/vana-sdk 2.2.3 → 3.0.0

package/dist/controllers/schemas.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/controllers/schemas.ts"],"sourcesContent":["import type {\n  Schema,\n  SchemaMetadata,\n  CompleteSchema,\n  AddSchemaParams,\n} from \"../types/index\";\n// import type { TransactionResult } from \"../types/operations\";\nimport type { SchemaAddedResult } from \"../types/transactionResults\";\nimport type { ControllerContext } from \"./permissions\";\nimport { BaseController } from \"./base\";\nimport { getContractAddress } from \"../generated/addresses\";\nimport { getAbi } from \"../generated/abi\";\nimport { gasAwareMulticall } from \"../utils/multicall\";\nimport {\n  validateDataSchemaAgainstMetaSchema,\n  SchemaValidationError,\n  type DataSchema,\n} from \"../utils/schemaValidation\";\nimport {\n  fetchSchemaFromChain,\n  fetchSchemaCountFromChain,\n} from \"../utils/blockchain/registry\";\nimport {\n  GetSchemaDocument,\n  ListSchemasDocument,\n  CountSchemasDocument,\n  type GetSchemaQuery,\n  type ListSchemasQuery,\n  type CountSchemasQuery,\n} from \"../generated/subgraph\";\nimport { print } from \"graphql\";\nimport { fetchFromUrl, UrlResolutionError } from \"../utils/urlResolver\";\n\n/**\n * Parameters for creating a new schema with automatic IPFS upload.\n *\n * @remarks\n * This interface is used with the high-level `schemas.create()` method which\n * automatically uploads the schema definition to IPFS and registers it on-chain.\n * @category Schema Management\n */\nexport interface CreateSchemaParams {\n  /** The name of the schema */\n  name: string;\n  /** The dialect of the schema (e.g., 'json' or 'sqlite') */\n  dialect: \"json\" | \"sqlite\";\n  /** The schema definition object or JSON string */\n  schema: object | string;\n}\n\n/**\n * Result of creating a new schema.\n *\n * @remarks\n * Returned by the `schemas.create()` method after successful upload and registration.\n * @category Schema Management\n */\nexport interface CreateSchemaResult {\n  /** The schema ID assigned by the contract */\n  schemaId: bigint;\n  /** The IPFS URL where the schema definition is stored */\n  definitionUrl: string;\n  /** The transaction hash of the schema registration */\n  transactionHash: string;\n}\n\n/**\n * Manages data schemas for validation and structure definition on Vana.\n *\n * @remarks\n * Handles schema lifecycle from creation through registration. Schemas define\n * data structure and validation rules, ensuring consistency across the network.\n * Stored unencrypted on IPFS for public reusability.\n *\n * **Architecture:**\n * Schemas use dual storage: definitions on IPFS (public), metadata on blockchain.\n * Supports JSON Schema and SQLite dialects for flexible data modeling.\n *\n * **Method Selection:**\n * - `create()` - Validate, upload to IPFS, register on blockchain\n * - `get()` - Retrieve schema with definition by ID\n * - `list()` - Paginated schema browsing with metadata\n * - `count()` - Total schemas for pagination\n * - `addSchema()` - Low-level registration with pre-uploaded URL\n *\n * **Storage Requirements:**\n * - Methods requiring storage: `create()`\n * - Methods without storage: `get()`, `list()`, `count()`, `addSchema()`\n *\n * @example\n * ```typescript\n * // Create schema with validation rules\n * const result = await vana.schemas.create({\n *   name: \"User Profile\",\n *   dialect: \"json\",\n *   schema: {\n *     type: \"object\",\n *     properties: {\n *       name: { type: \"string\", minLength: 1 },\n *       age: { type: \"number\", minimum: 0, maximum: 150 }\n *     },\n *     required: [\"name\"]\n *   }\n * });\n * console.log(`Schema ${result.schemaId} created`);\n *\n * // Retrieve for validation\n * const schema = await vana.schemas.get(result.schemaId);\n * console.log(`Schema: ${schema.name} (${schema.dialect})`);\n *\n * // Browse available schemas\n * const schemas = await vana.schemas.list({ limit: 10 });\n * schemas.forEach(s => console.log(`${s.id}: ${s.name}`));\n * ```\n *\n * @category Schema Management\n * @see For conceptual overview, visit {@link https://docs.vana.org/docs/schemas}\n */\nexport class SchemaController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  /**\n   * Creates a schema with validation and IPFS upload.\n   *\n   * @remarks\n   * Primary method for schema creation. Validates definition,\n   * uploads to IPFS (unencrypted for reusability), and registers\n   * on blockchain. Schema becomes immediately available network-wide.\n   *\n   * @param params - Creation configuration\n   * @param params.name - Human-readable schema name\n   * @param params.dialect - Schema format (`\"json\"` or `\"sqlite\"`)\n   * @param params.schema - Definition object or JSON string\n   *\n   * @returns Schema ID, IPFS URL, and transaction hash\n   *\n   * @throws {SchemaValidationError} Invalid schema definition.\n   *   Verify schema follows JSON Schema or SQLite format.\n   * @throws {Error} Storage not configured.\n   *   Configure storage providers in VanaConfig.\n   * @throws {Error} IPFS upload failed.\n   *   Check network and storage provider status.\n   *\n   * @example\n   * ```typescript\n   * const result = await vana.schemas.create({\n   *   name: \"User Profile\",\n   *   dialect: \"json\",\n   *   schema: {\n   *     type: \"object\",\n   *     properties: {\n   *       name: { type: \"string\", minLength: 1 },\n   *       age: { type: \"number\", minimum: 0 }\n   *     },\n   *     required: [\"name\"]\n   *   }\n   * });\n   * console.log(`Schema ${result.schemaId} at ${result.definitionUrl}`);\n   * ```\n   */\n  async create(params: CreateSchemaParams): Promise<CreateSchemaResult> {\n    this.assertWallet();\n    const { name, dialect, schema } = params;\n\n    try {\n      // Step 1: Normalize and validate the schema definition\n      let schemaDefinition: object;\n      if (typeof schema === \"string\") {\n        try {\n          schemaDefinition = JSON.parse(schema);\n        } catch {\n          throw new SchemaValidationError(\n            \"Invalid JSON in schema definition\",\n            [],\n          );\n        }\n      } else {\n        schemaDefinition = schema;\n      }\n\n      // Step 2: Validate against metaschema\n      const dataSchema: DataSchema = {\n        name,\n        version: \"1.0.0\",\n        dialect,\n        schema: schemaDefinition,\n      };\n\n      validateDataSchemaAgainstMetaSchema(dataSchema);\n\n      // Step 3: Upload to IPFS (unencrypted for public access)\n      if (!this.context.storageManager) {\n        // Use centralized validation if available, otherwise fall back to old behavior\n        if (this.context.validateStorageRequired) {\n          this.context.validateStorageRequired();\n          // The validateStorageRequired method throws, so this line should never be reached\n          // but TypeScript doesn't know that, so we need this fallback\n          throw new Error(\"Storage validation failed\");\n        } else {\n          throw new Error(\n            \"Storage manager not configured. Please provide storage providers in VanaConfig.\",\n          );\n        }\n      }\n\n      const schemaBlob = new Blob([JSON.stringify(dataSchema)], {\n        type: \"application/json\",\n      });\n\n      const uploadResult = await this.context.storageManager.upload(\n        schemaBlob,\n        `${name.replace(/[^a-zA-Z0-9]/g, \"_\")}.json`,\n      );\n\n      // Step 4: Register on blockchain\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const account =\n        this.context.walletClient.account ?? this.context.userAddress;\n      const from = typeof account === \"string\" ? account : account?.address;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [name, dialect, uploadResult.url],\n        account,\n        chain: this.context.walletClient.chain ?? null,\n      });\n\n      const { tx } = await import(\"../utils/transactionHelpers\");\n      const txResult = tx({\n        hash,\n        from: from!,\n        contract: \"DataRefinerRegistry\",\n        fn: \"addSchema\",\n      });\n\n      // Wait for events and extract domain data\n      if (!this.context.waitForTransactionEvents) {\n        throw new Error(\"waitForTransactionEvents not configured\");\n      }\n\n      const result = await this.context.waitForTransactionEvents(txResult);\n      const event = result.expectedEvents.SchemaAdded;\n      if (!event) {\n        throw new Error(\"SchemaAdded event not found in transaction\");\n      }\n\n      return {\n        schemaId: event.schemaId,\n        definitionUrl: uploadResult.url,\n        transactionHash: hash,\n      };\n    } catch (error) {\n      if (error instanceof SchemaValidationError) {\n        throw error;\n      }\n      throw new Error(\n        `Schema creation failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Retrieves a complete schema by its ID with definition fetched and flattened.\n   *\n   * @param schemaId - The ID of the schema to retrieve\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the complete schema object with all fields populated\n   * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable\n   * @example\n   * ```typescript\n   * const schema = await vana.schemas.get(1);\n   * console.log(`Schema: ${schema.name} (${schema.dialect})`);\n   * console.log(`Version: ${schema.version}`);\n   * console.log(`Description: ${schema.description}`);\n   * console.log('Schema:', schema.schema);\n   *\n   * // Use directly with validator (schema has all required fields)\n   * validator.validateDataAgainstSchema(data, schema);\n   * ```\n   */\n  async get(\n    schemaId: number,\n    options: { subgraphUrl?: string } = {},\n  ): Promise<CompleteSchema> {\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    let metadata: SchemaMetadata;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        metadata = await this._getSchemaViaSubgraph({ schemaId, subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n        try {\n          metadata = await fetchSchemaFromChain(this.context, schemaId);\n        } catch (rpcError) {\n          throw new Error(\n            `Failed to get schema: ${rpcError instanceof Error ? rpcError.message : \"Unknown error\"}`,\n          );\n        }\n      }\n    } else {\n      // Use RPC directly\n      try {\n        metadata = await fetchSchemaFromChain(this.context, schemaId);\n      } catch (error) {\n        throw new Error(\n          `Failed to get schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        );\n      }\n    }\n\n    // Fetch the definition (should be a complete DataSchema)\n    const definition = await fetchFromUrl(\n      metadata.definitionUrl,\n      this.context.downloadRelayer,\n    );\n\n    if (!definition || typeof definition !== \"object\") {\n      throw new Error(\n        `Invalid schema definition format for schema ${schemaId}`,\n      );\n    }\n\n    // Validate the fetched DataSchema\n    validateDataSchemaAgainstMetaSchema(definition);\n    const dataSchema = definition as DataSchema;\n\n    // Verify on-chain and off-chain data match\n    if (dataSchema.name !== metadata.name) {\n      console.warn(\n        `Schema name mismatch for ID ${schemaId}: on-chain=\"${metadata.name}\" off-chain=\"${dataSchema.name}\" (using on-chain value)`,\n      );\n    }\n    if (dataSchema.dialect !== metadata.dialect) {\n      console.warn(\n        `Schema dialect mismatch for ID ${schemaId}: on-chain=\"${metadata.dialect}\" off-chain=\"${dataSchema.dialect}\" (using on-chain value)`,\n      );\n    }\n\n    // Return using on-chain values as authoritative source\n    return {\n      ...metadata,\n      version: dataSchema.version,\n      description: dataSchema.description,\n      schema: dataSchema.schema,\n    };\n  }\n\n  /**\n   * Gets the total number of schemas registered on the network.\n   *\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the total schema count\n   * @throws {Error} When the count cannot be retrieved\n   * @example\n   * ```typescript\n   * const count = await vana.schemas.count();\n   * console.log(`Total schemas: ${count}`);\n   *\n   * // With custom subgraph\n   * const count = await vana.schemas.count({\n   *   subgraphUrl: 'https://custom-subgraph.com/graphql'\n   * });\n   * ```\n   */\n  async count(options: { subgraphUrl?: string } = {}): Promise<number> {\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._countSchemasViaSubgraph({ subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    // Use RPC (as fallback or primary method)\n    try {\n      return await fetchSchemaCountFromChain(this.context);\n    } catch (error) {\n      throw new Error(\n        `Failed to get schemas count: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Lists all schemas with pagination.\n   *\n   * @param options - Optional parameters for listing schemas\n   * @param options.limit - Maximum number of schemas to return\n   * @param options.offset - Number of schemas to skip\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)\n   * @returns Promise resolving to an array of schemas\n   * @example\n   * ```typescript\n   * // Get all schemas (without definitions for performance)\n   * const schemas = await vana.schemas.list();\n   *\n   * // Get schemas with definitions\n   * const schemas = await vana.schemas.list({ includeDefinitions: true });\n   *\n   * // Get schemas with pagination\n   * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });\n   * ```\n   */\n  async list(\n    options: {\n      limit?: number;\n      offset?: number;\n      subgraphUrl?: string;\n      includeDefinitions?: boolean;\n      minBlock?: number;\n      waitForSync?: number;\n    } = {},\n  ): Promise<Schema[]> {\n    const {\n      limit = 100,\n      offset = 0,\n      includeDefinitions = false,\n      minBlock,\n      waitForSync,\n    } = options;\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    // Check consistency requirements if using subgraph\n    if (subgraphUrl && (minBlock || waitForSync)) {\n      const { checkSubgraphConsistency } = await import(\n        \"../utils/subgraphConsistency\"\n      );\n      await checkSubgraphConsistency(subgraphUrl, { minBlock, waitForSync });\n    }\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._listSchemasViaSubgraph({\n          limit,\n          offset,\n          subgraphUrl,\n        });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    try {\n      const totalCount = await this.count();\n      const start = offset;\n      const end = Math.min(start + limit, totalCount);\n\n      if (end <= start) {\n        return [];\n      }\n\n      // Get contract address and ABI\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      // Build multicall batch for fetching schemas\n      const schemaCalls = [];\n      for (let i = start; i < end; i++) {\n        schemaCalls.push({\n          address: dataRefinerRegistryAddress,\n          abi: dataRefinerRegistryAbi,\n          functionName: \"schemas\",\n          args: [BigInt(i + 1)], // Schema IDs are 1-based\n        } as const);\n      }\n\n      // Fetch all schemas in batches using gasAwareMulticall\n      const schemaResults = await gasAwareMulticall<\n        typeof schemaCalls,\n        true // Allow failures for individual schema lookups\n      >(this.context.publicClient, {\n        contracts: schemaCalls,\n        allowFailure: true,\n      });\n\n      // Process results\n      const schemas: Schema[] = [];\n      schemaResults.forEach((result, index) => {\n        if (result.status === \"success\" && result.result) {\n          const schemaId = start + index + 1; // Schema IDs are 1-based\n          const schemaData = result.result as {\n            name: string;\n            dialect: string;\n            definitionUrl: string;\n          };\n\n          if (\n            schemaData.name &&\n            schemaData.dialect &&\n            schemaData.definitionUrl\n          ) {\n            schemas.push({\n              id: schemaId,\n              name: schemaData.name,\n              dialect: schemaData.dialect as \"json\" | \"sqlite\",\n              definitionUrl: schemaData.definitionUrl,\n            });\n          } else {\n            console.warn(`Incomplete schema data for ID ${schemaId}`);\n          }\n        } else {\n          // Skip schemas that can't be retrieved\n          console.warn(`Failed to retrieve schema ${start + index + 1}`);\n        }\n      });\n\n      // Optionally fetch definitions for all schemas\n      if (includeDefinitions) {\n        await this._fetchDefinitionsForSchemas(schemas);\n      }\n\n      return schemas;\n    } catch (error) {\n      throw new Error(\n        `Failed to list schemas: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Retrieves schema definition content directly from a URL.\n   *\n   * @remarks\n   * Use this method to fetch and format schema definitions from IPFS or HTTP URLs.\n   * Automatically uses the SDK's configured download proxy to bypass CORS restrictions.\n   * Returns formatted JSON string if content is valid JSON, otherwise raw content.\n   *\n   * @param url - The definition URL (typically from schema.definitionUrl)\n   * @returns Promise resolving to the formatted definition content\n   * @throws {Error} When the content cannot be fetched or network errors occur\n   * @example\n   * ```typescript\n   * const schema = await vana.schemas.get(1);\n   * const definition = await vana.schemas.retrieveDefinition(schema.definitionUrl);\n   * console.log(definition); // Pretty-printed JSON\n   * ```\n   */\n  async retrieveDefinition(url: string): Promise<string> {\n    try {\n      const { universalFetch } = await import(\"../utils/download\");\n      const response = await universalFetch(url, this.context.downloadRelayer);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const text = await response.text();\n\n      // Try to parse and format as JSON for better readability\n      try {\n        const json = JSON.parse(text);\n        return JSON.stringify(json, null, 2);\n      } catch {\n        // Not JSON, return as-is\n        return text;\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to retrieve schema definition: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Retrieves refinement instruction content from a URL.\n   *\n   * @remarks\n   * Use this method to fetch refinement instructions from IPFS or HTTP URLs.\n   * Temporarily housed in SchemaController since refiners use schemas and we don't\n   * have a dedicated RefinerController yet. Uses the SDK's configured download proxy.\n   *\n   * @param url - The instruction URL (typically from refiner.refinementInstructionUrl)\n   * @returns Promise resolving to the formatted instruction content\n   * @throws {Error} When the content cannot be fetched or network errors occur\n   * @example\n   * ```typescript\n   * const instructions = await vana.schemas.retrieveRefinementInstructions(\n   *   refiner.refinementInstructionUrl\n   * );\n   * console.log(instructions);\n   * ```\n   */\n  async retrieveRefinementInstructions(url: string): Promise<string> {\n    try {\n      // Reuse the same logic as retrieveDefinition\n      return await this.retrieveDefinition(url);\n    } catch (error) {\n      // Re-throw with more specific error message\n      throw new Error(\n        `Failed to retrieve refinement instructions: ${\n          error instanceof Error\n            ? error.message.replace(\n                \"Failed to retrieve schema definition: \",\n                \"\",\n              )\n            : \"Unknown error\"\n        }`,\n      );\n    }\n  }\n\n  /**\n   * Adds a schema using the legacy method (low-level API).\n   *\n   * @deprecated Use create() instead for the high-level API with automatic IPFS upload\n   * @param params - Schema parameters including pre-generated definition URL\n   * @returns Promise resolving to the add schema result\n   */\n  async addSchema(params: AddSchemaParams): Promise<SchemaAddedResult> {\n    this.assertWallet();\n    try {\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const account =\n        this.context.walletClient.account ?? this.context.userAddress;\n      const from = typeof account === \"string\" ? account : account?.address;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [params.name, params.dialect, params.definitionUrl],\n        account,\n        chain: this.context.walletClient.chain ?? null,\n      });\n\n      // Create TransactionResult POJO\n      const { tx } = await import(\"../utils/transactionHelpers\");\n      const txResult = tx({\n        hash,\n        from: from!,\n        contract: \"DataRefinerRegistry\",\n        fn: \"addSchema\",\n      });\n\n      // Wait for events and extract domain data\n      if (!this.context.waitForTransactionEvents) {\n        throw new Error(\"waitForTransactionEvents not configured\");\n      }\n\n      const result = await this.context.waitForTransactionEvents(txResult);\n      const event = result.expectedEvents.SchemaAdded;\n      if (!event) {\n        throw new Error(\"SchemaAdded event not found in transaction\");\n      }\n\n      const receipt = await this.context.publicClient.getTransactionReceipt({\n        hash,\n      });\n\n      return {\n        transactionHash: hash,\n        blockNumber: receipt.blockNumber,\n        gasUsed: receipt.gasUsed,\n        schemaId: event.schemaId,\n        name: event.name,\n        dialect: event.dialect,\n        definitionUrl: event.definitionUrl,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to add schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Internal method: Query schema via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.schemaId - The ID of the schema to retrieve\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the schema object\n   * @private\n   */\n  private async _getSchemaViaSubgraph(params: {\n    schemaId: number;\n    subgraphUrl: string;\n  }): Promise<SchemaMetadata> {\n    const { schemaId, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(GetSchemaDocument),\n        variables: { id: schemaId.toString() },\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 {\n      data?: GetSchemaQuery;\n      errors?: { message: string }[];\n    };\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?.schema) {\n      throw new Error(`Schema ${schemaId} not found in subgraph`);\n    }\n\n    // Map subgraph schema to SDK schema type\n    const subgraphSchema = result.data.schema;\n    return {\n      id: parseInt(subgraphSchema.id),\n      name: subgraphSchema.name,\n      dialect: subgraphSchema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: subgraphSchema.definitionUrl,\n    };\n  }\n\n  /**\n   * Internal method: List schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.limit - Maximum number of schemas to return\n   * @param params.offset - Number of schemas to skip\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to an array of schemas\n   * @private\n   */\n  private async _listSchemasViaSubgraph(params: {\n    limit: number;\n    offset: number;\n    subgraphUrl: string;\n  }): Promise<Schema[]> {\n    const { limit, offset, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(ListSchemasDocument),\n        variables: { first: limit, skip: offset },\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 {\n      data?: ListSchemasQuery;\n      errors?: { message: string }[];\n    };\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?.schemas) {\n      return [];\n    }\n\n    // Map subgraph schemas to SDK schema type\n    const schemas = result.data.schemas.map((schema) => ({\n      id: parseInt(schema.id),\n      name: schema.name,\n      dialect: schema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: schema.definitionUrl,\n    }));\n\n    // Optionally fetch definitions if requested\n    const { includeDefinitions } = params as { includeDefinitions?: boolean };\n    if (includeDefinitions) {\n      await this._fetchDefinitionsForSchemas(schemas);\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Internal method: Count schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the total schema count\n   * @private\n   */\n  private async _countSchemasViaSubgraph(params: {\n    subgraphUrl: string;\n  }): Promise<number> {\n    const { subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(CountSchemasDocument),\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 {\n      data?: CountSchemasQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    return result.data?.schemas?.length ?? 0;\n  }\n\n  /**\n   * Gets the user's wallet address.\n   *\n   * @private\n   * @returns Promise resolving to the user's address\n   */\n\n  /**\n   * Fetches and attaches definitions to an array of schemas.\n   *\n   * @param schemas - Array of schemas to fetch definitions for\n   * @private\n   */\n  private async _fetchDefinitionsForSchemas(schemas: Schema[]): Promise<void> {\n    // Fetch definitions concurrently for performance\n    await Promise.all(\n      schemas.map(async (schema) => {\n        if (!schema.definitionUrl) return;\n\n        try {\n          const definition = await fetchFromUrl(\n            schema.definitionUrl,\n            this.context.downloadRelayer,\n          );\n\n          if (definition && typeof definition === \"object\") {\n            // Validate the fetched DataSchema\n            validateDataSchemaAgainstMetaSchema(definition);\n            const dataSchema = definition as DataSchema;\n\n            // Populate flat fields\n            schema.version = dataSchema.version;\n            schema.description = dataSchema.description;\n            schema.schema = dataSchema.schema;\n          }\n        } catch (error) {\n          // Don't fail the entire list operation if one definition fails\n          console.error(\n            `Failed to fetch/validate definition for schema ${schema.id}:`,\n            error instanceof UrlResolutionError ||\n              error instanceof SchemaValidationError\n              ? error.message\n              : error,\n          );\n        }\n      }),\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/schemas.d.ts

@@ -1,293 +0,0 @@
-import type { Schema, CompleteSchema, AddSchemaParams } from "../types/index";
-import type { SchemaAddedResult } from "../types/transactionResults";
-import type { ControllerContext } from "./permissions";
-import { BaseController } from "./base";
-/**
- * Parameters for creating a new schema with automatic IPFS upload.
- *
- * @remarks
- * This interface is used with the high-level `schemas.create()` method which
- * automatically uploads the schema definition to IPFS and registers it on-chain.
- * @category Schema Management
- */
-export interface CreateSchemaParams {
-    /** The name of the schema */
-    name: string;
-    /** The dialect of the schema (e.g., 'json' or 'sqlite') */
-    dialect: "json" | "sqlite";
-    /** The schema definition object or JSON string */
-    schema: object | string;
-}
-/**
- * Result of creating a new schema.
- *
- * @remarks
- * Returned by the `schemas.create()` method after successful upload and registration.
- * @category Schema Management
- */
-export interface CreateSchemaResult {
-    /** The schema ID assigned by the contract */
-    schemaId: bigint;
-    /** The IPFS URL where the schema definition is stored */
-    definitionUrl: string;
-    /** The transaction hash of the schema registration */
-    transactionHash: string;
-}
-/**
- * Manages data schemas for validation and structure definition on Vana.
- *
- * @remarks
- * Handles schema lifecycle from creation through registration. Schemas define
- * data structure and validation rules, ensuring consistency across the network.
- * Stored unencrypted on IPFS for public reusability.
- *
- * **Architecture:**
- * Schemas use dual storage: definitions on IPFS (public), metadata on blockchain.
- * Supports JSON Schema and SQLite dialects for flexible data modeling.
- *
- * **Method Selection:**
- * - `create()` - Validate, upload to IPFS, register on blockchain
- * - `get()` - Retrieve schema with definition by ID
- * - `list()` - Paginated schema browsing with metadata
- * - `count()` - Total schemas for pagination
- * - `addSchema()` - Low-level registration with pre-uploaded URL
- *
- * **Storage Requirements:**
- * - Methods requiring storage: `create()`
- * - Methods without storage: `get()`, `list()`, `count()`, `addSchema()`
- *
- * @example
- * ```typescript
- * // Create schema with validation rules
- * const result = await vana.schemas.create({
- *   name: "User Profile",
- *   dialect: "json",
- *   schema: {
- *     type: "object",
- *     properties: {
- *       name: { type: "string", minLength: 1 },
- *       age: { type: "number", minimum: 0, maximum: 150 }
- *     },
- *     required: ["name"]
- *   }
- * });
- * console.log(`Schema ${result.schemaId} created`);
- *
- * // Retrieve for validation
- * const schema = await vana.schemas.get(result.schemaId);
- * console.log(`Schema: ${schema.name} (${schema.dialect})`);
- *
- * // Browse available schemas
- * const schemas = await vana.schemas.list({ limit: 10 });
- * schemas.forEach(s => console.log(`${s.id}: ${s.name}`));
- * ```
- *
- * @category Schema Management
- * @see For conceptual overview, visit {@link https://docs.vana.org/docs/schemas}
- */
-export declare class SchemaController extends BaseController {
-    constructor(context: ControllerContext);
-    /**
-     * Creates a schema with validation and IPFS upload.
-     *
-     * @remarks
-     * Primary method for schema creation. Validates definition,
-     * uploads to IPFS (unencrypted for reusability), and registers
-     * on blockchain. Schema becomes immediately available network-wide.
-     *
-     * @param params - Creation configuration
-     * @param params.name - Human-readable schema name
-     * @param params.dialect - Schema format (`"json"` or `"sqlite"`)
-     * @param params.schema - Definition object or JSON string
-     *
-     * @returns Schema ID, IPFS URL, and transaction hash
-     *
-     * @throws {SchemaValidationError} Invalid schema definition.
-     *   Verify schema follows JSON Schema or SQLite format.
-     * @throws {Error} Storage not configured.
-     *   Configure storage providers in VanaConfig.
-     * @throws {Error} IPFS upload failed.
-     *   Check network and storage provider status.
-     *
-     * @example
-     * ```typescript
-     * const result = await vana.schemas.create({
-     *   name: "User Profile",
-     *   dialect: "json",
-     *   schema: {
-     *     type: "object",
-     *     properties: {
-     *       name: { type: "string", minLength: 1 },
-     *       age: { type: "number", minimum: 0 }
-     *     },
-     *     required: ["name"]
-     *   }
-     * });
-     * console.log(`Schema ${result.schemaId} at ${result.definitionUrl}`);
-     * ```
-     */
-    create(params: CreateSchemaParams): Promise<CreateSchemaResult>;
-    /**
-     * Retrieves a complete schema by its ID with definition fetched and flattened.
-     *
-     * @param schemaId - The ID of the schema to retrieve
-     * @param options - Optional parameters
-     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
-     * @returns Promise resolving to the complete schema object with all fields populated
-     * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable
-     * @example
-     * ```typescript
-     * const schema = await vana.schemas.get(1);
-     * console.log(`Schema: ${schema.name} (${schema.dialect})`);
-     * console.log(`Version: ${schema.version}`);
-     * console.log(`Description: ${schema.description}`);
-     * console.log('Schema:', schema.schema);
-     *
-     * // Use directly with validator (schema has all required fields)
-     * validator.validateDataAgainstSchema(data, schema);
-     * ```
-     */
-    get(schemaId: number, options?: {
-        subgraphUrl?: string;
-    }): Promise<CompleteSchema>;
-    /**
-     * Gets the total number of schemas registered on the network.
-     *
-     * @param options - Optional parameters
-     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
-     * @returns Promise resolving to the total schema count
-     * @throws {Error} When the count cannot be retrieved
-     * @example
-     * ```typescript
-     * const count = await vana.schemas.count();
-     * console.log(`Total schemas: ${count}`);
-     *
-     * // With custom subgraph
-     * const count = await vana.schemas.count({
-     *   subgraphUrl: 'https://custom-subgraph.com/graphql'
-     * });
-     * ```
-     */
-    count(options?: {
-        subgraphUrl?: string;
-    }): Promise<number>;
-    /**
-     * Lists all schemas with pagination.
-     *
-     * @param options - Optional parameters for listing schemas
-     * @param options.limit - Maximum number of schemas to return
-     * @param options.offset - Number of schemas to skip
-     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
-     * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)
-     * @returns Promise resolving to an array of schemas
-     * @example
-     * ```typescript
-     * // Get all schemas (without definitions for performance)
-     * const schemas = await vana.schemas.list();
-     *
-     * // Get schemas with definitions
-     * const schemas = await vana.schemas.list({ includeDefinitions: true });
-     *
-     * // Get schemas with pagination
-     * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });
-     * ```
-     */
-    list(options?: {
-        limit?: number;
-        offset?: number;
-        subgraphUrl?: string;
-        includeDefinitions?: boolean;
-        minBlock?: number;
-        waitForSync?: number;
-    }): Promise<Schema[]>;
-    /**
-     * Retrieves schema definition content directly from a URL.
-     *
-     * @remarks
-     * Use this method to fetch and format schema definitions from IPFS or HTTP URLs.
-     * Automatically uses the SDK's configured download proxy to bypass CORS restrictions.
-     * Returns formatted JSON string if content is valid JSON, otherwise raw content.
-     *
-     * @param url - The definition URL (typically from schema.definitionUrl)
-     * @returns Promise resolving to the formatted definition content
-     * @throws {Error} When the content cannot be fetched or network errors occur
-     * @example
-     * ```typescript
-     * const schema = await vana.schemas.get(1);
-     * const definition = await vana.schemas.retrieveDefinition(schema.definitionUrl);
-     * console.log(definition); // Pretty-printed JSON
-     * ```
-     */
-    retrieveDefinition(url: string): Promise<string>;
-    /**
-     * Retrieves refinement instruction content from a URL.
-     *
-     * @remarks
-     * Use this method to fetch refinement instructions from IPFS or HTTP URLs.
-     * Temporarily housed in SchemaController since refiners use schemas and we don't
-     * have a dedicated RefinerController yet. Uses the SDK's configured download proxy.
-     *
-     * @param url - The instruction URL (typically from refiner.refinementInstructionUrl)
-     * @returns Promise resolving to the formatted instruction content
-     * @throws {Error} When the content cannot be fetched or network errors occur
-     * @example
-     * ```typescript
-     * const instructions = await vana.schemas.retrieveRefinementInstructions(
-     *   refiner.refinementInstructionUrl
-     * );
-     * console.log(instructions);
-     * ```
-     */
-    retrieveRefinementInstructions(url: string): Promise<string>;
-    /**
-     * Adds a schema using the legacy method (low-level API).
-     *
-     * @deprecated Use create() instead for the high-level API with automatic IPFS upload
-     * @param params - Schema parameters including pre-generated definition URL
-     * @returns Promise resolving to the add schema result
-     */
-    addSchema(params: AddSchemaParams): Promise<SchemaAddedResult>;
-    /**
-     * Internal method: Query schema via subgraph
-     *
-     * @param params - Query parameters
-     * @param params.schemaId - The ID of the schema to retrieve
-     * @param params.subgraphUrl - The subgraph URL to query
-     * @returns Promise resolving to the schema object
-     * @private
-     */
-    private _getSchemaViaSubgraph;
-    /**
-     * Internal method: List schemas via subgraph
-     *
-     * @param params - Query parameters
-     * @param params.limit - Maximum number of schemas to return
-     * @param params.offset - Number of schemas to skip
-     * @param params.subgraphUrl - The subgraph URL to query
-     * @returns Promise resolving to an array of schemas
-     * @private
-     */
-    private _listSchemasViaSubgraph;
-    /**
-     * Internal method: Count schemas via subgraph
-     *
-     * @param params - Query parameters
-     * @param params.subgraphUrl - The subgraph URL to query
-     * @returns Promise resolving to the total schema count
-     * @private
-     */
-    private _countSchemasViaSubgraph;
-    /**
-     * Gets the user's wallet address.
-     *
-     * @private
-     * @returns Promise resolving to the user's address
-     */
-    /**
-     * Fetches and attaches definitions to an array of schemas.
-     *
-     * @param schemas - Array of schemas to fetch definitions for
-     * @private
-     */
-    private _fetchDefinitionsForSchemas;
-}