[{"data":1,"prerenderedAt":1967},["ShallowReactive",2],{"navigation_docs_en":3,"-en-getting-started-migrating-from-other-libraries":342,"-en-getting-started-migrating-from-other-libraries-surround":1962},[4,45,91,137,195,236,257,291,327],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":44},"Getting Started","i-lucide-rocket","/en/getting-started","en/01.getting-started",[10,15,20,24,29,34,39],{"title":11,"path":12,"stem":13,"icon":14},"What is Qora?","/en/getting-started/what-is-qora","en/01.getting-started/2.what-is-qora","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Installation","/en/getting-started/installation","en/01.getting-started/3.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":6},"Quick Start","/en/getting-started/quick-start","en/01.getting-started/4.quick-start",{"title":25,"path":26,"stem":27,"icon":28},"Comparison","/en/getting-started/comparison","en/01.getting-started/5.comparison","i-lucide-scale",{"title":30,"path":31,"stem":32,"icon":33},"Coming from TanStack Query","/en/getting-started/coming-from-tanstack-query","en/01.getting-started/6.coming-from-tanstack-query","i-lucide-arrow-left-right",{"title":35,"path":36,"stem":37,"icon":38},"Migrating from Other Libraries","/en/getting-started/migrating-from-other-libraries","en/01.getting-started/7.migrating-from-other-libraries","i-lucide-arrow-right-left",{"title":40,"path":41,"stem":42,"icon":43},"AI Assistants","/en/getting-started/ai-assistants","en/01.getting-started/8.ai-assistants","i-lucide-sparkles",false,{"title":46,"icon":47,"path":48,"stem":49,"children":50,"page":44},"Core Concepts","i-lucide-book-open","/en/core-concepts","en/02.core-concepts",[51,56,61,66,71,76,81,86],{"title":52,"path":53,"stem":54,"icon":55},"Queries","/en/core-concepts/queries","en/02.core-concepts/1.queries","i-lucide-database",{"title":57,"path":58,"stem":59,"icon":60},"Query Keys","/en/core-concepts/query-keys","en/02.core-concepts/2.query-keys","i-lucide-key-round",{"title":62,"path":63,"stem":64,"icon":65},"Query States","/en/core-concepts/query-states","en/02.core-concepts/3.query-states","i-lucide-activity",{"title":67,"path":68,"stem":69,"icon":70},"Caching","/en/core-concepts/caching","en/02.core-concepts/4.caching","i-lucide-layers-3",{"title":72,"path":73,"stem":74,"icon":75},"Stale-While-Revalidate","/en/core-concepts/stale-while-revalidate","en/02.core-concepts/5.stale-while-revalidate","i-lucide-timer-reset",{"title":77,"path":78,"stem":79,"icon":80},"Deduplication","/en/core-concepts/deduplication","en/02.core-concepts/6.deduplication","i-lucide-copy-minus",{"title":82,"path":83,"stem":84,"icon":85},"Mutations & Invalidation","/en/core-concepts/mutations","en/02.core-concepts/7.mutations","i-lucide-pencil-line",{"title":87,"path":88,"stem":89,"icon":90},"Offline & Network","/en/core-concepts/offline","en/02.core-concepts/8.offline","i-lucide-wifi-off",{"title":92,"icon":93,"path":94,"stem":95,"children":96,"page":44},"Flutter Integration","i-lucide-smartphone","/en/flutter-integration","en/03.flutter-integration",[97,102,107,112,117,122,127,132],{"title":98,"path":99,"stem":100,"icon":101},"Setup","/en/flutter-integration/setup","en/03.flutter-integration/1.setup","i-lucide-wrench",{"title":103,"path":104,"stem":105,"icon":106},"QoraScope","/en/flutter-integration/qora-scope","en/03.flutter-integration/2.qora-scope","i-lucide-share-2",{"title":108,"path":109,"stem":110,"icon":111},"QoraBuilder","/en/flutter-integration/qora-builder","en/03.flutter-integration/3.qora-builder","i-lucide-blocks",{"title":113,"path":114,"stem":115,"icon":116},"QoraMutationBuilder","/en/flutter-integration/qora-mutation-builder","en/03.flutter-integration/4.qora-mutation-builder","i-lucide-pencil",{"title":118,"path":119,"stem":120,"icon":121},"InfiniteQueryBuilder","/en/flutter-integration/infinite-query-builder","en/03.flutter-integration/5.infinite-query-builder","i-lucide-infinity",{"title":123,"path":124,"stem":125,"icon":126},"Hooks (flutter_hooks)","/en/flutter-integration/hooks","en/03.flutter-integration/6.hooks","i-lucide-anchor",{"title":128,"path":129,"stem":130,"icon":131},"Network Status Widgets","/en/flutter-integration/network-status","en/03.flutter-integration/7.network-status","i-lucide-wifi",{"title":133,"path":134,"stem":135,"icon":136},"Best Practices","/en/flutter-integration/best-practices","en/03.flutter-integration/8.best-practices","i-lucide-badge-check",{"title":138,"icon":139,"path":140,"stem":141,"children":142,"page":44},"Recipes","i-lucide-chef-hat","/en/recipes","en/04.recipes",[143,147,152,157,162,166,171,176,181,186,191],{"title":144,"path":145,"stem":146,"icon":85},"Mutations","/en/recipes/mutations","en/04.recipes/02.mutations",{"title":148,"path":149,"stem":150,"icon":151},"Optimistic Updates","/en/recipes/optimistic-updates","en/04.recipes/03.optimistic-updates","i-lucide-zap",{"title":153,"path":154,"stem":155,"icon":156},"Persistence","/en/recipes/persistence","en/04.recipes/04.persistence","i-lucide-hard-drive",{"title":158,"path":159,"stem":160,"icon":161},"Network Aware","/en/recipes/network-aware","en/04.recipes/05.network-aware","i-lucide-signal",{"title":163,"path":164,"stem":165,"icon":121},"Infinite Queries","/en/recipes/infinite-queries","en/04.recipes/06.infinite-queries",{"title":167,"path":168,"stem":169,"icon":170},"Dependent Queries","/en/recipes/dependent-queries","en/04.recipes/07.dependent-queries","i-lucide-link-2",{"title":172,"path":173,"stem":174,"icon":175},"Cancellation","/en/recipes/cancel-token","en/04.recipes/08.cancel-token","i-lucide-circle-slash",{"title":177,"path":178,"stem":179,"icon":180},"SSR Hydration","/en/recipes/ssr-hydration","en/04.recipes/09.ssr-hydration","i-lucide-server",{"title":182,"path":183,"stem":184,"icon":185},"Error Handling","/en/recipes/error-handling","en/04.recipes/10.error-handling","i-lucide-shield-alert",{"title":187,"path":188,"stem":189,"icon":190},"Testing","/en/recipes/testing","en/04.recipes/11.testing","i-lucide-flask-conical",{"title":192,"path":193,"stem":194},"Route-Level Prefetching","/en/recipes/prefetch","en/04.recipes/12.prefetch",{"title":196,"icon":197,"path":198,"stem":199,"children":200,"page":44},"API Reference","i-lucide-file-code","/en/api-reference","en/05.api-reference",[201,206,210,214,219,224,228,232],{"title":202,"path":203,"stem":204,"icon":205},"QoraClient","/en/api-reference/qora-client","en/05.api-reference/1.qora-client","i-lucide-cpu",{"title":207,"path":208,"stem":209,"icon":60},"QoraKey","/en/api-reference/qora-key","en/05.api-reference/2.qora-key",{"title":211,"path":212,"stem":213,"icon":65},"QoraState","/en/api-reference/qora-state","en/05.api-reference/3.qora-state",{"title":215,"path":216,"stem":217,"icon":218},"QoraOptions","/en/api-reference/qora-options","en/05.api-reference/4.qora-options","i-lucide-sliders-horizontal",{"title":220,"path":221,"stem":222,"icon":223},"QoraClientConfig","/en/api-reference/qora-client-config","en/05.api-reference/5.qora-client-config","i-lucide-settings-2",{"title":225,"path":226,"stem":227,"icon":85},"Mutation API","/en/api-reference/qora-mutation","en/05.api-reference/6.qora-mutation",{"title":229,"path":230,"stem":231,"icon":156},"PersistQoraClient","/en/api-reference/persist-qora-client","en/05.api-reference/7.persist-qora-client",{"title":233,"path":234,"stem":235,"icon":121},"Infinite Query","/en/api-reference/infinite-query","en/05.api-reference/8.infinite-query",{"title":237,"icon":238,"path":239,"stem":240,"children":241,"page":44},"DevTools","i-lucide-bug","/en/devtools","en/06.devtools",[242,247,252],{"title":243,"path":244,"stem":245,"icon":246},"Overview","/en/devtools/overview","en/06.devtools/1.overview","i-lucide-layout-dashboard",{"title":248,"path":249,"stem":250,"icon":251},"In-App Overlay","/en/devtools/overlay","en/06.devtools/2.overlay","i-lucide-layers",{"title":253,"path":254,"stem":255,"icon":256},"Data Serialization","/en/devtools/data-display","en/06.devtools/4.data-display","i-lucide-eye",{"title":258,"icon":259,"path":260,"stem":261,"children":262,"page":44},"Third Party","i-lucide-puzzle","/en/third-party","en/07.third-party",[263,268,272,277,282,286],{"title":264,"path":265,"stem":266,"icon":267},"With Provider","/en/third-party/with-provider","en/07.third-party/1.with-provider","i-lucide-plug",{"title":269,"path":270,"stem":271,"icon":111},"With BLoC","/en/third-party/with-bloc","en/07.third-party/2.with-bloc",{"title":273,"path":274,"stem":275,"icon":276},"With Riverpod","/en/third-party/with-riverpod","en/07.third-party/3.with-riverpod","i-lucide-droplets",{"title":278,"path":279,"stem":280,"icon":281},"With RxDart","/en/third-party/with-rxdart","en/07.third-party/4.with-rxdart","i-lucide-git-branch",{"title":283,"path":284,"stem":285},"With Dio","/en/third-party/with-dio","en/07.third-party/5.with-dio",{"title":287,"path":288,"stem":289,"icon":290},"With GraphQL","/en/third-party/with-graphql","en/07.third-party/6.with-graphql","i-lucide-binary",{"title":292,"icon":190,"path":293,"stem":294,"children":295,"page":44},"Examples","/en/examples","en/08.examples",[296,301,305,310,314,318,322],{"title":297,"path":298,"stem":299,"icon":300},"Case Study: User List & Detail","/en/examples/basic-query","en/08.examples/1.basic-query","i-lucide-play-circle",{"title":302,"path":303,"stem":304,"icon":151},"Case Study: Optimistic Mutations & Rollback","/en/examples/mutations-optimistic","en/08.examples/2.mutations-optimistic",{"title":306,"path":307,"stem":308,"icon":309},"Case Study: Infinite Scroll Feed","/en/examples/infinite-scroll","en/08.examples/3.infinite-scroll","i-lucide-scroll",{"title":311,"path":312,"stem":313,"icon":90},"Case Study: Offline-First Todo App","/en/examples/offline-first","en/08.examples/4.offline-first",{"title":315,"path":316,"stem":317,"icon":161},"Case Study: Network Awareness","/en/examples/network-awareness","en/08.examples/5.network-awareness",{"title":319,"path":320,"stem":321,"icon":126},"Case Study: Hooks Integration","/en/examples/hooks-integration","en/08.examples/6.hooks-integration",{"title":323,"path":324,"stem":325,"icon":326},"Case Study: Complete Todo App","/en/examples/complete-todo-app","en/08.examples/7.complete-todo-app","i-lucide-check-square",{"title":328,"icon":329,"path":330,"stem":331,"children":332,"page":44},"Help","i-lucide-life-buoy","/en/help","en/09.help",[333,338],{"title":334,"path":335,"stem":336,"icon":337},"FAQ","/en/help/faq","en/09.help/1.faq","i-lucide-circle-help",{"title":339,"path":340,"stem":341,"icon":101},"Troubleshooting","/en/help/troubleshooting","en/09.help/2.troubleshooting",{"id":343,"title":35,"body":344,"description":1955,"extension":1956,"links":1957,"meta":1958,"navigation":1959,"path":36,"seo":1960,"stem":37,"__hash__":1961},"docs_en/en/01.getting-started/7.migrating-from-other-libraries.md",{"type":345,"value":346,"toc":1941},"minimark",[347,370,380,385,391,506,509,513,530,535,719,743,747,756,1141,1145,1352,1354,1358,1373,1376,1599,1603,1608,1734,1738,1773,1775,1779,1789,1929,1937],[348,349,350,351,361,362,369],"p",{},"This guide maps the concepts of ",[352,353,357],"a",{"href":354,"rel":355},"https://pub.dev/packages/flutter_query",[356],"nofollow",[358,359,360],"code",{},"flutter_query"," and ",[352,363,366],{"href":364,"rel":365},"https://pub.dev/packages/cached_query",[356],[358,367,368],{},"cached_query"," to Qora. Both libraries are solid; the goal here is not to criticise them but to make a migration predictable.",[371,372,373,374,376,377,379],"note",{},"API details for the other libraries were checked against ",[358,375,360],{}," 0.11 and ",[358,378,368],{}," 3.7. If you are on a different version, double-check names against their own documentation.",[381,382,384],"h2",{"id":383},"migrate-incrementally","Migrate incrementally",[348,386,387,388,390],{},"You do not need a big-bang rewrite. A ",[358,389,103],{}," can live next to another provider, so you can migrate one screen or one feature at a time:",[392,393,398],"pre",{"className":394,"code":395,"language":396,"meta":397,"style":397},"language-dart shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","void main() {\n  runApp(\n    QoraScope.auto(\n      client: QoraClient(),\n      child: const MyApp(), // existing providers can stay inside\n    ),\n  );\n}\n","dart","",[358,399,400,417,426,442,460,483,491,500],{"__ignoreMap":397},[401,402,405,409,413],"span",{"class":403,"line":404},"line",1,[401,406,408],{"class":407},"spNyl","void",[401,410,412],{"class":411},"s2Zo4"," main",[401,414,416],{"class":415},"sTEyZ","() {\n",[401,418,420,423],{"class":403,"line":419},2,[401,421,422],{"class":411},"  runApp",[401,424,425],{"class":415},"(\n",[401,427,429,433,437,440],{"class":403,"line":428},3,[401,430,432],{"class":431},"sBMFI","    QoraScope",[401,434,436],{"class":435},"sMK4o",".",[401,438,439],{"class":411},"auto",[401,441,425],{"class":415},[401,443,445,448,451,454,457],{"class":403,"line":444},4,[401,446,447],{"class":415},"      client",[401,449,450],{"class":435},":",[401,452,453],{"class":431}," QoraClient",[401,455,456],{"class":415},"()",[401,458,459],{"class":435},",\n",[401,461,463,466,468,471,474,476,479],{"class":403,"line":462},5,[401,464,465],{"class":415},"      child",[401,467,450],{"class":435},[401,469,470],{"class":407}," const",[401,472,473],{"class":431}," MyApp",[401,475,456],{"class":415},[401,477,478],{"class":435},",",[401,480,482],{"class":481},"sHwdD"," // existing providers can stay inside\n",[401,484,486,489],{"class":403,"line":485},6,[401,487,488],{"class":415},"    )",[401,490,459],{"class":435},[401,492,494,497],{"class":403,"line":493},7,[401,495,496],{"class":415},"  )",[401,498,499],{"class":435},";\n",[401,501,503],{"class":403,"line":502},8,[401,504,505],{"class":415},"}\n",[507,508],"hr",{},[381,510,512],{"id":511},"from-flutter_query","From flutter_query",[348,514,515,517,518,521,522,529],{},[358,516,360],{}," is hook-based (",[358,519,520],{},"flutter_hooks",") and follows TanStack Query closely. The fastest path is ",[352,523,526],{"href":524,"rel":525},"https://pub.dev/packages/qora_hooks",[356],[358,527,528],{},"qora_hooks",", which keeps the same hook style.",[531,532,534],"h3",{"id":533},"concept-mapping","Concept mapping",[536,537,538,553],"table",{},[539,540,541],"thead",{},[542,543,544,548,550],"tr",{},[545,546,547],"th",{},"Concept",[545,549,360],{},[545,551,552],{},"Qora",[554,555,556,572,587,600,618,633,648,670,685,700],"tbody",{},[542,557,558,562,567],{},[559,560,561],"td",{},"Provider",[559,563,564],{},[358,565,566],{},"QueryClientProvider(client: QueryClient())",[559,568,569],{},[358,570,571],{},"QoraScope(client: QoraClient())",[542,573,574,577,582],{},[559,575,576],{},"Query (hooks)",[559,578,579],{},[358,580,581],{},"useQuery(key, (context) => fn())",[559,583,584],{},[358,585,586],{},"useQuery(key: key, fetcher: fn)",[542,588,589,592,595],{},[559,590,591],{},"Query (widget)",[559,593,594],{},"not provided",[559,596,597],{},[358,598,599],{},"QoraBuilder\u003CT>",[542,601,602,605,610],{},[559,603,604],{},"Mutation",[559,606,607],{},[358,608,609],{},"useMutation((vars, context) => fn(vars))",[559,611,612,615,616],{},[358,613,614],{},"useMutation(mutator: fn)"," or ",[358,617,113],{},[542,619,620,623,628],{},[559,621,622],{},"Freshness window",[559,624,625],{},[358,626,627],{},"staleDuration",[559,629,630],{},[358,631,632],{},"QoraOptions.staleTime",[542,634,635,638,643],{},[559,636,637],{},"Inactive cache retention",[559,639,640],{},[358,641,642],{},"gcDuration",[559,644,645],{},[358,646,647],{},"QoraOptions.gcTime",[542,649,650,653,662],{},[559,651,652],{},"Placeholder / seed",[559,654,655,658,659],{},[358,656,657],{},"placeholder",", ",[358,660,661],{},"seed",[559,663,664,658,667],{},[358,665,666],{},"placeholderData",[358,668,669],{},"initialData",[542,671,672,675,680],{},[559,673,674],{},"Invalidate (prefix, default)",[559,676,677],{},[358,678,679],{},"client.invalidateQueries(queryKey: ['todos'])",[559,681,682],{},[358,683,684],{},"client.invalidatePrefix(['todos'])",[542,686,687,690,695],{},[559,688,689],{},"Invalidate (exact)",[559,691,692],{},[358,693,694],{},"invalidateQueries(queryKey: k, exact: true)",[559,696,697],{},[358,698,699],{},"client.invalidate(k)",[542,701,702,705,713],{},[559,703,704],{},"Read / write cache",[559,706,707,658,710],{},[358,708,709],{},"getQueryData",[358,711,712],{},"setQueryData",[559,714,715,658,717],{},[358,716,709],{},[358,718,712],{},[720,721,722,725,726,730,731,734,735,738,739,742],"warning",{},[358,723,724],{},"flutter_query.invalidateQueries"," matches by ",[727,728,729],"strong",{},"prefix"," by default. Qora's ",[358,732,733],{},"invalidate(key)"," is ",[727,736,737],{},"exact",". Use ",[358,740,741],{},"invalidatePrefix"," where you relied on the default behaviour.",[531,744,746],{"id":745},"reading-state","Reading state",[348,748,749,751,752,755],{},[358,750,360],{}," exposes boolean flags on a result object. Qora returns a sealed ",[358,753,754],{},"QoraState\u003CT>",", so the compiler checks that you handle every case, and stale data stays available during refetches and failures:",[392,757,759],{"className":394,"code":758,"language":396,"meta":397,"style":397},"// flutter_query\nfinal result = useQuery(const ['user'], (context) => api.getUser());\nif (result.isLoading) return const CircularProgressIndicator();\nif (result.isError) return Text('Error: ${result.error}');\nreturn UserCard(result.data!);\n\n// Qora (qora_hooks)\nfinal state = useQuery\u003CUser>(key: const ['user'], fetcher: api.getUser);\nreturn switch (state) {\n  Success(:final data) => UserCard(data),\n  Failure(:final error, :final previousData) =>\n    previousData != null ? UserCard(previousData) : Text('Error: $error'),\n  Loading(:final previousData) =>\n    previousData != null ? UserCard(previousData) : const CircularProgressIndicator(),\n  Initial() => const SizedBox.shrink(),\n};\n",[358,760,761,766,817,843,887,909,915,920,966,977,1001,1029,1068,1084,1109,1134],{"__ignoreMap":397},[401,762,763],{"class":403,"line":404},[401,764,765],{"class":481},"// flutter_query\n",[401,767,768,771,774,777,780,783,786,789,793,796,798,801,804,807,809,812,815],{"class":403,"line":419},[401,769,770],{"class":407},"final",[401,772,773],{"class":415}," result ",[401,775,776],{"class":435},"=",[401,778,779],{"class":411}," useQuery",[401,781,782],{"class":415},"(",[401,784,785],{"class":407},"const",[401,787,788],{"class":415}," [",[401,790,792],{"class":791},"sfazB","'user'",[401,794,795],{"class":415},"]",[401,797,478],{"class":435},[401,799,800],{"class":415}," (context) ",[401,802,803],{"class":435},"=>",[401,805,806],{"class":415}," api",[401,808,436],{"class":435},[401,810,811],{"class":411},"getUser",[401,813,814],{"class":415},"())",[401,816,499],{"class":435},[401,818,819,823,826,828,831,834,836,839,841],{"class":403,"line":428},[401,820,822],{"class":821},"s7zQu","if",[401,824,825],{"class":415}," (result",[401,827,436],{"class":435},[401,829,830],{"class":415},"isLoading) ",[401,832,833],{"class":821},"return",[401,835,470],{"class":407},[401,837,838],{"class":431}," CircularProgressIndicator",[401,840,456],{"class":415},[401,842,499],{"class":435},[401,844,845,847,849,851,854,856,859,861,864,867,871,873,876,879,882,885],{"class":403,"line":444},[401,846,822],{"class":821},[401,848,825],{"class":415},[401,850,436],{"class":435},[401,852,853],{"class":415},"isError) ",[401,855,833],{"class":821},[401,857,858],{"class":431}," Text",[401,860,782],{"class":415},[401,862,863],{"class":791},"'Error: ",[401,865,866],{"class":415},"${",[401,868,870],{"class":869},"sHdIc","result",[401,872,436],{"class":415},[401,874,875],{"class":869},"error",[401,877,878],{"class":415},"}",[401,880,881],{"class":791},"'",[401,883,884],{"class":415},")",[401,886,499],{"class":435},[401,888,889,891,894,897,899,902,905,907],{"class":403,"line":462},[401,890,833],{"class":821},[401,892,893],{"class":431}," UserCard",[401,895,896],{"class":415},"(result",[401,898,436],{"class":435},[401,900,901],{"class":415},"data",[401,903,904],{"class":435},"!",[401,906,884],{"class":415},[401,908,499],{"class":435},[401,910,911],{"class":403,"line":485},[401,912,914],{"emptyLinePlaceholder":913},true,"\n",[401,916,917],{"class":403,"line":493},[401,918,919],{"class":481},"// Qora (qora_hooks)\n",[401,921,922,924,927,929,931,934,937,940,942,944,946,948,950,952,955,957,959,961,964],{"class":403,"line":502},[401,923,770],{"class":407},[401,925,926],{"class":415}," state ",[401,928,776],{"class":435},[401,930,779],{"class":411},[401,932,933],{"class":415},"\u003C",[401,935,936],{"class":431},"User",[401,938,939],{"class":415},">(key",[401,941,450],{"class":435},[401,943,470],{"class":407},[401,945,788],{"class":415},[401,947,792],{"class":791},[401,949,795],{"class":415},[401,951,478],{"class":435},[401,953,954],{"class":415}," fetcher",[401,956,450],{"class":435},[401,958,806],{"class":415},[401,960,436],{"class":435},[401,962,963],{"class":415},"getUser)",[401,965,499],{"class":435},[401,967,969,971,974],{"class":403,"line":968},9,[401,970,833],{"class":821},[401,972,973],{"class":821}," switch",[401,975,976],{"class":415}," (state) {\n",[401,978,980,983,985,987,989,992,994,996,999],{"class":403,"line":979},10,[401,981,982],{"class":431},"  Success",[401,984,782],{"class":415},[401,986,450],{"class":435},[401,988,770],{"class":407},[401,990,991],{"class":415}," data) ",[401,993,803],{"class":435},[401,995,893],{"class":431},[401,997,998],{"class":415},"(data)",[401,1000,459],{"class":435},[401,1002,1004,1007,1009,1011,1013,1016,1018,1021,1023,1026],{"class":403,"line":1003},11,[401,1005,1006],{"class":431},"  Failure",[401,1008,782],{"class":415},[401,1010,450],{"class":435},[401,1012,770],{"class":407},[401,1014,1015],{"class":415}," error",[401,1017,478],{"class":435},[401,1019,1020],{"class":435}," :",[401,1022,770],{"class":407},[401,1024,1025],{"class":415}," previousData) ",[401,1027,1028],{"class":435},"=>\n",[401,1030,1032,1035,1038,1041,1044,1046,1049,1051,1053,1055,1057,1060,1062,1064,1066],{"class":403,"line":1031},12,[401,1033,1034],{"class":415},"    previousData ",[401,1036,1037],{"class":435},"!=",[401,1039,1040],{"class":435}," null",[401,1042,1043],{"class":435}," ?",[401,1045,893],{"class":431},[401,1047,1048],{"class":415},"(previousData) ",[401,1050,450],{"class":435},[401,1052,858],{"class":431},[401,1054,782],{"class":415},[401,1056,863],{"class":791},[401,1058,1059],{"class":415},"$",[401,1061,875],{"class":869},[401,1063,881],{"class":791},[401,1065,884],{"class":415},[401,1067,459],{"class":435},[401,1069,1071,1074,1076,1078,1080,1082],{"class":403,"line":1070},13,[401,1072,1073],{"class":431},"  Loading",[401,1075,782],{"class":415},[401,1077,450],{"class":435},[401,1079,770],{"class":407},[401,1081,1025],{"class":415},[401,1083,1028],{"class":435},[401,1085,1087,1089,1091,1093,1095,1097,1099,1101,1103,1105,1107],{"class":403,"line":1086},14,[401,1088,1034],{"class":415},[401,1090,1037],{"class":435},[401,1092,1040],{"class":435},[401,1094,1043],{"class":435},[401,1096,893],{"class":431},[401,1098,1048],{"class":415},[401,1100,450],{"class":435},[401,1102,470],{"class":407},[401,1104,838],{"class":431},[401,1106,456],{"class":415},[401,1108,459],{"class":435},[401,1110,1112,1115,1118,1120,1122,1125,1127,1130,1132],{"class":403,"line":1111},15,[401,1113,1114],{"class":431},"  Initial",[401,1116,1117],{"class":415},"() ",[401,1119,803],{"class":435},[401,1121,470],{"class":407},[401,1123,1124],{"class":431}," SizedBox",[401,1126,436],{"class":435},[401,1128,1129],{"class":411},"shrink",[401,1131,456],{"class":415},[401,1133,459],{"class":435},[401,1135,1137,1139],{"class":403,"line":1136},16,[401,1138,878],{"class":415},[401,1140,499],{"class":435},[531,1142,1144],{"id":1143},"mutations-and-invalidation","Mutations and invalidation",[392,1146,1148],{"className":394,"code":1147,"language":396,"meta":397,"style":397},"// flutter_query\nfinal mutation = useMutation\u003CTodo, Exception, String, void>(\n  (title, context) => api.createTodo(title),\n  onSuccess: (data, variables, onMutateResult, context) {\n    // invalidate ['todos'] through the QueryClient\n  },\n);\n\n// Qora: declare what to refresh, no manual callback needed\nfinal mutation = useMutation\u003CTodo, String>(\n  mutator: api.createTodo,\n  options: const MutationOptions(invalidates: [['todos']]),\n);\nmutation.mutate('Buy milk');\n",[358,1149,1150,1154,1188,1212,1237,1242,1249,1255,1259,1264,1284,1299,1327,1333],{"__ignoreMap":397},[401,1151,1152],{"class":403,"line":404},[401,1153,765],{"class":481},[401,1155,1156,1158,1161,1163,1166,1168,1171,1173,1176,1178,1181,1183,1185],{"class":403,"line":419},[401,1157,770],{"class":407},[401,1159,1160],{"class":415}," mutation ",[401,1162,776],{"class":435},[401,1164,1165],{"class":411}," useMutation",[401,1167,933],{"class":415},[401,1169,1170],{"class":431},"Todo",[401,1172,658],{"class":415},[401,1174,1175],{"class":431},"Exception",[401,1177,658],{"class":415},[401,1179,1180],{"class":431},"String",[401,1182,658],{"class":415},[401,1184,408],{"class":407},[401,1186,1187],{"class":415},">(\n",[401,1189,1190,1193,1195,1198,1200,1202,1204,1207,1210],{"class":403,"line":428},[401,1191,1192],{"class":415},"  (title",[401,1194,478],{"class":435},[401,1196,1197],{"class":415}," context) ",[401,1199,803],{"class":435},[401,1201,806],{"class":415},[401,1203,436],{"class":435},[401,1205,1206],{"class":411},"createTodo",[401,1208,1209],{"class":415},"(title)",[401,1211,459],{"class":435},[401,1213,1214,1217,1219,1222,1224,1227,1229,1232,1234],{"class":403,"line":444},[401,1215,1216],{"class":415},"  onSuccess",[401,1218,450],{"class":435},[401,1220,1221],{"class":415}," (data",[401,1223,478],{"class":435},[401,1225,1226],{"class":415}," variables",[401,1228,478],{"class":435},[401,1230,1231],{"class":415}," onMutateResult",[401,1233,478],{"class":435},[401,1235,1236],{"class":415}," context) {\n",[401,1238,1239],{"class":403,"line":462},[401,1240,1241],{"class":481},"    // invalidate ['todos'] through the QueryClient\n",[401,1243,1244,1247],{"class":403,"line":485},[401,1245,1246],{"class":415},"  }",[401,1248,459],{"class":435},[401,1250,1251,1253],{"class":403,"line":493},[401,1252,884],{"class":415},[401,1254,499],{"class":435},[401,1256,1257],{"class":403,"line":502},[401,1258,914],{"emptyLinePlaceholder":913},[401,1260,1261],{"class":403,"line":968},[401,1262,1263],{"class":481},"// Qora: declare what to refresh, no manual callback needed\n",[401,1265,1266,1268,1270,1272,1274,1276,1278,1280,1282],{"class":403,"line":979},[401,1267,770],{"class":407},[401,1269,1160],{"class":415},[401,1271,776],{"class":435},[401,1273,1165],{"class":411},[401,1275,933],{"class":415},[401,1277,1170],{"class":431},[401,1279,658],{"class":415},[401,1281,1180],{"class":431},[401,1283,1187],{"class":415},[401,1285,1286,1289,1291,1293,1295,1297],{"class":403,"line":1003},[401,1287,1288],{"class":415},"  mutator",[401,1290,450],{"class":435},[401,1292,806],{"class":415},[401,1294,436],{"class":435},[401,1296,1206],{"class":415},[401,1298,459],{"class":435},[401,1300,1301,1304,1306,1308,1311,1314,1316,1319,1322,1325],{"class":403,"line":1031},[401,1302,1303],{"class":415},"  options",[401,1305,450],{"class":435},[401,1307,470],{"class":407},[401,1309,1310],{"class":431}," MutationOptions",[401,1312,1313],{"class":415},"(invalidates",[401,1315,450],{"class":435},[401,1317,1318],{"class":415}," [[",[401,1320,1321],{"class":791},"'todos'",[401,1323,1324],{"class":415},"]])",[401,1326,459],{"class":435},[401,1328,1329,1331],{"class":403,"line":1070},[401,1330,884],{"class":415},[401,1332,499],{"class":435},[401,1334,1335,1338,1340,1343,1345,1348,1350],{"class":403,"line":1086},[401,1336,1337],{"class":415},"mutation",[401,1339,436],{"class":435},[401,1341,1342],{"class":411},"mutate",[401,1344,782],{"class":415},[401,1346,1347],{"class":791},"'Buy milk'",[401,1349,884],{"class":415},[401,1351,499],{"class":435},[507,1353],{},[381,1355,1357],{"id":1356},"from-cached_query","From cached_query",[348,1359,1360,1362,1363,1366,1367,1369,1370,436],{},[358,1361,368],{}," is object-based: you create ",[358,1364,1365],{},"Query"," / ",[358,1368,604],{}," instances (often in a repository) and listen to their streams, with Flutter widgets in ",[358,1371,1372],{},"cached_query_flutter",[531,1374,534],{"id":1375},"concept-mapping-1",[536,1377,1378,1388],{},[539,1379,1380],{},[542,1381,1382,1384,1386],{},[545,1383,547],{},[545,1385,368],{},[545,1387,552],{},[554,1389,1390,1405,1419,1443,1458,1472,1488,1508,1528,1543,1563,1581],{},[542,1391,1392,1395,1400],{},[559,1393,1394],{},"Global config",[559,1396,1397],{},[358,1398,1399],{},"CachedQuery.instance.config(...)",[559,1401,1402],{},[358,1403,1404],{},"QoraClient(config: QoraClientConfig(...))",[542,1406,1407,1409,1414],{},[559,1408,1365],{},[559,1410,1411],{},[358,1412,1413],{},"Query(key: 'user', queryFn: fn)",[559,1415,1416],{},[358,1417,1418],{},"client.watchQuery(key: ['user'], fetcher: fn)",[542,1420,1421,1424,1433],{},[559,1422,1423],{},"Stream",[559,1425,1426,1429,1430,884],{},[358,1427,1428],{},"query.stream"," (",[358,1431,1432],{},"QueryStatus",[559,1434,1435,1366,1438,1429,1441,884],{},[358,1436,1437],{},"watchQuery",[358,1439,1440],{},"watchState",[358,1442,211],{},[542,1444,1445,1448,1453],{},[559,1446,1447],{},"One-shot read",[559,1449,1450],{},[358,1451,1452],{},"await query.result",[559,1454,1455],{},[358,1456,1457],{},"await client.fetchQuery(key: ..., fetcher: ...)",[542,1459,1460,1463,1468],{},[559,1461,1462],{},"Widget",[559,1464,1465],{},[358,1466,1467],{},"QueryBuilder",[559,1469,1470],{},[358,1471,599],{},[542,1473,1474,1477,1482],{},[559,1475,1476],{},"Force refetch",[559,1478,1479],{},[358,1480,1481],{},"query.refetch()",[559,1483,1484,1487],{},[358,1485,1486],{},"client.invalidate(key)"," (active watchers refetch)",[542,1489,1490,1493,1498],{},[559,1491,1492],{},"Invalidate many",[559,1494,1495],{},[358,1496,1497],{},"CachedQuery.instance.invalidateCache(...)",[559,1499,1500,658,1502,658,1505],{},[358,1501,741],{},[358,1503,1504],{},"invalidateWhere",[358,1506,1507],{},"invalidateTags",[542,1509,1510,1513,1520],{},[559,1511,1512],{},"Freshness / retention",[559,1514,1515,658,1517],{},[358,1516,627],{},[358,1518,1519],{},"cacheDuration",[559,1521,1522,658,1525],{},[358,1523,1524],{},"staleTime",[358,1526,1527],{},"gcTime",[542,1529,1530,1533,1538],{},[559,1531,1532],{},"Infinite list",[559,1534,1535],{},[358,1536,1537],{},"InfiniteQuery\u003CT, Arg>",[559,1539,1540],{},[358,1541,1542],{},"InfiniteQueryBuilder\u003CTData, TPageParam>",[542,1544,1545,1547,1552],{},[559,1546,604],{},[559,1548,1549],{},[358,1550,1551],{},"Mutation(mutationFn: fn, invalidateQueries: [...])",[559,1553,1554,1366,1556,1559,1560],{},[358,1555,113],{},[358,1557,1558],{},"useMutation"," with ",[358,1561,1562],{},"MutationOptions.invalidates",[542,1564,1565,1567,1573],{},[559,1566,153],{},[559,1568,1569,1572],{},[358,1570,1571],{},"cached_storage"," (sqflite)",[559,1574,1575,1577,1578],{},[358,1576,229],{}," + your ",[358,1579,1580],{},"StorageAdapter",[542,1582,1583,1586,1594],{},[559,1584,1585],{},"Refetch on resume / reconnect",[559,1587,1588,658,1591],{},[358,1589,1590],{},"refetchOnResume",[358,1592,1593],{},"refetchOnConnection",[559,1595,1596],{},[358,1597,1598],{},"QoraScope.auto()",[531,1600,1602],{"id":1601},"keys","Keys",[348,1604,1605,1607],{},[358,1606,368],{}," keys are usually strings. Qora keys are lists, which makes prefix and partial invalidation natural:",[392,1609,1611],{"className":394,"code":1610,"language":396,"meta":397,"style":397},"// cached_query\nQuery(key: 'user-$id', queryFn: () => api.getUser(id));\n\n// Qora\nclient.watchQuery(key: ['users', id], fetcher: () => api.getUser(id));\nclient.invalidatePrefix(['users']); // every user query\n",[358,1612,1613,1618,1660,1664,1669,1712],{"__ignoreMap":397},[401,1614,1615],{"class":403,"line":404},[401,1616,1617],{"class":481},"// cached_query\n",[401,1619,1620,1622,1625,1627,1630,1632,1635,1637,1639,1642,1644,1647,1649,1651,1653,1655,1658],{"class":403,"line":419},[401,1621,1365],{"class":431},[401,1623,1624],{"class":415},"(key",[401,1626,450],{"class":435},[401,1628,1629],{"class":791}," 'user-",[401,1631,1059],{"class":415},[401,1633,1634],{"class":869},"id",[401,1636,881],{"class":791},[401,1638,478],{"class":435},[401,1640,1641],{"class":415}," queryFn",[401,1643,450],{"class":435},[401,1645,1646],{"class":415}," () ",[401,1648,803],{"class":435},[401,1650,806],{"class":415},[401,1652,436],{"class":435},[401,1654,811],{"class":411},[401,1656,1657],{"class":415},"(id))",[401,1659,499],{"class":435},[401,1661,1662],{"class":403,"line":428},[401,1663,914],{"emptyLinePlaceholder":913},[401,1665,1666],{"class":403,"line":444},[401,1667,1668],{"class":481},"// Qora\n",[401,1670,1671,1674,1676,1678,1680,1682,1684,1687,1689,1692,1694,1696,1698,1700,1702,1704,1706,1708,1710],{"class":403,"line":462},[401,1672,1673],{"class":415},"client",[401,1675,436],{"class":435},[401,1677,1437],{"class":411},[401,1679,1624],{"class":415},[401,1681,450],{"class":435},[401,1683,788],{"class":415},[401,1685,1686],{"class":791},"'users'",[401,1688,478],{"class":435},[401,1690,1691],{"class":415}," id]",[401,1693,478],{"class":435},[401,1695,954],{"class":415},[401,1697,450],{"class":435},[401,1699,1646],{"class":415},[401,1701,803],{"class":435},[401,1703,806],{"class":415},[401,1705,436],{"class":435},[401,1707,811],{"class":411},[401,1709,1657],{"class":415},[401,1711,499],{"class":435},[401,1713,1714,1716,1718,1720,1723,1725,1728,1731],{"class":403,"line":485},[401,1715,1673],{"class":415},[401,1717,436],{"class":435},[401,1719,741],{"class":411},[401,1721,1722],{"class":415},"([",[401,1724,1686],{"class":791},[401,1726,1727],{"class":415},"])",[401,1729,1730],{"class":435},";",[401,1732,1733],{"class":481}," // every user query\n",[531,1735,1737],{"id":1736},"what-you-gain","What you gain",[1739,1740,1741,1748,1761,1767],"ul",{},[1742,1743,1744,1747],"li",{},[727,1745,1746],{},"Offline mutation queue",": writes made offline are queued and replayed in order on reconnect, with optimistic UI in the meantime.",[1742,1749,1750,1753,1754,1756,1757,1760],{},[727,1751,1752],{},"Two-axis state",": ",[358,1755,211],{}," (data) and ",[358,1758,1759],{},"FetchStatus"," (fetching / paused / idle) are independent, so \"offline with stale data\" is a first-class state.",[1742,1762,1763,1766],{},[727,1764,1765],{},"Tag-based invalidation",": mutations invalidate logical tags instead of hard-coded keys.",[1742,1768,1769,1772],{},[727,1770,1771],{},"In-app DevTools overlay"," to inspect the cache, timelines and mutations.",[507,1774],{},[381,1776,1778],{"id":1777},"error-handling","Error handling",[348,1780,1781,1782,1785,1786,450],{},"Both libraries let you inspect raw errors. In Qora, map them once with ",[358,1783,1784],{},"QoraClientConfig.errorMapper",", which receives the error and its stack trace and returns a ",[358,1787,1788],{},"QoraException",[392,1790,1792],{"className":394,"code":1791,"language":396,"meta":397,"style":397},"import 'package:qora_flutter/qora_flutter.dart';\n\nfinal client = QoraClient(\n  config: QoraClientConfig(\n    errorMapper: (Object error, StackTrace? stackTrace) => error is QoraException\n        ? error\n        : QoraException(error.toString(), originalError: error, stackTrace: stackTrace),\n  ),\n);\n",[358,1793,1794,1805,1809,1822,1834,1870,1878,1917,1923],{"__ignoreMap":397},[401,1795,1796,1800,1803],{"class":403,"line":404},[401,1797,1799],{"class":1798},"sbssI","import",[401,1801,1802],{"class":791}," 'package:qora_flutter/qora_flutter.dart'",[401,1804,499],{"class":435},[401,1806,1807],{"class":403,"line":419},[401,1808,914],{"emptyLinePlaceholder":913},[401,1810,1811,1813,1816,1818,1820],{"class":403,"line":428},[401,1812,770],{"class":407},[401,1814,1815],{"class":415}," client ",[401,1817,776],{"class":435},[401,1819,453],{"class":431},[401,1821,425],{"class":415},[401,1823,1824,1827,1829,1832],{"class":403,"line":444},[401,1825,1826],{"class":415},"  config",[401,1828,450],{"class":435},[401,1830,1831],{"class":431}," QoraClientConfig",[401,1833,425],{"class":415},[401,1835,1836,1839,1841,1843,1846,1848,1850,1853,1856,1859,1861,1864,1867],{"class":403,"line":462},[401,1837,1838],{"class":415},"    errorMapper",[401,1840,450],{"class":435},[401,1842,1429],{"class":415},[401,1844,1845],{"class":431},"Object",[401,1847,1015],{"class":415},[401,1849,478],{"class":435},[401,1851,1852],{"class":431}," StackTrace",[401,1854,1855],{"class":435},"?",[401,1857,1858],{"class":415}," stackTrace) ",[401,1860,803],{"class":435},[401,1862,1863],{"class":415}," error ",[401,1865,1866],{"class":435},"is",[401,1868,1869],{"class":431}," QoraException\n",[401,1871,1872,1875],{"class":403,"line":485},[401,1873,1874],{"class":435},"        ?",[401,1876,1877],{"class":415}," error\n",[401,1879,1880,1883,1886,1889,1891,1894,1896,1898,1901,1903,1905,1907,1910,1912,1915],{"class":403,"line":493},[401,1881,1882],{"class":435},"        :",[401,1884,1885],{"class":431}," QoraException",[401,1887,1888],{"class":415},"(error",[401,1890,436],{"class":435},[401,1892,1893],{"class":411},"toString",[401,1895,456],{"class":415},[401,1897,478],{"class":435},[401,1899,1900],{"class":415}," originalError",[401,1902,450],{"class":435},[401,1904,1015],{"class":415},[401,1906,478],{"class":435},[401,1908,1909],{"class":415}," stackTrace",[401,1911,450],{"class":435},[401,1913,1914],{"class":415}," stackTrace)",[401,1916,459],{"class":435},[401,1918,1919,1921],{"class":403,"line":502},[401,1920,496],{"class":415},[401,1922,459],{"class":435},[401,1924,1925,1927],{"class":403,"line":968},[401,1926,884],{"class":415},[401,1928,499],{"class":435},[348,1930,1931,1932,1936],{},"See ",[352,1933,1935],{"href":1934},"../third-party/with-dio","Dio integration"," for a complete mapper.",[1938,1939,1940],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":397,"searchDepth":419,"depth":419,"links":1942},[1943,1944,1949,1954],{"id":383,"depth":419,"text":384},{"id":511,"depth":419,"text":512,"children":1945},[1946,1947,1948],{"id":533,"depth":428,"text":534},{"id":745,"depth":428,"text":746},{"id":1143,"depth":428,"text":1144},{"id":1356,"depth":419,"text":1357,"children":1950},[1951,1952,1953],{"id":1375,"depth":428,"text":534},{"id":1601,"depth":428,"text":1602},{"id":1736,"depth":428,"text":1737},{"id":1777,"depth":419,"text":1778},"Map flutter_query and cached_query concepts to Qora and migrate one screen at a time.","md",null,{},{"icon":38},{"title":35,"description":1955},"5svEXGb-HNxd7hbZ-NdtLG1-_JZBzeHdUR70ux-D7jc",[1963,1965],{"title":30,"path":31,"stem":32,"description":1964,"icon":33,"children":-1},"A precise mapping of TanStack Query concepts, hooks, and configuration options to their Qora equivalents. Covers what is identical, what is renamed, and what works differently.",{"title":40,"path":41,"stem":42,"description":1966,"icon":43,"children":-1},"Give Claude, Cursor, Copilot or any coding assistant the context it needs to write correct Qora code.",1794040393901]