@navios/react-query 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/query/key-creator.mts","../src/query/make-options.mts","../src/query/make-infinite-options.mts","../src/mutation/key-creator.mts","../src/mutation/make-hook.mts","../src/client/declare-client.mts"],"names":["result","queryOptions","infiniteQueryOptions","useMutation"],"mappings":";;;;AAmBO,SAAS,cAAA,CAOd,MAAA,EACA,OAAA,EACA,WAAA,EASA;AACA,EAAA,MAAM,MAAM,MAAA,CAAO,GAAA;AACnB,EAAA,MAAM,WAAW,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AAC9C,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,QAAA;AAAA;AAAA,IAEV,OAAA,EAAS,CAAC,MAAA,KAAW;AACnB,MAAA,MAAM,WAAA,GACJ,MAAA,IAAU,aAAA,IAAiB,MAAA,IAAU,QAAA,IAAY,MAAA,GAC7C,MAAA,CAAO,WAAA,EAAa,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA,GACvC,EAAC;AACP,MAAA,OAAO;AAAA,QACL,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,GAAG,QAAA,CAAS,GAAA;AAAA,UAAI,CAAC,IAAA,KACf,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA;AAAA;AAAA,YAEf,OAAO,SAAA,CAAU,IAAA,CAAK,MAAM,CAAC,CAAC,EAAE,QAAA;AAAS,cACzC;AAAA,SACN;AAAA,QACA,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,eAAe;AAAC,OAClB;AAAA,IASF,CAAA;AAAA;AAAA,IAEA,SAAA,EAAW,CAAC,MAAA,KAAW;AACrB,MAAA,OAAO;AAAA,QACL,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,GAAG,QAAA,CAAS,GAAA;AAAA,UAAI,CAAC,IAAA,KACf,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA;AAAA;AAAA,YAEf,OAAO,SAAA,CAAU,IAAA,CAAK,MAAM,CAAC,CAAC,EAAE,QAAA;AAAS,cACzC;AAAA,SACN;AAAA,QACA,GAAI,OAAA,CAAQ,SAAA,IAAa;AAAC,OAC5B;AAAA,IASF,CAAA;AAAA,IAEA,SAAA,EAAW,CAAC,MAAA,KAAW;AACrB,MAAA,OAAO,aAAA,CAAmB,GAAA,EAAK,MAAA,IAAW,EAAY,CAAA;AAAA,IACxD;AAAA,GACF;AACF;AAIO,IAAM,eAAA,GAAkB;ACxExB,SAAS,gBAAA,CAcd,QAAA,EACA,OAAA,EACA,SAAA,GAAuB,EAAC,EACxB;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AACxB,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAc,CAAA;AACtD,EAAA,MAAM,kBAAkB,OAAA,CAAQ,eAAA;AAEhC,EAAA,MAAM,MAAA,GAAS,CACb,MAAA,KAQW;AAEX,IAAA,OAAO,YAAA,CAAa;AAAA,MAClB,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAA;AAAA,MACjC,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAuD;AAC9E,QAAA,IAAIA,OAAAA;AACJ,QAAA,IAAI;AACF,UAAAA,OAAAA,GAAS,MAAM,QAAA,CAAS;AAAA,YACtB,MAAA;AAAA,YACA,GAAG;AAAA,WACJ,CAAA;AAAA,QACH,SAAS,GAAA,EAAK;AACZ,UAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,YAAA,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,UACpB;AACA,UAAA,MAAM,GAAA;AAAA,QACR;AAEA,QAAA,OAAO,gBAAgBA,OAAM,CAAA;AAAA,MAC/B,CAAA;AAAA,MACA,GAAG;AAAA,KACJ,CAAA;AAAA,EACH,CAAA;AACA,EAAA,MAAA,CAAO,QAAA,GAAW,QAAA;AAClB,EAAA,MAAA,CAAO,GAAA,GAAM,CAAC,MAAA,KAA4D;AACxE,IAAA,OAAO,QAAA,CAAS,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,EAChC,CAAA;AAEA,EAAA,MAAA,CAAO,WAAA,GAAc,CAAC,MAAA,KAA4D;AAChF,IAAA,OAAO,gBAAA,CAAiB,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,EACxC,CAAA;AAEA,EAAA,MAAA,CAAO,UAAA,GAAa,CAClB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,MAAM;AAAA,KACzC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,MAAA,CAAO,aAAA,GAAgB,CACrB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,MAAM,CAAA;AAAA,MAC1C,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,MAAA;AACT;AC3EO,SAAS,wBAAA,CAad,QAAA,EACA,OAAA,EACA,SAAA,GAAuB,EAAC,EACxB;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AACxB,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAa,CAAA;AAErD,EAAA,MAAM,kBAAkB,OAAA,CAAQ,eAAA;AAChC,EAAA,MAAM,GAAA,GAAM,CACV,MAAA,KASW;AAEX,IAAA,OAAO,oBAAA,CAAqB;AAAA,MAC1B,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAA;AAAA,MACjC,OAAA,EAAS,OAAO,EAAE,MAAA,EAAQ,WAAU,KAAuD;AACzF,QAAA,IAAI,MAAA;AACJ,QAAA,IAAI;AACF,UAAA,MAAA,GAAS,MAAM,QAAA,CAAS;AAAA,YACtB,MAAA;AAAA;AAAA,YAEA,WAAW,MAAA,CAAO,SAAA;AAAA,YAClB,MAAA,EAAQ;AAAA,cACN,GAAI,QAAA,IAAY,MAAA,GAAS,MAAA,CAAO,SAAS,EAAC;AAAA,cAC1C,GAAI;AAAA;AACN,WACD,CAAA;AAAA,QACH,SAAS,GAAA,EAAK;AACZ,UAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,YAAA,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,UACpB;AACA,UAAA,MAAM,GAAA;AAAA,QACR;AAEA,QAAA,OAAO,gBAAgB,MAAM,CAAA;AAAA,MAC/B,CAAA;AAAA,MACA,kBAAkB,OAAA,CAAQ,gBAAA;AAAA,MAC1B,sBAAsB,OAAA,CAAQ,oBAAA;AAAA,MAC9B,gBAAA,EACE,OAAA,CAAQ,gBAAA,IACR,MAAA,CAAO,WAAA,CAAY,KAAA,CAAM,QAAA,IAAY,MAAA,GAAS,MAAA,CAAO,MAAA,GAAS,EAAE,CAAA;AAAA,MAClE,GAAG;AAAA,KACJ,CAAA;AAAA,EACH,CAAA;AACA,EAAA,GAAA,CAAI,QAAA,GAAW,QAAA;AAEf,EAAA,GAAA,CAAI,GAAA,GAAM,CAAC,MAAA,KAA4D;AACrE,IAAA,OAAO,gBAAA,CAAiB,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,EACrC,CAAA;AAEA,EAAA,GAAA,CAAI,WAAA,GAAc,CAAC,MAAA,KAA4D;AAC7E,IAAA,OAAO,wBAAA,CAAyB,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,EAC7C,CAAA;AAEA,EAAA,GAAA,CAAI,UAAA,GAAa,CACf,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,OAAA,CAAQ,MAAM;AAAA,KACtC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,GAAA,CAAI,aAAA,GAAgB,CAClB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,SAAA,CAAU,MAAM,CAAA;AAAA,MACvC,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,GAAA;AACT;;;AC1FO,SAAS,iBAAA,CAMd,QACA,OAAA,GAAmB;AAAA,EACjB,eAAA,EAAiB,CAAC,IAAA,KAAS;AAC7B,CAAA,EAKQ;AACR,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAc,CAAA;AAGtD,EAAA,OAAO,CAAC,MAAA,KAAW;AACjB,IAAA,OAAO,QAAA,CAAS,UAAU,MAAM,CAAA;AAAA,EAClC,CAAA;AACF;AAIO,IAAM,kBAAA,GAAqB;ACjC3B,SAAS,YAAA,CAQd,UACA,OAAA,EAQA;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AAExB,EAAA,MAAM,WAAA,GAAc,iBAAA,CAAkB,MAAA,EAAQ,OAAO,CAAA;AACrD,EAAA,MAAM,MAAA,GAAS,CACb,SAAA,KAK8D;AAC9D,IAAA,MAAM,cAAc,cAAA,EAAe;AACnC,IAAA,MAAM;AAAA,MACJ,MAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAA;AAAA,MACA,SAAA;AAAA,MACA,SAAA,EAAW,UAAA;AAAA,MACX,SAAA,EAAW,UAAA;AAAA,MACX,eAAA;AAAA,MACA,GAAG;AAAA,KACL,GAAI,OAAA;AAEJ,IAAA,MAAM,UAAU,UAAA,IAAa;AAG7B,IAAA,OAAO,WAAA;AAAA,MACL;AAAA,QACE,GAAG,IAAA;AAAA,QACH,WAAA,EAAa,SACT,WAAA,CAAY;AAAA,UACV,SAAA,EAAW;AAAA,SACZ,CAAA,GACD,MAAA;AAAA,QACJ,OAAO,MAAA,GACH;AAAA,UACE,IAAI,IAAA,CAAK,SAAA;AAAA,YACP,WAAA,CAAY;AAAA,cACV,SAAA,EAAW;AAAA,aACZ;AAAA;AACH,SACF,GACA,MAAA;AAAA,QACJ,MAAM,WAAW,MAAA,EAAoB;AACnC,UAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,MAAM,CAAA;AAEtC,UAAA,OAAO,gBAAgB,QAAQ,CAAA;AAAA,QACjC,CAAA;AAAA,QACA,SAAA,EAAW,SAAA,GACP,CAAC,IAAA,EAAa,SAAA,KAA0B;AACtC,UAAA,OAAO,SAAA,GAAY,WAAA,EAAa,IAAA,EAAM,SAAA,EAAW,OAAO,CAAA;AAAA,QAC1D,CAAA,GACA,MAAA;AAAA,QACJ,OAAA,EAAS,OAAA,GACL,CAAC,GAAA,EAAY,SAAA,KAA0B;AACrC,UAAA,OAAO,OAAA,GAAU,WAAA,EAAa,GAAA,EAAK,SAAA,EAAW,OAAO,CAAA;AAAA,QACvD,CAAA,GACA;AAAA,OACN;AAAA,MACA;AAAA,KACF;AAAA,EACF,CAAA;AACA,EAAA,MAAA,CAAO,aAAA,GAAgB,CACrB,SAAA,KAKY;AACZ,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,aAAa,aAAA,CAAc;AAAA,MAC/B,aAAa,WAAA,CAAY;AAAA,QACvB,SAAA,EAAW;AAAA,OACZ;AAAA,KACF,CAAA;AACD,IAAA,OAAO,UAAA,GAAa,CAAA;AAAA,EACtB,CAAA;AACA,EAAA,MAAA,CAAO,WAAA,GAAc,WAAA;AAErB,EAAA,OAAO,MAAA;AACT;;;ACDO,SAAS,aAAA,CAA6C;AAAA,EAC3D,GAAA;AAAA,EACA,WAAW;AACb,CAAA,EAA4B;AAC1B,EAAA,SAAS,MAAM,MAAA,EAAqB;AAClC,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMC,aAAAA,GAAe,iBAAiB,QAAA,EAAU;AAAA,MAC9C,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA;AAAA,KACvD,CAAA;AAED,IAAAA,cAAa,QAAA,GAAW,QAAA;AACxB,IAAA,OAAOA,aAAAA;AAAA,EACT;AAEA,EAAA,SAAS,iBAAA,CACP,UACA,OAAA,EAKA;AACA,IAAA,OAAO,iBAAiB,QAAA,EAAU;AAAA,MAChC,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,OAAA,EAAS,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA;AAAA,KACzD,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,cAAc,MAAA,EAA6B;AAClD,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AACD,IAAA,MAAMC,qBAAAA,GAAuB,yBAAyB,QAAA,EAAU;AAAA,MAC9D,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,kBAAkB,MAAA,CAAO,gBAAA;AAAA,MACzB,sBAAsB,MAAA,CAAO,oBAAA;AAAA,MAC7B,kBAAkB,MAAA,CAAO;AAAA,KAC1B,CAAA;AAGD,IAAAA,sBAAqB,QAAA,GAAW,QAAA;AAChC,IAAA,OAAOA,qBAAAA;AAAA,EACT;AAEA,EAAA,SAAS,yBAAA,CACP,UACA,OAAA,EAkBA;AACA,IAAA,OAAO,yBAAyB,QAAA,EAAU;AAAA,MACxC,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,OAAA,EAAS,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACxD,kBAAkB,OAAA,CAAQ,gBAAA;AAAA,MAC1B,sBAAsB,OAAA,EAAS,oBAAA;AAAA,MAC/B,kBAAkB,OAAA,EAAS;AAAA,KAC5B,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,SAAS,MAAA,EAAwB;AACxC,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMC,YAAAA,GAAc,aAAa,QAAA,EAAU;AAAA,MACzC,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,YAAY,MAAA,CAAO,UAAA;AAAA;AAAA,MAEnB,WAAW,MAAA,CAAO,SAAA;AAAA;AAAA,MAElB,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,GAAG;AAAA,KACJ,CAAA;AAGD,IAAAA,aAAY,QAAA,GAAW,QAAA;AACvB,IAAA,OAAOA,YAAAA;AAAA,EACT;AAEA,EAAA,SAAS,oBAAA,CACP,UACA,OAAA,EAgBA;AACA,IAAA,OAAO,aAAa,QAAA,EAAU;AAAA,MAC5B,iBAAiB,OAAA,CAAQ,eAAA;AAAA,MACzB,YAAY,OAAA,CAAQ,UAAA;AAAA,MACpB,WAAW,OAAA,CAAQ,SAAA;AAAA;AAAA,MAEnB,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,kBAAkB,MAAA,EAAwB;AACjD,IAAA,MAAM,QAAA,GAAW,IAAI,gBAAA,CAAiB;AAAA;AAAA,MAEpC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMA,YAAAA,GAAc,aAAa,QAAA,EAAU;AAAA,MACzC,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,YAAY,MAAA,CAAO,UAAA;AAAA;AAAA,MAEnB,WAAW,MAAA,CAAO,SAAA;AAAA;AAAA,MAElB,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,GAAG;AAAA,KACJ,CAAA;AAGD,IAAAA,aAAY,QAAA,GAAW,QAAA;AACvB,IAAA,OAAOA,YAAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,KAAA;AAAA;AAAA,IAEA,iBAAA;AAAA;AAAA,IAEA,aAAA;AAAA;AAAA,IAEA,yBAAA;AAAA;AAAA,IAEA,QAAA;AAAA;AAAA,IAEA,oBAAA;AAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import type { AnyEndpointConfig, UrlHasParams } from '@navios/builder'\nimport type { DataTag, InfiniteData } from '@tanstack/react-query'\n\nimport { bindUrlParams } from '@navios/builder'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryKeyCreatorResult, QueryParams } from './types.mjs'\n\n/**\n * Creates a query key generator for a given endpoint configuration.\n *\n * The returned object provides methods to generate query keys that can be used\n * with TanStack Query for caching, invalidation, and data tagging.\n *\n * @param config - The endpoint configuration\n * @param options - Query parameters including processResponse and key prefix/suffix\n * @param isInfinite - Whether this is for an infinite query\n * @returns An object with methods to generate query keys\n */\nexport function createQueryKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n IsInfinite extends boolean,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options,\n _isInfinite: IsInfinite,\n): QueryKeyCreatorResult<\n Config['querySchema'],\n Url,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? Result\n : never,\n IsInfinite,\n HasParams\n> {\n const url = config.url as Url\n const urlParts = url.split('/').filter(Boolean) as Split<Url, '/'>\n return {\n template: urlParts,\n // @ts-expect-error We have correct types in return type\n dataTag: (params) => {\n const queryParams =\n params && 'querySchema' in config && 'params' in params\n ? config.querySchema?.parse(params.params)\n : []\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n queryParams ?? [],\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n // @ts-expect-error We have correct types in return type\n filterKey: (params) => {\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n\n bindToUrl: (params) => {\n return bindUrlParams<Url>(url, params ?? ({} as never))\n },\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createQueryKey instead */\nexport const queryKeyCreator = createQueryKey\n","import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder'\nimport type {\n DataTag,\n QueryClient,\n UseQueryOptions,\n UseSuspenseQueryOptions,\n} from '@tanstack/react-query'\n\nimport { queryOptions, useQuery, useSuspenseQuery } from '@tanstack/react-query'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryArgs, QueryParams } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create query options for\n * @param options - Query configuration including processResponse\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates query options with attached helpers\n */\nexport function makeQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n BaseQuery extends Omit<\n UseQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'enabled'\n | 'throwOnError'\n | 'placeholderData'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, false)\n const processResponse = options.processResponse\n\n const result = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T ? T : Result,\n DataTag<Split<Config['url'], '/'>, Result, Error>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return queryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n ...params,\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n ...baseQuery,\n })\n }\n result.queryKey = queryKey\n result.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useQuery(result(params))\n }\n\n result.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseQuery(result(params))\n }\n\n result.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.dataTag(params),\n })\n }\n\n result.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n UrlParams,\n} from '@navios/builder'\nimport type {\n InfiniteData,\n QueryClient,\n UseInfiniteQueryOptions,\n UseSuspenseInfiniteQueryOptions,\n} from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n infiniteQueryOptions,\n useInfiniteQuery,\n useSuspenseInfiniteQuery,\n} from '@tanstack/react-query'\n\nimport type { InfiniteQueryOptions, QueryArgs } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates infinite query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query infinite options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create infinite query options for\n * @param options - Infinite query configuration including processResponse and pagination params\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates infinite query options with attached helpers\n */\nexport function makeInfiniteQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends InfiniteQueryOptions<Config>,\n BaseQuery extends Omit<\n UseInfiniteQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'placeholderData'\n | 'throwOnError'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, true)\n\n const processResponse = options.processResponse\n const res = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseInfiniteQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T\n ? T\n : InfiniteData<Result>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return infiniteQueryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal, pageParam }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n // @ts-expect-error TS2345 We bind the url params only if the url has params\n urlParams: params.urlParams as z.infer<UrlParams<Config['url']>>,\n params: {\n ...('params' in params ? params.params : {}),\n ...(pageParam as z.infer<Config['querySchema']>),\n },\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options.getPreviousPageParam,\n initialPageParam:\n options.initialPageParam ??\n config.querySchema.parse('params' in params ? params.params : {}),\n ...baseQuery,\n })\n }\n res.queryKey = queryKey\n\n res.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useInfiniteQuery(res(params))\n }\n\n res.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseInfiniteQuery(res(params))\n }\n\n res.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.dataTag(params),\n })\n }\n\n res.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return res\n}\n","import type {\n AnyEndpointConfig,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { DataTag } from '@tanstack/react-query'\n\nimport type { QueryParams } from '../query/types.mjs'\n\nimport { createQueryKey } from '../query/key-creator.mjs'\n\n/**\n * Creates a mutation key generator for a given endpoint configuration.\n *\n * @param config - The endpoint configuration\n * @param options - Optional query parameters with a default `processResponse` function\n * @returns A function that generates mutation keys\n *\n * @example Basic usage:\n * ```typescript\n * const createMutationKey = createMutationKey(endpoint.config);\n * const mutationKey = createMutationKey({ urlParams: { id: 123 } });\n * ```\n *\n * @example Advanced usage with processResponse:\n * ```ts\n * const createMutationKey = createMutationKey(endpoint.config, {\n * processResponse: (data) => {\n * if (!data.success) {\n * throw new Error(data.message);\n * }\n * return data.data;\n * },\n * });\n * // We create a mutation that will be shared across the project for all passed userId\n * const mutationKey = createMutationKey({ urlParams: { projectId: 123, userId: 'wildcard' } });\n * ```\n */\nexport function createMutationKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options = {\n processResponse: (data) => data,\n } as Options,\n): (\n params: HasParams extends true ? { urlParams: UrlParams<Url> } : {},\n) => Options['processResponse'] extends (...args: unknown[]) => infer Result\n ? DataTag<[Config['url']], Result, Error>\n : never {\n const queryKey = createQueryKey(config, options, false)\n\n // @ts-expect-error We have correct types in return type\n return (params) => {\n return queryKey.filterKey(params)\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createMutationKey instead */\nexport const mutationKeyCreator = createMutationKey\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n NaviosZodRequest,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { UseMutationResult } from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n useIsMutating,\n useMutation,\n useQueryClient,\n} from '@tanstack/react-query'\n\nimport type { MutationParams } from './types.mjs'\n\nimport { createMutationKey } from './key-creator.mjs'\n\n/**\n * Creates a mutation hook for a given endpoint.\n *\n * Returns a function that when called returns a TanStack Query mutation result.\n * The returned function also has helper methods attached (mutationKey, useIsMutating).\n *\n * @param endpoint - The navios endpoint to create a mutation hook for\n * @param options - Mutation configuration including processResponse and callbacks\n * @returns A hook function that returns mutation result with attached helpers\n */\nexport function makeMutation<\n Config extends AnyEndpointConfig,\n TData = unknown,\n TVariables extends NaviosZodRequest<Config> = NaviosZodRequest<Config>,\n TResponse = z.output<Config['responseSchema']>,\n TContext = unknown,\n UseKey extends boolean = false,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: MutationParams<\n Config,\n TData,\n TVariables,\n TResponse,\n TContext,\n UseKey\n >,\n) {\n const config = endpoint.config\n\n const mutationKey = createMutationKey(config, options)\n const result = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): UseMutationResult<TData, Error, NaviosZodRequest<Config>> => {\n const queryClient = useQueryClient()\n const {\n useKey,\n useContext,\n onError,\n onSuccess,\n keyPrefix: _keyPrefix,\n keySuffix: _keySuffix,\n processResponse,\n ...rest\n } = options\n\n const context = useContext?.() as TContext\n\n // @ts-expect-error The types match\n return useMutation(\n {\n ...rest,\n mutationKey: useKey\n ? mutationKey({\n urlParams: keyParams,\n })\n : undefined,\n scope: useKey\n ? {\n id: JSON.stringify(\n mutationKey({\n urlParams: keyParams,\n }),\n ),\n }\n : undefined,\n async mutationFn(params: TVariables) {\n const response = await endpoint(params)\n\n return processResponse(response) as TData\n },\n onSuccess: onSuccess\n ? (data: TData, variables: TVariables) => {\n return onSuccess?.(queryClient, data, variables, context)\n }\n : undefined,\n onError: onError\n ? (err: Error, variables: TVariables) => {\n return onError?.(queryClient, err, variables, context)\n }\n : undefined,\n },\n queryClient,\n )\n }\n result.useIsMutating = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): boolean => {\n if (!options.useKey) {\n throw new Error(\n 'useIsMutating can only be used when useKey is set to true',\n )\n }\n const isMutating = useIsMutating({\n mutationKey: mutationKey({\n urlParams: keyParams,\n }),\n })\n return isMutating > 0\n }\n result.mutationKey = mutationKey\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n HttpMethod,\n} from '@navios/builder'\nimport type { InfiniteData, QueryClient } from '@tanstack/react-query'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport type { ClientOptions, ProcessResponseFunction } from '../common/types.mjs'\nimport type { MutationArgs } from '../mutation/types.mjs'\nimport type { ClientInstance } from './types.mjs'\n\nimport { makeMutation } from '../mutation/make-hook.mjs'\nimport { makeInfiniteQueryOptions } from '../query/make-infinite-options.mjs'\nimport { makeQueryOptions } from '../query/make-options.mjs'\n\n/**\n * Configuration for declaring a query endpoint.\n */\nexport interface QueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema = ZodObject,\n Response extends ZodType = ZodType,\n Result = z.output<Response>,\n RequestSchema = unknown,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => Result\n}\n\n/**\n * Configuration for declaring an infinite query endpoint.\n */\nexport type InfiniteQueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema extends ZodObject = ZodObject,\n Response extends ZodType = ZodType,\n PageResult = z.output<Response>,\n Result = InfiniteData<PageResult>,\n RequestSchema = unknown,\n> = {\n method: Method\n url: Url\n querySchema: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => PageResult\n select?: (data: InfiniteData<PageResult>) => Result\n getNextPageParam: (\n lastPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema> | undefined\n getPreviousPageParam?: (\n firstPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema>\n initialPageParam?: z.input<QuerySchema>\n}\n\n/**\n * Configuration for declaring a mutation endpoint.\n */\nexport interface MutationConfig<\n Method extends 'POST' | 'PUT' | 'PATCH' | 'DELETE' =\n | 'POST'\n | 'PUT'\n | 'PATCH'\n | 'DELETE',\n Url extends string = string,\n RequestSchema = Method extends 'DELETE' ? never : ZodObject,\n QuerySchema = unknown,\n Response extends ZodType = ZodType,\n ReqResult = z.output<Response>,\n Result = unknown,\n Context = unknown,\n UseKey extends boolean = false,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse: ProcessResponseFunction<Result, ReqResult>\n useContext?: () => Context\n onSuccess?: (\n queryClient: QueryClient,\n data: NoInfer<Result>,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n useKey?: UseKey\n}\n\n/**\n * Creates a client instance for making type-safe queries and mutations.\n *\n * @param options - Client configuration including the API builder and defaults\n * @returns A client instance with query, infiniteQuery, and mutation methods\n *\n * @example\n * ```typescript\n * const api = createBuilder({ baseUrl: '/api' });\n * const client = declareClient({ api });\n *\n * const getUser = client.query({\n * method: 'GET',\n * url: '/users/$id',\n * responseSchema: UserSchema,\n * });\n *\n * // In a component\n * const { data } = useSuspenseQuery(getUser({ urlParams: { id: '123' } }));\n * ```\n */\nexport function declareClient<Options extends ClientOptions>({\n api,\n defaults = {},\n}: Options): ClientInstance {\n function query(config: QueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const queryOptions = makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n })\n // @ts-expect-error We attach the endpoint to the queryOptions\n queryOptions.endpoint = endpoint\n return queryOptions\n }\n\n function queryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options?: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n },\n ) {\n return makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n })\n }\n\n function infiniteQuery(config: InfiniteQueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n const infiniteQueryOptions = makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n getNextPageParam: config.getNextPageParam,\n getPreviousPageParam: config.getPreviousPageParam,\n initialPageParam: config.initialPageParam,\n })\n\n // @ts-expect-error We attach the endpoint to the infiniteQueryOptions\n infiniteQueryOptions.endpoint = endpoint\n return infiniteQueryOptions\n }\n\n function infiniteQueryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n getNextPageParam: (\n lastPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']> | undefined\n getPreviousPageParam?: (\n firstPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']>\n initialPageParam?: z.input<AnyEndpointConfig['querySchema']>\n },\n ) {\n return makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options?.getPreviousPageParam,\n initialPageParam: options?.initialPageParam,\n })\n }\n\n function mutation(config: MutationConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n function mutationFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options: {\n processResponse: ProcessResponseFunction\n useContext?: () => unknown\n onSuccess?: (\n queryClient: QueryClient,\n data: unknown,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n },\n ) {\n return makeMutation(endpoint, {\n processResponse: options.processResponse,\n useContext: options.useContext,\n onSuccess: options.onSuccess,\n // @ts-expect-error simplify types here\n onError: options.onError,\n ...defaults,\n })\n }\n\n function multipartMutation(config: MutationConfig) {\n const endpoint = api.declareMultipart({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n return {\n // @ts-expect-error We simplified types here\n query,\n // @ts-expect-error We simplified types here\n queryFromEndpoint,\n // @ts-expect-error We simplified types here\n infiniteQuery,\n // @ts-expect-error We simplified types here\n infiniteQueryFromEndpoint,\n // @ts-expect-error We simplified types here\n mutation,\n // @ts-expect-error We simplified types here\n mutationFromEndpoint,\n // @ts-expect-error We simplified types here\n multipartMutation,\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/query/key-creator.mts","../src/query/make-options.mts","../src/query/make-infinite-options.mts","../src/mutation/key-creator.mts","../src/mutation/make-hook.mts","../src/client/declare-client.mts"],"names":["result","queryOptions","infiniteQueryOptions","useMutation"],"mappings":";;;;AAmBO,SAAS,cAAA,CAOd,MAAA,EACA,OAAA,EACA,WAAA,EASA;AACA,EAAA,MAAM,MAAM,MAAA,CAAO,GAAA;AACnB,EAAA,MAAM,WAAW,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AAC9C,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,QAAA;AAAA;AAAA,IAEV,OAAA,EAAS,CAAC,MAAA,KAAW;AACnB,MAAA,MAAM,WAAA,GACJ,MAAA,IAAU,aAAA,IAAiB,MAAA,IAAU,QAAA,IAAY,MAAA,GAC7C,MAAA,CAAO,WAAA,EAAa,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA,GACvC,EAAC;AACP,MAAA,OAAO;AAAA,QACL,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,GAAG,QAAA,CAAS,GAAA;AAAA,UAAI,CAAC,IAAA,KACf,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA;AAAA;AAAA,YAEf,OAAO,SAAA,CAAU,IAAA,CAAK,MAAM,CAAC,CAAC,EAAE,QAAA;AAAS,cACzC;AAAA,SACN;AAAA,QACA,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,eAAe;AAAC,OAClB;AAAA,IASF,CAAA;AAAA;AAAA,IAEA,SAAA,EAAW,CAAC,MAAA,KAAW;AACrB,MAAA,OAAO;AAAA,QACL,GAAI,OAAA,CAAQ,SAAA,IAAa,EAAC;AAAA,QAC1B,GAAG,QAAA,CAAS,GAAA;AAAA,UAAI,CAAC,IAAA,KACf,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA;AAAA;AAAA,YAEf,OAAO,SAAA,CAAU,IAAA,CAAK,MAAM,CAAC,CAAC,EAAE,QAAA;AAAS,cACzC;AAAA,SACN;AAAA,QACA,GAAI,OAAA,CAAQ,SAAA,IAAa;AAAC,OAC5B;AAAA,IASF,CAAA;AAAA,IAEA,SAAA,EAAW,CAAC,MAAA,KAAW;AACrB,MAAA,OAAO,aAAA,CAAmB,GAAA,EAAK,MAAA,IAAW,EAAY,CAAA;AAAA,IACxD;AAAA,GACF;AACF;AAIO,IAAM,eAAA,GAAkB;ACxExB,SAAS,gBAAA,CAcd,QAAA,EACA,OAAA,EACA,SAAA,GAAuB,EAAC,EACxB;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AACxB,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAc,CAAA;AACtD,EAAA,MAAM,kBAAkB,OAAA,CAAQ,eAAA;AAEhC,EAAA,MAAM,MAAA,GAAS,CACb,MAAA,KAQW;AAEX,IAAA,OAAO,YAAA,CAAa;AAAA,MAClB,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAA;AAAA,MACjC,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAuD;AAC9E,QAAA,IAAIA,OAAAA;AACJ,QAAA,IAAI;AACF,UAAAA,OAAAA,GAAS,MAAM,QAAA,CAAS;AAAA,YACtB,MAAA;AAAA,YACA,GAAG;AAAA,WACJ,CAAA;AAAA,QACH,SAAS,GAAA,EAAK;AACZ,UAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,YAAA,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,UACpB;AACA,UAAA,MAAM,GAAA;AAAA,QACR;AAEA,QAAA,OAAO,gBAAgBA,OAAM,CAAA;AAAA,MAC/B,CAAA;AAAA,MACA,GAAG;AAAA,KACJ,CAAA;AAAA,EACH,CAAA;AACA,EAAA,MAAA,CAAO,QAAA,GAAW,QAAA;AAClB,EAAA,MAAA,CAAO,GAAA,GAAM,CAAC,MAAA,KAA4D;AACxE,IAAA,OAAO,QAAA,CAAS,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,EAChC,CAAA;AAEA,EAAA,MAAA,CAAO,WAAA,GAAc,CAAC,MAAA,KAA4D;AAChF,IAAA,OAAO,gBAAA,CAAiB,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,EACxC,CAAA;AAEA,EAAA,MAAA,CAAO,UAAA,GAAa,CAClB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,MAAM;AAAA,KACzC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,MAAA,CAAO,aAAA,GAAgB,CACrB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,MAAM,CAAA;AAAA,MAC1C,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,MAAA;AACT;AC3EO,SAAS,wBAAA,CAad,QAAA,EACA,OAAA,EACA,SAAA,GAAuB,EAAC,EACxB;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AACxB,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAa,CAAA;AAErD,EAAA,MAAM,kBAAkB,OAAA,CAAQ,eAAA;AAChC,EAAA,MAAM,GAAA,GAAM,CACV,MAAA,KASW;AAEX,IAAA,OAAO,oBAAA,CAAqB;AAAA,MAC1B,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAA;AAAA,MACjC,OAAA,EAAS,OAAO,EAAE,MAAA,EAAQ,WAAU,KAAuD;AACzF,QAAA,IAAI,MAAA;AACJ,QAAA,IAAI;AACF,UAAA,MAAA,GAAS,MAAM,QAAA,CAAS;AAAA,YACtB,MAAA;AAAA;AAAA,YAEA,WAAW,MAAA,CAAO,SAAA;AAAA,YAClB,MAAA,EAAQ;AAAA,cACN,GAAI,QAAA,IAAY,MAAA,GAAS,MAAA,CAAO,SAAS,EAAC;AAAA,cAC1C,GAAI;AAAA;AACN,WACD,CAAA;AAAA,QACH,SAAS,GAAA,EAAK;AACZ,UAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,YAAA,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,UACpB;AACA,UAAA,MAAM,GAAA;AAAA,QACR;AAEA,QAAA,OAAO,gBAAgB,MAAM,CAAA;AAAA,MAC/B,CAAA;AAAA,MACA,kBAAkB,OAAA,CAAQ,gBAAA;AAAA,MAC1B,sBAAsB,OAAA,CAAQ,oBAAA;AAAA,MAC9B,gBAAA,EACE,OAAA,CAAQ,gBAAA,IACR,MAAA,CAAO,WAAA,CAAY,KAAA,CAAM,QAAA,IAAY,MAAA,GAAS,MAAA,CAAO,MAAA,GAAS,EAAE,CAAA;AAAA,MAClE,GAAG;AAAA,KACJ,CAAA;AAAA,EACH,CAAA;AACA,EAAA,GAAA,CAAI,QAAA,GAAW,QAAA;AAEf,EAAA,GAAA,CAAI,GAAA,GAAM,CAAC,MAAA,KAA4D;AACrE,IAAA,OAAO,gBAAA,CAAiB,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,EACrC,CAAA;AAEA,EAAA,GAAA,CAAI,WAAA,GAAc,CAAC,MAAA,KAA4D;AAC7E,IAAA,OAAO,wBAAA,CAAyB,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,EAC7C,CAAA;AAEA,EAAA,GAAA,CAAI,UAAA,GAAa,CACf,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,OAAA,CAAQ,MAAM;AAAA,KACtC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,GAAA,CAAI,aAAA,GAAgB,CAClB,WAAA,EACA,MAAA,KACG;AACH,IAAA,OAAO,YAAY,iBAAA,CAAkB;AAAA,MACnC,QAAA,EAAU,GAAA,CAAI,QAAA,CAAS,SAAA,CAAU,MAAM,CAAA;AAAA,MACvC,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,GAAA;AACT;;;AC1FO,SAAS,iBAAA,CAMd,QACA,OAAA,GAAmB;AAAA,EACjB,eAAA,EAAiB,CAAC,IAAA,KAAS;AAC7B,CAAA,EAKQ;AACR,EAAA,MAAM,QAAA,GAAW,cAAA,CAAe,MAAA,EAAQ,OAAc,CAAA;AAGtD,EAAA,OAAO,CAAC,MAAA,KAAW;AACjB,IAAA,OAAO,QAAA,CAAS,UAAU,MAAM,CAAA;AAAA,EAClC,CAAA;AACF;AAIO,IAAM,kBAAA,GAAqB;ACjC3B,SAAS,YAAA,CAQd,UACA,OAAA,EAQA;AACA,EAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AAExB,EAAA,MAAM,WAAA,GAAc,kBAAkB,MAAA,EAAQ;AAAA,IAC5C,GAAG,OAEL,CAAC,CAAA;AACD,EAAA,MAAM,MAAA,GAAS,CACb,SAAA,KAK8D;AAC9D,IAAA,MAAM,cAAc,cAAA,EAAe;AACnC,IAAA,MAAM;AAAA,MACJ,MAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAA;AAAA,MACA,SAAA;AAAA,MACA,SAAA,EAAW,UAAA;AAAA,MACX,SAAA,EAAW,UAAA;AAAA,MACX,eAAA;AAAA,MACA,GAAG;AAAA,KACL,GAAI,OAAA;AAEJ,IAAA,MAAM,UAAU,UAAA,IAAa;AAG7B,IAAA,OAAO,WAAA;AAAA,MACL;AAAA,QACE,GAAG,IAAA;AAAA,QACH,WAAA,EAAa,SACT,WAAA,CAAY;AAAA,UACV,SAAA,EAAW;AAAA,SACZ,CAAA,GACD,MAAA;AAAA,QACJ,OAAO,MAAA,GACH;AAAA,UACE,IAAI,IAAA,CAAK,SAAA;AAAA,YACP,WAAA,CAAY;AAAA,cACV,SAAA,EAAW;AAAA,aACZ;AAAA;AACH,SACF,GACA,MAAA;AAAA,QACJ,MAAM,WAAW,MAAA,EAAoB;AACnC,UAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,MAAM,CAAA;AAEtC,UAAA,OAAQ,eAAA,GAAkB,eAAA,CAAgB,QAAQ,CAAA,GAAI,QAAA;AAAA,QACxD,CAAA;AAAA,QACA,SAAA,EAAW,SAAA,GACP,CAAC,IAAA,EAAa,SAAA,KAA0B;AACtC,UAAA,OAAO,SAAA,GAAY,WAAA,EAAa,IAAA,EAAM,SAAA,EAAW,OAAO,CAAA;AAAA,QAC1D,CAAA,GACA,MAAA;AAAA,QACJ,OAAA,EAAS,OAAA,GACL,CAAC,GAAA,EAAY,SAAA,KAA0B;AACrC,UAAA,OAAO,OAAA,GAAU,WAAA,EAAa,GAAA,EAAK,SAAA,EAAW,OAAO,CAAA;AAAA,QACvD,CAAA,GACA;AAAA,OACN;AAAA,MACA;AAAA,KACF;AAAA,EACF,CAAA;AACA,EAAA,MAAA,CAAO,aAAA,GAAgB,CACrB,SAAA,KAKY;AACZ,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,aAAa,aAAA,CAAc;AAAA,MAC/B,aAAa,WAAA,CAAY;AAAA,QACvB,SAAA,EAAW;AAAA,OACZ;AAAA,KACF,CAAA;AACD,IAAA,OAAO,UAAA,GAAa,CAAA;AAAA,EACtB,CAAA;AACA,EAAA,MAAA,CAAO,WAAA,GAAc,WAAA;AAErB,EAAA,OAAO,MAAA;AACT;;;ACFO,SAAS,aAAA,CAA6C;AAAA,EAC3D,GAAA;AAAA,EACA,WAAW;AACb,CAAA,EAA4B;AAC1B,EAAA,SAAS,MAAM,MAAA,EAAqB;AAClC,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMC,aAAAA,GAAe,iBAAiB,QAAA,EAAU;AAAA,MAC9C,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA;AAAA,KACvD,CAAA;AAED,IAAAA,cAAa,QAAA,GAAW,QAAA;AACxB,IAAA,OAAOA,aAAAA;AAAA,EACT;AAEA,EAAA,SAAS,iBAAA,CACP,UACA,OAAA,EAKA;AACA,IAAA,OAAO,iBAAiB,QAAA,EAAU;AAAA,MAChC,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,OAAA,EAAS,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA;AAAA,KACzD,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,cAAc,MAAA,EAA6B;AAClD,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AACD,IAAA,MAAMC,qBAAAA,GAAuB,yBAAyB,QAAA,EAAU;AAAA,MAC9D,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,kBAAkB,MAAA,CAAO,gBAAA;AAAA,MACzB,sBAAsB,MAAA,CAAO,oBAAA;AAAA,MAC7B,kBAAkB,MAAA,CAAO;AAAA,KAC1B,CAAA;AAGD,IAAAA,sBAAqB,QAAA,GAAW,QAAA;AAChC,IAAA,OAAOA,qBAAAA;AAAA,EACT;AAEA,EAAA,SAAS,yBAAA,CACP,UACA,OAAA,EAkBA;AACA,IAAA,OAAO,yBAAyB,QAAA,EAAU;AAAA,MACxC,GAAG,QAAA;AAAA,MACH,eAAA,EAAiB,OAAA,EAAS,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACxD,kBAAkB,OAAA,CAAQ,gBAAA;AAAA,MAC1B,sBAAsB,OAAA,EAAS,oBAAA;AAAA,MAC/B,kBAAkB,OAAA,EAAS;AAAA,KAC5B,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,SAAS,MAAA,EAAwB;AACxC,IAAA,MAAM,QAAA,GAAW,IAAI,eAAA,CAAgB;AAAA;AAAA,MAEnC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMC,YAAAA,GAAc,aAAa,QAAA,EAAU;AAAA,MACzC,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,YAAY,MAAA,CAAO,UAAA;AAAA;AAAA,MAEnB,WAAW,MAAA,CAAO,SAAA;AAAA;AAAA,MAElB,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,GAAG;AAAA,KACJ,CAAA;AAGD,IAAAA,aAAY,QAAA,GAAW,QAAA;AACvB,IAAA,OAAOA,YAAAA;AAAA,EACT;AAEA,EAAA,SAAS,oBAAA,CACP,UAGA,OAAA,EAgBA;AAEA,IAAA,OAAO,aAAa,QAAA,EAAU;AAAA,MAC5B,iBAAiB,OAAA,EAAS,eAAA;AAAA,MAC1B,YAAY,OAAA,EAAS,UAAA;AAAA,MACrB,WAAW,OAAA,EAAS,SAAA;AAAA,MACpB,SAAS,OAAA,EAAS,OAAA;AAAA,MAClB,GAAG;AAAA,KACJ,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,kBAAkB,MAAA,EAAwB;AACjD,IAAA,MAAM,QAAA,GAAW,IAAI,gBAAA,CAAiB;AAAA;AAAA,MAEpC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,eAAe,MAAA,CAAO,aAAA;AAAA,MACtB,gBAAgB,MAAA,CAAO;AAAA,KACxB,CAAA;AAED,IAAA,MAAMA,YAAAA,GAAc,aAAa,QAAA,EAAU;AAAA,MACzC,eAAA,EAAiB,MAAA,CAAO,eAAA,KAAoB,CAAC,IAAA,KAAS,IAAA,CAAA;AAAA,MACtD,YAAY,MAAA,CAAO,UAAA;AAAA;AAAA,MAEnB,WAAW,MAAA,CAAO,SAAA;AAAA;AAAA,MAElB,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,GAAG;AAAA,KACJ,CAAA;AAGD,IAAAA,aAAY,QAAA,GAAW,QAAA;AACvB,IAAA,OAAOA,YAAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,KAAA;AAAA;AAAA,IAEA,iBAAA;AAAA;AAAA,IAEA,aAAA;AAAA;AAAA,IAEA,yBAAA;AAAA;AAAA,IAEA,QAAA;AAAA;AAAA,IAEA,oBAAA;AAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import type { AnyEndpointConfig, UrlHasParams } from '@navios/builder'\nimport type { DataTag, InfiniteData } from '@tanstack/react-query'\n\nimport { bindUrlParams } from '@navios/builder'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryKeyCreatorResult, QueryParams } from './types.mjs'\n\n/**\n * Creates a query key generator for a given endpoint configuration.\n *\n * The returned object provides methods to generate query keys that can be used\n * with TanStack Query for caching, invalidation, and data tagging.\n *\n * @param config - The endpoint configuration\n * @param options - Query parameters including processResponse and key prefix/suffix\n * @param isInfinite - Whether this is for an infinite query\n * @returns An object with methods to generate query keys\n */\nexport function createQueryKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n IsInfinite extends boolean,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options,\n _isInfinite: IsInfinite,\n): QueryKeyCreatorResult<\n Config['querySchema'],\n Url,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? Result\n : never,\n IsInfinite,\n HasParams\n> {\n const url = config.url as Url\n const urlParts = url.split('/').filter(Boolean) as Split<Url, '/'>\n return {\n template: urlParts,\n // @ts-expect-error We have correct types in return type\n dataTag: (params) => {\n const queryParams =\n params && 'querySchema' in config && 'params' in params\n ? config.querySchema?.parse(params.params)\n : []\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n queryParams ?? [],\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n // @ts-expect-error We have correct types in return type\n filterKey: (params) => {\n return [\n ...(options.keyPrefix ?? []),\n ...urlParts.map((part) =>\n part.startsWith('$')\n ? // @ts-expect-error TS2339 We know that the urlParams are defined only if the url has params\n params.urlParams[part.slice(1)].toString()\n : part,\n ),\n ...(options.keySuffix ?? []),\n ] as unknown as DataTag<\n Split<Url, '/'>,\n Options['processResponse'] extends (...args: any[]) => infer Result\n ? IsInfinite extends true\n ? InfiniteData<Result>\n : Result\n : never,\n Error\n >\n },\n\n bindToUrl: (params) => {\n return bindUrlParams<Url>(url, params ?? ({} as never))\n },\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createQueryKey instead */\nexport const queryKeyCreator = createQueryKey\n","import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder'\nimport type {\n DataTag,\n QueryClient,\n UseQueryOptions,\n UseSuspenseQueryOptions,\n} from '@tanstack/react-query'\n\nimport { queryOptions, useQuery, useSuspenseQuery } from '@tanstack/react-query'\n\nimport type { Split } from '../common/types.mjs'\nimport type { QueryArgs, QueryParams } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create query options for\n * @param options - Query configuration including processResponse\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates query options with attached helpers\n */\nexport function makeQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n BaseQuery extends Omit<\n UseQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'enabled'\n | 'throwOnError'\n | 'placeholderData'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, false)\n const processResponse = options.processResponse\n\n const result = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T ? T : Result,\n DataTag<Split<Config['url'], '/'>, Result, Error>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return queryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n ...params,\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n ...baseQuery,\n })\n }\n result.queryKey = queryKey\n result.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useQuery(result(params))\n }\n\n result.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseQuery(result(params))\n }\n\n result.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.dataTag(params),\n })\n }\n\n result.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: result.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n UrlParams,\n} from '@navios/builder'\nimport type {\n InfiniteData,\n QueryClient,\n UseInfiniteQueryOptions,\n UseSuspenseInfiniteQueryOptions,\n} from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n infiniteQueryOptions,\n useInfiniteQuery,\n useSuspenseInfiniteQuery,\n} from '@tanstack/react-query'\n\nimport type { InfiniteQueryOptions, QueryArgs } from './types.mjs'\n\nimport { createQueryKey } from './key-creator.mjs'\n\n/**\n * Creates infinite query options for a given endpoint.\n *\n * Returns a function that generates TanStack Query infinite options when called with params.\n * The returned function also has helper methods attached (use, useSuspense, invalidate, etc.)\n *\n * @param endpoint - The navios endpoint to create infinite query options for\n * @param options - Infinite query configuration including processResponse and pagination params\n * @param baseQuery - Optional base query options to merge\n * @returns A function that generates infinite query options with attached helpers\n */\nexport function makeInfiniteQueryOptions<\n Config extends AnyEndpointConfig,\n Options extends InfiniteQueryOptions<Config>,\n BaseQuery extends Omit<\n UseInfiniteQueryOptions<ReturnType<Options['processResponse']>, Error, any>,\n | 'queryKey'\n | 'queryFn'\n | 'getNextPageParam'\n | 'initialPageParam'\n | 'placeholderData'\n | 'throwOnError'\n >,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: Options,\n baseQuery: BaseQuery = {} as BaseQuery,\n) {\n const config = endpoint.config\n const queryKey = createQueryKey(config, options, true)\n\n const processResponse = options.processResponse\n const res = (\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ): Options['processResponse'] extends (...args: any[]) => infer Result\n ? UseSuspenseInfiniteQueryOptions<\n Result,\n Error,\n BaseQuery['select'] extends (...args: any[]) => infer T\n ? T\n : InfiniteData<Result>\n >\n : never => {\n // @ts-expect-error TS2322 We know that the processResponse is defined\n return infiniteQueryOptions({\n queryKey: queryKey.dataTag(params),\n queryFn: async ({ signal, pageParam }): Promise<ReturnType<Options['processResponse']>> => {\n let result\n try {\n result = await endpoint({\n signal,\n // @ts-expect-error TS2345 We bind the url params only if the url has params\n urlParams: params.urlParams as z.infer<UrlParams<Config['url']>>,\n params: {\n ...('params' in params ? params.params : {}),\n ...(pageParam as z.infer<Config['querySchema']>),\n },\n })\n } catch (err) {\n if (options.onFail) {\n options.onFail(err)\n }\n throw err\n }\n\n return processResponse(result) as ReturnType<Options['processResponse']>\n },\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options.getPreviousPageParam,\n initialPageParam:\n options.initialPageParam ??\n config.querySchema.parse('params' in params ? params.params : {}),\n ...baseQuery,\n })\n }\n res.queryKey = queryKey\n\n res.use = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useInfiniteQuery(res(params))\n }\n\n res.useSuspense = (params: QueryArgs<Config['url'], Config['querySchema']>) => {\n return useSuspenseInfiniteQuery(res(params))\n }\n\n res.invalidate = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.dataTag(params),\n })\n }\n\n res.invalidateAll = (\n queryClient: QueryClient,\n params: QueryArgs<Config['url'], Config['querySchema']>,\n ) => {\n return queryClient.invalidateQueries({\n queryKey: res.queryKey.filterKey(params),\n exact: false,\n })\n }\n\n return res\n}\n","import type {\n AnyEndpointConfig,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { DataTag } from '@tanstack/react-query'\n\nimport type { QueryParams } from '../query/types.mjs'\n\nimport { createQueryKey } from '../query/key-creator.mjs'\n\n/**\n * Creates a mutation key generator for a given endpoint configuration.\n *\n * @param config - The endpoint configuration\n * @param options - Optional query parameters with a default `processResponse` function\n * @returns A function that generates mutation keys\n *\n * @example Basic usage:\n * ```typescript\n * const createMutationKey = createMutationKey(endpoint.config);\n * const mutationKey = createMutationKey({ urlParams: { id: 123 } });\n * ```\n *\n * @example Advanced usage with processResponse:\n * ```ts\n * const createMutationKey = createMutationKey(endpoint.config, {\n * processResponse: (data) => {\n * if (!data.success) {\n * throw new Error(data.message);\n * }\n * return data.data;\n * },\n * });\n * // We create a mutation that will be shared across the project for all passed userId\n * const mutationKey = createMutationKey({ urlParams: { projectId: 123, userId: 'wildcard' } });\n * ```\n */\nexport function createMutationKey<\n Config extends AnyEndpointConfig,\n Options extends QueryParams<Config>,\n Url extends Config['url'] = Config['url'],\n HasParams extends UrlHasParams<Url> = UrlHasParams<Url>,\n>(\n config: Config,\n options: Options = {\n processResponse: (data) => data,\n } as Options,\n): (\n params: HasParams extends true ? { urlParams: UrlParams<Url> } : {},\n) => Options['processResponse'] extends (...args: unknown[]) => infer Result\n ? DataTag<[Config['url']], Result, Error>\n : never {\n const queryKey = createQueryKey(config, options, false)\n\n // @ts-expect-error We have correct types in return type\n return (params) => {\n return queryKey.filterKey(params)\n }\n}\n\n// Legacy export for backwards compatibility\n/** @deprecated Use createMutationKey instead */\nexport const mutationKeyCreator = createMutationKey\n","import type {\n AbstractEndpoint,\n AnyEndpointConfig,\n NaviosZodRequest,\n UrlHasParams,\n UrlParams,\n} from '@navios/builder'\nimport type { UseMutationResult } from '@tanstack/react-query'\nimport type { z } from 'zod/v4'\n\nimport {\n useIsMutating,\n useMutation,\n useQueryClient,\n} from '@tanstack/react-query'\n\nimport type { MutationParams } from './types.mjs'\n\nimport { createMutationKey } from './key-creator.mjs'\n\n/**\n * Creates a mutation hook for a given endpoint.\n *\n * Returns a function that when called returns a TanStack Query mutation result.\n * The returned function also has helper methods attached (mutationKey, useIsMutating).\n *\n * @param endpoint - The navios endpoint to create a mutation hook for\n * @param options - Mutation configuration including processResponse and callbacks\n * @returns A hook function that returns mutation result with attached helpers\n */\nexport function makeMutation<\n Config extends AnyEndpointConfig,\n TData = unknown,\n TVariables extends NaviosZodRequest<Config> = NaviosZodRequest<Config>,\n TResponse = z.output<Config['responseSchema']>,\n TContext = unknown,\n UseKey extends boolean = false,\n>(\n endpoint: AbstractEndpoint<Config>,\n options: MutationParams<\n Config,\n TData,\n TVariables,\n TResponse,\n TContext,\n UseKey\n >,\n) {\n const config = endpoint.config\n\n const mutationKey = createMutationKey(config, {\n ...options,\n processResponse: options.processResponse ?? ((data) => data),\n })\n const result = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): UseMutationResult<TData, Error, NaviosZodRequest<Config>> => {\n const queryClient = useQueryClient()\n const {\n useKey,\n useContext,\n onError,\n onSuccess,\n keyPrefix: _keyPrefix,\n keySuffix: _keySuffix,\n processResponse,\n ...rest\n } = options\n\n const context = useContext?.() as TContext\n\n // @ts-expect-error The types match\n return useMutation(\n {\n ...rest,\n mutationKey: useKey\n ? mutationKey({\n urlParams: keyParams,\n })\n : undefined,\n scope: useKey\n ? {\n id: JSON.stringify(\n mutationKey({\n urlParams: keyParams,\n }),\n ),\n }\n : undefined,\n async mutationFn(params: TVariables) {\n const response = await endpoint(params)\n\n return (processResponse ? processResponse(response) : response) as TData\n },\n onSuccess: onSuccess\n ? (data: TData, variables: TVariables) => {\n return onSuccess?.(queryClient, data, variables, context)\n }\n : undefined,\n onError: onError\n ? (err: Error, variables: TVariables) => {\n return onError?.(queryClient, err, variables, context)\n }\n : undefined,\n },\n queryClient,\n )\n }\n result.useIsMutating = (\n keyParams: UseKey extends true\n ? UrlHasParams<Config['url']> extends true\n ? UrlParams<Config['url']>\n : never\n : never,\n ): boolean => {\n if (!options.useKey) {\n throw new Error(\n 'useIsMutating can only be used when useKey is set to true',\n )\n }\n const isMutating = useIsMutating({\n mutationKey: mutationKey({\n urlParams: keyParams,\n }),\n })\n return isMutating > 0\n }\n result.mutationKey = mutationKey\n\n return result\n}\n","import type {\n AbstractEndpoint,\n AbstractStream,\n AnyEndpointConfig,\n AnyStreamConfig,\n HttpMethod,\n} from '@navios/builder'\nimport type { InfiniteData, QueryClient } from '@tanstack/react-query'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport type { ClientOptions, ProcessResponseFunction } from '../common/types.mjs'\nimport type { MutationArgs } from '../mutation/types.mjs'\nimport type { ClientInstance } from './types.mjs'\n\nimport { makeMutation } from '../mutation/make-hook.mjs'\nimport { makeInfiniteQueryOptions } from '../query/make-infinite-options.mjs'\nimport { makeQueryOptions } from '../query/make-options.mjs'\n\n/**\n * Configuration for declaring a query endpoint.\n */\nexport interface QueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema = ZodObject,\n Response extends ZodType = ZodType,\n Result = z.output<Response>,\n RequestSchema = unknown,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => Result\n}\n\n/**\n * Configuration for declaring an infinite query endpoint.\n */\nexport type InfiniteQueryConfig<\n Method = HttpMethod,\n Url = string,\n QuerySchema extends ZodObject = ZodObject,\n Response extends ZodType = ZodType,\n PageResult = z.output<Response>,\n Result = InfiniteData<PageResult>,\n RequestSchema = unknown,\n> = {\n method: Method\n url: Url\n querySchema: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse?: (data: z.output<Response>) => PageResult\n select?: (data: InfiniteData<PageResult>) => Result\n getNextPageParam: (\n lastPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema> | undefined\n getPreviousPageParam?: (\n firstPage: PageResult,\n allPages: PageResult[],\n lastPageParam: z.infer<QuerySchema> | undefined,\n allPageParams: z.infer<QuerySchema>[] | undefined,\n ) => z.input<QuerySchema>\n initialPageParam?: z.input<QuerySchema>\n}\n\n/**\n * Configuration for declaring a mutation endpoint.\n */\nexport interface MutationConfig<\n Method extends 'POST' | 'PUT' | 'PATCH' | 'DELETE' =\n | 'POST'\n | 'PUT'\n | 'PATCH'\n | 'DELETE',\n Url extends string = string,\n RequestSchema = Method extends 'DELETE' ? never : ZodObject,\n QuerySchema = unknown,\n Response extends ZodType = ZodType,\n ReqResult = z.output<Response>,\n Result = unknown,\n Context = unknown,\n UseKey extends boolean = false,\n> {\n method: Method\n url: Url\n querySchema?: QuerySchema\n responseSchema: Response\n requestSchema?: RequestSchema\n processResponse: ProcessResponseFunction<Result, ReqResult>\n useContext?: () => Context\n onSuccess?: (\n queryClient: QueryClient,\n data: NoInfer<Result>,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs<Url, RequestSchema, QuerySchema>,\n context: Context,\n ) => void | Promise<void>\n useKey?: UseKey\n}\n\n/**\n * Creates a client instance for making type-safe queries and mutations.\n *\n * @param options - Client configuration including the API builder and defaults\n * @returns A client instance with query, infiniteQuery, and mutation methods\n *\n * @example\n * ```typescript\n * const api = createBuilder({ baseUrl: '/api' });\n * const client = declareClient({ api });\n *\n * const getUser = client.query({\n * method: 'GET',\n * url: '/users/$id',\n * responseSchema: UserSchema,\n * });\n *\n * // In a component\n * const { data } = useSuspenseQuery(getUser({ urlParams: { id: '123' } }));\n * ```\n */\nexport function declareClient<Options extends ClientOptions>({\n api,\n defaults = {},\n}: Options): ClientInstance {\n function query(config: QueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const queryOptions = makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n })\n // @ts-expect-error We attach the endpoint to the queryOptions\n queryOptions.endpoint = endpoint\n return queryOptions\n }\n\n function queryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options?: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n },\n ) {\n return makeQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n })\n }\n\n function infiniteQuery(config: InfiniteQueryConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n const infiniteQueryOptions = makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: config.processResponse ?? ((data) => data),\n getNextPageParam: config.getNextPageParam,\n getPreviousPageParam: config.getPreviousPageParam,\n initialPageParam: config.initialPageParam,\n })\n\n // @ts-expect-error We attach the endpoint to the infiniteQueryOptions\n infiniteQueryOptions.endpoint = endpoint\n return infiniteQueryOptions\n }\n\n function infiniteQueryFromEndpoint(\n endpoint: AbstractEndpoint<AnyEndpointConfig>,\n options: {\n processResponse?: (\n data: z.output<AnyEndpointConfig['responseSchema']>,\n ) => unknown\n getNextPageParam: (\n lastPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']> | undefined\n getPreviousPageParam?: (\n firstPage: z.infer<AnyEndpointConfig['responseSchema']>,\n allPages: z.infer<AnyEndpointConfig['responseSchema']>[],\n lastPageParam: z.infer<AnyEndpointConfig['querySchema']> | undefined,\n allPageParams: z.infer<AnyEndpointConfig['querySchema']>[] | undefined,\n ) => z.input<AnyEndpointConfig['querySchema']>\n initialPageParam?: z.input<AnyEndpointConfig['querySchema']>\n },\n ) {\n return makeInfiniteQueryOptions(endpoint, {\n ...defaults,\n processResponse: options?.processResponse ?? ((data) => data),\n getNextPageParam: options.getNextPageParam,\n getPreviousPageParam: options?.getPreviousPageParam,\n initialPageParam: options?.initialPageParam,\n })\n }\n\n function mutation(config: MutationConfig) {\n const endpoint = api.declareEndpoint({\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n function mutationFromEndpoint(\n endpoint:\n | AbstractEndpoint<AnyEndpointConfig>\n | AbstractStream<AnyStreamConfig>,\n options?: {\n processResponse?: ProcessResponseFunction\n useContext?: () => unknown\n onSuccess?: (\n queryClient: QueryClient,\n data: unknown,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n onError?: (\n queryClient: QueryClient,\n error: Error,\n variables: MutationArgs,\n context: unknown,\n ) => void | Promise<void>\n },\n ) {\n // @ts-expect-error endpoint types are compatible at runtime\n return makeMutation(endpoint, {\n processResponse: options?.processResponse,\n useContext: options?.useContext,\n onSuccess: options?.onSuccess,\n onError: options?.onError,\n ...defaults,\n })\n }\n\n function multipartMutation(config: MutationConfig) {\n const endpoint = api.declareMultipart({\n // @ts-expect-error we accept only specific methods\n method: config.method,\n url: config.url,\n querySchema: config.querySchema,\n requestSchema: config.requestSchema,\n responseSchema: config.responseSchema,\n })\n\n const useMutation = makeMutation(endpoint, {\n processResponse: config.processResponse ?? ((data) => data),\n useContext: config.useContext,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onSuccess: config.onSuccess,\n // @ts-expect-error We forgot about the DELETE method in original makeMutation\n onError: config.onError,\n useKey: config.useKey,\n ...defaults,\n })\n\n // @ts-expect-error We attach the endpoint to the useMutation\n useMutation.endpoint = endpoint\n return useMutation\n }\n\n return {\n // @ts-expect-error We simplified types here\n query,\n // @ts-expect-error We simplified types here\n queryFromEndpoint,\n // @ts-expect-error We simplified types here\n infiniteQuery,\n // @ts-expect-error We simplified types here\n infiniteQueryFromEndpoint,\n // @ts-expect-error We simplified types here\n mutation,\n // @ts-expect-error We simplified types here\n mutationFromEndpoint,\n // @ts-expect-error We simplified types here\n multipartMutation,\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@navios/react-query",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "author": {
5
5
  "name": "Oleksandr Hanzha",
6
6
  "email": "alex@granted.name"
@@ -137,4 +137,71 @@ describe('makeMutation', () => {
137
137
  // @ts-expect-error from mock
138
138
  expect(mutationResult.mutationKey).toMatchObject(['test', '1', 'foo', '2'])
139
139
  })
140
+
141
+ describe('stream mutations', () => {
142
+ const streamEndpoint = api.declareStream({
143
+ method: 'GET',
144
+ url: '/files/$fileId/download' as const,
145
+ })
146
+
147
+ adapter.mock('/files/123/download', 'GET', () => {
148
+ const blob = new Blob(['test file content'], { type: 'text/plain' })
149
+ return new Response(blob, {
150
+ status: 200,
151
+ statusText: 'OK',
152
+ headers: {
153
+ 'content-type': 'application/octet-stream',
154
+ },
155
+ })
156
+ })
157
+
158
+ it('should work without processResponse (returns Blob)', async () => {
159
+ // @ts-expect-error stream endpoint type differs from regular endpoint
160
+ const mutation = makeMutation(streamEndpoint, {})
161
+ // @ts-expect-error internal type
162
+ const mutationResult = mutation()
163
+
164
+ const result = await mutationResult.mutateAsync({
165
+ urlParams: { fileId: '123' },
166
+ })
167
+
168
+ expect(result).toBeInstanceOf(Blob)
169
+ })
170
+
171
+ it('should work with processResponse transformation', async () => {
172
+ // @ts-expect-error stream endpoint type differs from regular endpoint
173
+ const mutation = makeMutation(streamEndpoint, {
174
+ processResponse: (blob: Blob) => URL.createObjectURL(blob),
175
+ })
176
+ // @ts-expect-error internal type
177
+ const mutationResult = mutation()
178
+
179
+ const result = await mutationResult.mutateAsync({
180
+ urlParams: { fileId: '123' },
181
+ })
182
+
183
+ expect(typeof result).toBe('string')
184
+ expect(result).toContain('blob:')
185
+ })
186
+
187
+ it('should call onSuccess with Blob data', async () => {
188
+ const onSuccess = vi.fn()
189
+ // @ts-expect-error stream endpoint type differs from regular endpoint
190
+ const mutation = makeMutation(streamEndpoint, {
191
+ onSuccess,
192
+ })
193
+ // @ts-expect-error internal type
194
+ const mutationResult = mutation()
195
+
196
+ await mutationResult.mutateAsync({
197
+ urlParams: { fileId: '123' },
198
+ })
199
+
200
+ expect(onSuccess).toHaveBeenCalledTimes(1)
201
+ expect(onSuccess.mock.calls[0][1]).toBeInstanceOf(Blob)
202
+ expect(onSuccess.mock.calls[0][2]).toMatchObject({
203
+ urlParams: { fileId: '123' },
204
+ })
205
+ })
206
+ })
140
207
  })
