effect-query 0.0.1-alpha.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Voidhash s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,140 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __tanstack_react_query = require("@tanstack/react-query");
+__tanstack_react_query = __toESM(__tanstack_react_query);
+let effect = require("effect");
+effect = __toESM(effect);
+
+//#region \0@oxc-project+runtime@0.95.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region src/errors.ts
+var EffectQueryError = class extends Error {
+	constructor(message, cause) {
+		super(message);
+		_defineProperty(this, "cause", void 0);
+		this.cause = cause;
+	}
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+//#region src/index.ts
+function createEffectQuery(layer) {
+	const runtime = effect.ManagedRuntime.make(layer);
+	const runner = (span, options = {}) => (effect$1) => runtime.runPromiseExit(effect$1.pipe(effect.Effect.withSpan(span), effect.Effect.scoped, effect.Effect.tapErrorCause(effect.Effect.logError)), { signal: options.signal });
+	return {
+		queryOptions: (options) => {
+			const [spanName] = options.queryKey;
+			const queryFn = async (context) => {
+				const result = await options.queryFn(context).pipe(runner(spanName, { signal: context.signal }));
+				return effect.Exit.match(result, {
+					onSuccess: (value) => value,
+					onFailure: (cause) => {
+						throw new EffectQueryError(effect.Cause.pretty(cause), cause);
+					}
+				});
+			};
+			return (0, __tanstack_react_query.queryOptions)(_objectSpread2(_objectSpread2({}, options), {}, { queryFn }));
+		},
+		mutationOptions: (options) => {
+			const spanName = options.mutationKey;
+			const mutationFn = async (variables) => {
+				const result = await options.mutationFn(variables).pipe(runner(spanName));
+				return effect.Exit.match(result, {
+					onSuccess: (value) => value,
+					onFailure: (cause) => {
+						throw new EffectQueryError(effect.Cause.pretty(cause), cause);
+					}
+				});
+			};
+			return (0, __tanstack_react_query.mutationOptions)(_objectSpread2(_objectSpread2({}, options), {}, { mutationFn }));
+		}
+	};
+}
+
+//#endregion
+exports.createEffectQuery = createEffectQuery;

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import { UseMutationOptions, UseQueryOptions, skipToken } from "@tanstack/react-query";
+import { Cause, Effect, Layer, Scope } from "effect";
+
+//#region src/errors.d.ts
+declare class EffectQueryError<TCause extends Cause.Cause<any>> extends Error {
+  readonly cause: TCause;
+  constructor(message: string, cause: TCause);
+}
+//#endregion
+//#region src/index.d.ts
+declare function createEffectQuery<Input>(layer: Layer.Layer<Input, never, never>): {
+  queryOptions: <TData, E, R extends Input | Scope.Scope, TQueryKey extends QueryKey = QueryKey>(options: Omit<UseQueryOptions<TData, E, TData, TQueryKey>, "queryKey" | "queryFn"> & {
+    queryKey: TQueryKey;
+    queryFn: typeof skipToken | ((context: {
+      client: _tanstack_react_query0.QueryClient;
+      queryKey: TQueryKey;
+      signal: AbortSignal;
+      meta: _tanstack_react_query0.QueryMeta | undefined;
+      pageParam?: unknown;
+      direction?: unknown;
+    }) => Effect.Effect<TData, E, R>);
+  }) => UseQueryOptions<TData, E extends never ? never : EffectQueryError<Cause.Cause<E>>, TData, TQueryKey>;
+  mutationOptions: <TData, E, TVariables, R extends Input | Scope.Scope>(options: Omit<UseMutationOptions<TData, Error, TVariables, unknown>, "mutationKey" | "mutationFn"> & {
+    mutationKey: string;
+    mutationFn: typeof skipToken | ((variables: TVariables) => Effect.Effect<TData, E, R>);
+  }) => UseMutationOptions<TData, E extends never ? never : EffectQueryError<Cause.Cause<E>>, TVariables>;
+};
+type QueryKey = readonly [string, string, Record<string, unknown>?];
+//#endregion
+export { createEffectQuery };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;cAEa,gCAAgC,KAAA,CAAM,oBAAoB,KAAA;kBAC5C;sCACW;;;;iBCgBtB,gCACP,KAAA,CAAM,MAAM;qCA0Ed,QAAA,KAAA,CAAA,yBACiB,WAAQ,mBAAA,KAAA,gBAAA,OAAA,GAAA,OAAA;ID9FnB,QAAA,WAAgB;IAAsB,OAAA,EAAA,gBAAA,GAAA,CAAA,CAAA,OAAA,EAAA;MACxB,MAAA,oCAAA;MACW,QAAA,WAAA;MAFiC,MAAA,aAAA;MAAK,IAAA,qCAAA,SAAA;;;;ECkB5D,CAAA,EAAA,GAsGJ,eAtGqB,CAuGzB,KAvGyB,EAwGzB,CAxGyB,SAAA,KAAA,GAAA,KAAA,GAwGC,gBAxGD,CAwGkB,KAAA,CAAM,KAxGxB,CAwG8B,CAxG9B,CAAA,CAAA,EAyGzB,KAzGyB,EA0GzB,SA1GyB,CAAA;EACZ,eAAA,EAAA,CAAA,KAAA,EAAA,CAAA,EAAA,UAAA,EAAA,UA4GwB,KA5GxB,GA4GwB,KAAA,CAAA,KA5GxB,CAAA,CAAA,OAAA,EA4GwB,IA5GxB,CA4GwB,kBA5GxB,CA4GwB,KA5GxB,EA4GwB,KA5GxB,EA4GwB,UA5GxB,EAAA,OAAA,CAAA,EAAA,aAAA,GAAA,YAAA,CAAA,GAAA;IAAN,WAAA,EAAA,MAAA;IA0ER,UAAA,EAAA,gBAAA,GAAA,CAAA,CAAA,SAAA,YAAA,EAAA,gBAAA,MAAA,GAAA,GAAA,CAAA,CAAA;EAAA,CAAA,EAAA,GA6DK,kBA7DL,CA8DC,KA9DD,EA+DC,CA/DD,SAAA,KAAA,GAAA,KAAA,GA+D2B,gBA/D3B,CA+D4C,KAAA,CAAM,KA/DlD,CA+DwD,CA/DxD,CAAA,CAAA,EAgEC,UAhED,CAAA;CACiB;KAqEnB,QAAA,GArE2B,SAAA,CAAA,MAAA,EAAA,MAAA,EAqEU,MArEV,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA"}

package/dist/index.d.mts

@@ -0,0 +1,32 @@
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import { UseMutationOptions, UseQueryOptions, skipToken } from "@tanstack/react-query";
+import { Cause, Effect, Layer, Scope } from "effect";
+
+//#region src/errors.d.ts
+declare class EffectQueryError<TCause extends Cause.Cause<any>> extends Error {
+  readonly cause: TCause;
+  constructor(message: string, cause: TCause);
+}
+//#endregion
+//#region src/index.d.ts
+declare function createEffectQuery<Input>(layer: Layer.Layer<Input, never, never>): {
+  queryOptions: <TData, E, R extends Input | Scope.Scope, TQueryKey extends QueryKey = QueryKey>(options: Omit<UseQueryOptions<TData, E, TData, TQueryKey>, "queryKey" | "queryFn"> & {
+    queryKey: TQueryKey;
+    queryFn: typeof skipToken | ((context: {
+      client: _tanstack_react_query0.QueryClient;
+      queryKey: TQueryKey;
+      signal: AbortSignal;
+      meta: _tanstack_react_query0.QueryMeta | undefined;
+      pageParam?: unknown;
+      direction?: unknown;
+    }) => Effect.Effect<TData, E, R>);
+  }) => UseQueryOptions<TData, E extends never ? never : EffectQueryError<Cause.Cause<E>>, TData, TQueryKey>;
+  mutationOptions: <TData, E, TVariables, R extends Input | Scope.Scope>(options: Omit<UseMutationOptions<TData, Error, TVariables, unknown>, "mutationKey" | "mutationFn"> & {
+    mutationKey: string;
+    mutationFn: typeof skipToken | ((variables: TVariables) => Effect.Effect<TData, E, R>);
+  }) => UseMutationOptions<TData, E extends never ? never : EffectQueryError<Cause.Cause<E>>, TVariables>;
+};
+type QueryKey = readonly [string, string, Record<string, unknown>?];
+//#endregion
+export { createEffectQuery };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;cAEa,gCAAgC,KAAA,CAAM,oBAAoB,KAAA;kBAC5C;sCACW;;;;iBCgBtB,gCACP,KAAA,CAAM,MAAM;qCA0Ed,QAAA,KAAA,CAAA,yBACiB,WAAQ,mBAAA,KAAA,gBAAA,OAAA,GAAA,OAAA;ID9FnB,QAAA,WAAgB;IAAsB,OAAA,EAAA,gBAAA,GAAA,CAAA,CAAA,OAAA,EAAA;MACxB,MAAA,oCAAA;MACW,QAAA,WAAA;MAFiC,MAAA,aAAA;MAAK,IAAA,qCAAA,SAAA;;;;ECkB5D,CAAA,EAAA,GAsGJ,eAtGqB,CAuGzB,KAvGyB,EAwGzB,CAxGyB,SAAA,KAAA,GAAA,KAAA,GAwGC,gBAxGD,CAwGkB,KAAA,CAAM,KAxGxB,CAwG8B,CAxG9B,CAAA,CAAA,EAyGzB,KAzGyB,EA0GzB,SA1GyB,CAAA;EACZ,eAAA,EAAA,CAAA,KAAA,EAAA,CAAA,EAAA,UAAA,EAAA,UA4GwB,KA5GxB,GA4GwB,KAAA,CAAA,KA5GxB,CAAA,CAAA,OAAA,EA4GwB,IA5GxB,CA4GwB,kBA5GxB,CA4GwB,KA5GxB,EA4GwB,KA5GxB,EA4GwB,UA5GxB,EAAA,OAAA,CAAA,EAAA,aAAA,GAAA,YAAA,CAAA,GAAA;IAAN,WAAA,EAAA,MAAA;IA0ER,UAAA,EAAA,gBAAA,GAAA,CAAA,CAAA,SAAA,YAAA,EAAA,gBAAA,MAAA,GAAA,GAAA,CAAA,CAAA;EAAA,CAAA,EAAA,GA6DK,kBA7DL,CA8DC,KA9DD,EA+DC,CA/DD,SAAA,KAAA,GAAA,KAAA,GA+D2B,gBA/D3B,CA+D4C,KAAA,CAAM,KA/DlD,CA+DwD,CA/DxD,CAAA,CAAA,EAgEC,UAhED,CAAA;CACiB;KAqEnB,QAAA,GArE2B,SAAA,CAAA,MAAA,EAAA,MAAA,EAqEU,MArEV,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA"}

package/dist/index.mjs

@@ -0,0 +1,116 @@
+import { mutationOptions, queryOptions } from "@tanstack/react-query";
+import { Cause, Effect, Exit, ManagedRuntime } from "effect";
+
+//#region \0@oxc-project+runtime@0.95.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region src/errors.ts
+var EffectQueryError = class extends Error {
+	constructor(message, cause) {
+		super(message);
+		_defineProperty(this, "cause", void 0);
+		this.cause = cause;
+	}
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.95.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+//#region src/index.ts
+function createEffectQuery(layer) {
+	const runtime = ManagedRuntime.make(layer);
+	const runner = (span, options = {}) => (effect) => runtime.runPromiseExit(effect.pipe(Effect.withSpan(span), Effect.scoped, Effect.tapErrorCause(Effect.logError)), { signal: options.signal });
+	return {
+		queryOptions: (options) => {
+			const [spanName] = options.queryKey;
+			const queryFn = async (context) => {
+				const result = await options.queryFn(context).pipe(runner(spanName, { signal: context.signal }));
+				return Exit.match(result, {
+					onSuccess: (value) => value,
+					onFailure: (cause) => {
+						throw new EffectQueryError(Cause.pretty(cause), cause);
+					}
+				});
+			};
+			return queryOptions(_objectSpread2(_objectSpread2({}, options), {}, { queryFn }));
+		},
+		mutationOptions: (options) => {
+			const spanName = options.mutationKey;
+			const mutationFn = async (variables) => {
+				const result = await options.mutationFn(variables).pipe(runner(spanName));
+				return Exit.match(result, {
+					onSuccess: (value) => value,
+					onFailure: (cause) => {
+						throw new EffectQueryError(Cause.pretty(cause), cause);
+					}
+				});
+			};
+			return mutationOptions(_objectSpread2(_objectSpread2({}, options), {}, { mutationFn }));
+		}
+	};
+}
+
+//#endregion
+export { createEffectQuery };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["queryFn: QueryFunction<TData, TQueryKey>","mutationFn: MutationFunction<TData, TVariables>"],"sources":["../src/errors.ts","../src/index.ts"],"sourcesContent":["import type { Cause } from \"effect\";\n// biome-ignore lint/suspicious/noExplicitAny: Generic type for cause\nexport class EffectQueryError<TCause extends Cause.Cause<any>> extends Error {\n  override readonly cause: TCause;\n  constructor(message: string, cause: TCause) {\n    super(message);\n    this.cause = cause;\n  }\n}\n","import {\n  type MutationFunction,\n  mutationOptions,\n  type QueryFunction,\n  type QueryFunctionContext,\n  queryOptions,\n  type skipToken,\n  type UseMutationOptions,\n  type UseQueryOptions,\n} from \"@tanstack/react-query\";\nimport {\n  Cause,\n  Effect,\n  Exit,\n  type Layer,\n  ManagedRuntime,\n  type Scope,\n} from \"effect\";\nimport { EffectQueryError } from \"./errors\";\n\nexport function createEffectQuery<Input>(\n  layer: Layer.Layer<Input, never, never>\n) {\n  type RuntimeContext = Input | Scope.Scope;\n\n  type EffectfulMutationFunction<\n    TData,\n    E,\n    TVariables,\n    R extends RuntimeContext,\n  > = (variables: TVariables) => Effect.Effect<TData, E, R>;\n\n  type EffectfulMutationOptions<\n    TData,\n    E,\n    TVariables,\n    R extends RuntimeContext,\n  > = Omit<\n    UseMutationOptions<TData, Error, TVariables>,\n    \"mutationKey\" | \"mutationFn\"\n  > & {\n    mutationKey: string;\n    mutationFn:\n      | EffectfulMutationFunction<TData, E, TVariables, R>\n      | typeof skipToken;\n  };\n\n  type EffectfulQueryFunction<\n    TData,\n    E,\n    R,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam = never,\n  > = (\n    context: QueryFunctionContext<TQueryKey, TPageParam>\n  ) => Effect.Effect<TData, E, R>;\n\n  type EffectfulQueryOptions<\n    TData,\n    TError,\n    R,\n    TQueryKey extends QueryKey = QueryKey,\n    TPageParam = never,\n  > = Omit<\n    UseQueryOptions<TData, TError, TData, TQueryKey>,\n    \"queryKey\" | \"queryFn\"\n  > & {\n    queryKey: TQueryKey;\n    queryFn:\n      | EffectfulQueryFunction<TData, TError, R, TQueryKey, TPageParam>\n      | typeof skipToken;\n  };\n\n  const runtime = ManagedRuntime.make(layer);\n  const runner =\n    <A, E, R extends RuntimeContext>(\n      span: string,\n      options: { signal?: AbortSignal } = {}\n    ) =>\n    (effect: Effect.Effect<A, E, R>): Promise<Exit.Exit<A, E>> =>\n      runtime.runPromiseExit(\n        effect.pipe(\n          Effect.withSpan(span),\n          Effect.scoped,\n          Effect.tapErrorCause(Effect.logError)\n        ),\n        {\n          signal: options.signal,\n        }\n      );\n\n  return {\n    queryOptions: <\n      TData,\n      E,\n      R extends RuntimeContext,\n      TQueryKey extends QueryKey = QueryKey,\n    >(\n      options: EffectfulQueryOptions<TData, E, R, TQueryKey>\n    ) => {\n      const [spanName] = options.queryKey;\n\n      const queryFn: QueryFunction<TData, TQueryKey> = async (\n        context: QueryFunctionContext<TQueryKey>\n      ) => {\n        const effect = (\n          options.queryFn as EffectfulQueryFunction<TData, E, R, TQueryKey>\n        )(context);\n        const result = await effect.pipe(\n          runner(spanName, { signal: context.signal })\n        );\n        return Exit.match(result, {\n          onSuccess: (value) => value,\n          onFailure: (cause) => {\n            throw new EffectQueryError(Cause.pretty(cause), cause);\n          },\n        });\n      };\n\n      return queryOptions({\n        ...options,\n        queryFn,\n      }) as UseQueryOptions<\n        TData,\n        E extends never ? never : EffectQueryError<Cause.Cause<E>>,\n        TData,\n        TQueryKey\n      >;\n    },\n    mutationOptions: <TData, E, TVariables, R extends RuntimeContext>(\n      options: EffectfulMutationOptions<TData, E, TVariables, R>\n    ) => {\n      const spanName = options.mutationKey;\n      const mutationFn: MutationFunction<TData, TVariables> = async (\n        variables: TVariables\n      ) => {\n        const effect = (\n          options.mutationFn as EffectfulMutationFunction<\n            TData,\n            E,\n            TVariables,\n            R\n          >\n        )(variables);\n        const result = await effect.pipe(runner(spanName));\n        return Exit.match(result, {\n          onSuccess: (value) => value,\n          onFailure: (cause) => {\n            throw new EffectQueryError(Cause.pretty(cause), cause);\n          },\n        });\n      };\n\n      return mutationOptions({\n        ...options,\n        mutationFn,\n      }) as UseMutationOptions<\n        TData,\n        E extends never ? never : EffectQueryError<Cause.Cause<E>>,\n        TVariables\n      >;\n    },\n  };\n}\n\ntype QueryKey = readonly [string, string, Record<string, unknown>?];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,IAAa,mBAAb,cAAuE,MAAM;CAE3E,YAAY,SAAiB,OAAe;AAC1C,QAAM,QAAQ;wBAFE;AAGhB,OAAK,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACcjB,SAAgB,kBACd,OACA;CAmDA,MAAM,UAAU,eAAe,KAAK,MAAM;CAC1C,MAAM,UAEF,MACA,UAAoC,EAAE,MAEvC,WACC,QAAQ,eACN,OAAO,KACL,OAAO,SAAS,KAAK,EACrB,OAAO,QACP,OAAO,cAAc,OAAO,SAAS,CACtC,EACD,EACE,QAAQ,QAAQ,QACjB,CACF;AAEL,QAAO;EACL,eAME,YACG;GACH,MAAM,CAAC,YAAY,QAAQ;GAE3B,MAAMA,UAA2C,OAC/C,YACG;IAIH,MAAM,SAAS,MAFb,QAAQ,QACR,QAAQ,CACkB,KAC1B,OAAO,UAAU,EAAE,QAAQ,QAAQ,QAAQ,CAAC,CAC7C;AACD,WAAO,KAAK,MAAM,QAAQ;KACxB,YAAY,UAAU;KACtB,YAAY,UAAU;AACpB,YAAM,IAAI,iBAAiB,MAAM,OAAO,MAAM,EAAE,MAAM;;KAEzD,CAAC;;AAGJ,UAAO,+CACF,gBACH,WACA;;EAOJ,kBACE,YACG;GACH,MAAM,WAAW,QAAQ;GACzB,MAAMC,aAAkD,OACtD,cACG;IASH,MAAM,SAAS,MAPb,QAAQ,WAMR,UAAU,CACgB,KAAK,OAAO,SAAS,CAAC;AAClD,WAAO,KAAK,MAAM,QAAQ;KACxB,YAAY,UAAU;KACtB,YAAY,UAAU;AACpB,YAAM,IAAI,iBAAiB,MAAM,OAAO,MAAM,EAAE,MAAM;;KAEzD,CAAC;;AAGJ,UAAO,kDACF,gBACH,cACA;;EAML"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "effect-query",
+  "version": "0.0.1-alpha.1",
+  "description": "Effect adapter for Tanstack Query",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voidhashcom/effect-query.git"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "package.json",
+    "!**/*.test.*",
+    "!**/__tests__"
+  ],
+  "author": "Dominik Vít <dominik@voidhash.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "^2.2.6",
+    "@tanstack/react-query": "^5.90.5",
+    "effect": "^3.18.4",
+    "react": "^19.2.0",
+    "tsdown": "^0.15.9",
+    "ultracite": "^5.6.4",
+    "vitest": "^4.0.1"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.90.5",
+    "effect": "^3.18.4",
+    "react": "^19.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit --pretty"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,9 @@
+import type { Cause } from "effect";
+// biome-ignore lint/suspicious/noExplicitAny: Generic type for cause
+export class EffectQueryError<TCause extends Cause.Cause<any>> extends Error {
+  override readonly cause: TCause;
+  constructor(message: string, cause: TCause) {
+    super(message);
+    this.cause = cause;
+  }
+}

package/src/index.ts

@@ -0,0 +1,166 @@
+import {
+  type MutationFunction,
+  mutationOptions,
+  type QueryFunction,
+  type QueryFunctionContext,
+  queryOptions,
+  type skipToken,
+  type UseMutationOptions,
+  type UseQueryOptions,
+} from "@tanstack/react-query";
+import {
+  Cause,
+  Effect,
+  Exit,
+  type Layer,
+  ManagedRuntime,
+  type Scope,
+} from "effect";
+import { EffectQueryError } from "./errors";
+
+export function createEffectQuery<Input>(
+  layer: Layer.Layer<Input, never, never>
+) {
+  type RuntimeContext = Input | Scope.Scope;
+
+  type EffectfulMutationFunction<
+    TData,
+    E,
+    TVariables,
+    R extends RuntimeContext,
+  > = (variables: TVariables) => Effect.Effect<TData, E, R>;
+
+  type EffectfulMutationOptions<
+    TData,
+    E,
+    TVariables,
+    R extends RuntimeContext,
+  > = Omit<
+    UseMutationOptions<TData, Error, TVariables>,
+    "mutationKey" | "mutationFn"
+  > & {
+    mutationKey: string;
+    mutationFn:
+      | EffectfulMutationFunction<TData, E, TVariables, R>
+      | typeof skipToken;
+  };
+
+  type EffectfulQueryFunction<
+    TData,
+    E,
+    R,
+    TQueryKey extends QueryKey = QueryKey,
+    TPageParam = never,
+  > = (
+    context: QueryFunctionContext<TQueryKey, TPageParam>
+  ) => Effect.Effect<TData, E, R>;
+
+  type EffectfulQueryOptions<
+    TData,
+    TError,
+    R,
+    TQueryKey extends QueryKey = QueryKey,
+    TPageParam = never,
+  > = Omit<
+    UseQueryOptions<TData, TError, TData, TQueryKey>,
+    "queryKey" | "queryFn"
+  > & {
+    queryKey: TQueryKey;
+    queryFn:
+      | EffectfulQueryFunction<TData, TError, R, TQueryKey, TPageParam>
+      | typeof skipToken;
+  };
+
+  const runtime = ManagedRuntime.make(layer);
+  const runner =
+    <A, E, R extends RuntimeContext>(
+      span: string,
+      options: { signal?: AbortSignal } = {}
+    ) =>
+    (effect: Effect.Effect<A, E, R>): Promise<Exit.Exit<A, E>> =>
+      runtime.runPromiseExit(
+        effect.pipe(
+          Effect.withSpan(span),
+          Effect.scoped,
+          Effect.tapErrorCause(Effect.logError)
+        ),
+        {
+          signal: options.signal,
+        }
+      );
+
+  return {
+    queryOptions: <
+      TData,
+      E,
+      R extends RuntimeContext,
+      TQueryKey extends QueryKey = QueryKey,
+    >(
+      options: EffectfulQueryOptions<TData, E, R, TQueryKey>
+    ) => {
+      const [spanName] = options.queryKey;
+
+      const queryFn: QueryFunction<TData, TQueryKey> = async (
+        context: QueryFunctionContext<TQueryKey>
+      ) => {
+        const effect = (
+          options.queryFn as EffectfulQueryFunction<TData, E, R, TQueryKey>
+        )(context);
+        const result = await effect.pipe(
+          runner(spanName, { signal: context.signal })
+        );
+        return Exit.match(result, {
+          onSuccess: (value) => value,
+          onFailure: (cause) => {
+            throw new EffectQueryError(Cause.pretty(cause), cause);
+          },
+        });
+      };
+
+      return queryOptions({
+        ...options,
+        queryFn,
+      }) as UseQueryOptions<
+        TData,
+        E extends never ? never : EffectQueryError<Cause.Cause<E>>,
+        TData,
+        TQueryKey
+      >;
+    },
+    mutationOptions: <TData, E, TVariables, R extends RuntimeContext>(
+      options: EffectfulMutationOptions<TData, E, TVariables, R>
+    ) => {
+      const spanName = options.mutationKey;
+      const mutationFn: MutationFunction<TData, TVariables> = async (
+        variables: TVariables
+      ) => {
+        const effect = (
+          options.mutationFn as EffectfulMutationFunction<
+            TData,
+            E,
+            TVariables,
+            R
+          >
+        )(variables);
+        const result = await effect.pipe(runner(spanName));
+        return Exit.match(result, {
+          onSuccess: (value) => value,
+          onFailure: (cause) => {
+            throw new EffectQueryError(Cause.pretty(cause), cause);
+          },
+        });
+      };
+
+      return mutationOptions({
+        ...options,
+        mutationFn,
+      }) as UseMutationOptions<
+        TData,
+        E extends never ? never : EffectQueryError<Cause.Cause<E>>,
+        TVariables
+      >;
+    },
+  };
+}
+
+type QueryKey = readonly [string, string, Record<string, unknown>?];