@@ -10,11 +10,12 @@ import type { z } from 'zod/v4'
10
10
  import { assertType, describe, test } from 'vitest'
11
11
  import { z as zod } from 'zod/v4'
12
12
 
13
- import type { ClientInstance } from '../types.mjs'
13
+ import type { ClientInstance, StreamHelper } from '../types.mjs'
14
14
  import type { QueryHelpers } from '../../query/types.mjs'
15
15
  import type { MutationHelpers } from '../../mutation/types.mjs'
16
16
  import type { EndpointHelper } from '../types.mjs'
17
17
  import type { Split } from '../../common/types.mjs'
18
+ import type { BaseStreamConfig } from '@navios/builder'
18
19
 
19
20
  declare const client: ClientInstance
20
21
 
@@ -644,6 +645,155 @@ describe('ClientInstance', () => {
644
645
  })
645
646
  })
646
647
 
648
+ // Stream endpoint type declarations for testing
649
+ declare const streamEndpointGet: {
650
+ config: BaseStreamConfig<'GET', '/files/$fileId/download', undefined, undefined>
651
+ } & ((params: { urlParams: { fileId: string | number } }) => Promise<Blob>)
652
+
653
+ declare const streamEndpointGetWithQuery: {
654
+ config: BaseStreamConfig<
655
+ 'GET',
656
+ '/files/$fileId/download',
657
+ typeof querySchema,
658
+ undefined
659
+ >
660
+ } & ((params: {
661
+ urlParams: { fileId: string | number }
662
+ params: z.input<typeof querySchema>
663
+ }) => Promise<Blob>)
664
+
665
+ declare const streamEndpointPost: {
666
+ config: BaseStreamConfig<
667
+ 'POST',
668
+ '/files/$fileId/export',
669
+ undefined,
670
+ typeof requestSchema
671
+ >
672
+ } & ((params: {
673
+ urlParams: { fileId: string | number }
674
+ data: z.input<typeof requestSchema>
675
+ }) => Promise<Blob>)
676
+
677
+ describe('mutationFromEndpoint() with stream endpoints', () => {
678
+ test('GET stream mutation without options (returns Blob)', () => {
679
+ const mutation = client.mutationFromEndpoint(streamEndpointGet)
680
+
681
+ // Should return a function that returns UseMutationResult with Blob
682
+ assertType<
683
+ () => UseMutationResult<Blob, Error, { urlParams: { fileId: string | number } }>
684
+ >(mutation)
685
+
686
+ // Should have StreamHelper
687
+ assertType<
688
+ StreamHelper<'GET', '/files/$fileId/download', undefined, undefined>['endpoint']
689
+ >(mutation.endpoint)
690
+ })
691
+
692
+ test('GET stream mutation with processResponse transformation', () => {
693
+ const mutation = client.mutationFromEndpoint(streamEndpointGet, {
694
+ processResponse: (blob) => URL.createObjectURL(blob),
695
+ })
696
+
697
+ // Result type should be string (transformed)
698
+ assertType<
699
+ () => UseMutationResult<
700
+ string,
701
+ Error,
702
+ { urlParams: { fileId: string | number } }
703
+ >
704
+ >(mutation)
705
+ })
706
+
707
+ test('GET stream mutation with useKey', () => {
708
+ const mutation = client.mutationFromEndpoint(streamEndpointGet, {
709
+ useKey: true,
710
+ })
711
+
712
+ // With useKey, should require urlParams in the call
713
+ assertType<
714
+ (params: {
715
+ urlParams: { fileId: string | number }
716
+ }) => UseMutationResult<
717
+ Blob,
718
+ Error,
719
+ { urlParams: { fileId: string | number } }
720
+ >
721
+ >(mutation)
722
+
723
+ // Should have MutationHelpers
724
+ assertType<
725
+ MutationHelpers<'/files/$fileId/download', Blob>['mutationKey']
726
+ >(mutation.mutationKey)
727
+ })
728
+
729
+ test('GET stream mutation with querySchema', () => {
730
+ const mutation = client.mutationFromEndpoint(streamEndpointGetWithQuery)
731
+
732
+ assertType<
733
+ () => UseMutationResult<
734
+ Blob,
735
+ Error,
736
+ {
737
+ urlParams: { fileId: string | number }
738
+ params: z.input<typeof querySchema>
739
+ }
740
+ >
741
+ >(mutation)
742
+ })
743
+
744
+ test('POST stream mutation with requestSchema', () => {
745
+ const mutation = client.mutationFromEndpoint(streamEndpointPost)
746
+
747
+ assertType<
748
+ () => UseMutationResult<
749
+ Blob,
750
+ Error,
751
+ {
752
+ urlParams: { fileId: string | number }
753
+ data: z.input<typeof requestSchema>
754
+ }
755
+ >
756
+ >(mutation)
757
+ })
758
+
759
+ test('stream mutation with onSuccess callback', () => {
760
+ const mutation = client.mutationFromEndpoint(streamEndpointGet, {
761
+ onSuccess: (_queryClient, data, variables) => {
762
+ // data should be Blob
763
+ assertType<Blob>(data)
764
+ // variables should have urlParams
765
+ assertType<{ urlParams: { fileId: string | number } }>(variables)
766
+ },
767
+ })
768
+
769
+ assertType<
770
+ () => UseMutationResult<
771
+ Blob,
772
+ Error,
773
+ { urlParams: { fileId: string | number } }
774
+ >
775
+ >(mutation)
776
+ })
777
+
778
+ test('stream mutation with custom processResponse and onSuccess', () => {
779
+ const mutation = client.mutationFromEndpoint(streamEndpointGet, {
780
+ processResponse: (blob) => ({ url: URL.createObjectURL(blob), size: blob.size }),
781
+ onSuccess: (_queryClient, data) => {
782
+ // data should be the transformed type
783
+ assertType<{ url: string; size: number }>(data)
784
+ },
785
+ })
786
+
787
+ assertType<
788
+ () => UseMutationResult<
789
+ { url: string; size: number },
790
+ Error,
791
+ { urlParams: { fileId: string | number } }
792
+ >
793
+ >(mutation)
794
+ })
795
+ })
796
+
647
797
  describe('Error cases - should fail type checking', () => {
648
798
  test('GET query without urlParams when URL has params', () => {
649
799
  const query = client.query({
@@ -1,6 +1,8 @@
1
1
  import type {
2
2
  AbstractEndpoint,
3
+ AbstractStream,
3
4
  AnyEndpointConfig,
5
+ AnyStreamConfig,
4
6
  HttpMethod,
5
7
  } from '@navios/builder'
6
8
  import type { InfiniteData, QueryClient } from '@tanstack/react-query'
@@ -244,9 +246,11 @@ export function declareClient<Options extends ClientOptions>({
244
246
  }
245
247
 
246
248
  function mutationFromEndpoint(
247
- endpoint: AbstractEndpoint<AnyEndpointConfig>,
248
- options: {
249
- processResponse: ProcessResponseFunction
249
+ endpoint:
250
+ | AbstractEndpoint<AnyEndpointConfig>
251
+ | AbstractStream<AnyStreamConfig>,
252
+ options?: {
253
+ processResponse?: ProcessResponseFunction
250
254
  useContext?: () => unknown
251
255
  onSuccess?: (
252
256
  queryClient: QueryClient,
@@ -262,12 +266,12 @@ export function declareClient<Options extends ClientOptions>({
262
266
  ) => void | Promise<void>
263
267
  },
264
268
  ) {
269
+ // @ts-expect-error endpoint types are compatible at runtime
265
270
  return makeMutation(endpoint, {
266
- processResponse: options.processResponse,
267
- useContext: options.useContext,
268
- onSuccess: options.onSuccess,
269
- // @ts-expect-error simplify types here
270
- onError: options.onError,
271
+ processResponse: options?.processResponse,
272
+ useContext: options?.useContext,
273
+ onSuccess: options?.onSuccess,
274
+ onError: options?.onError,
271
275
  ...defaults,
272
276
  })
273
277
  }