@confect/react 1.0.2 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @confect/react
 
+## 2.0.0
+
+### Major Changes
+
+- 7861159: Replace Effect-native return types with Convex-equivalent return types in React hooks. `useQuery` now returns `T | undefined` instead of `Option<T>`. `useMutation` and `useAction` now return `(args) => Promise<T>` instead of `(args) => Effect<T>`. The hooks still encode args and decode return values via the spec's Effect Schemas automatically.
+
+### Patch Changes
+
+- @confect/core@2.0.0
+
+## 1.0.3
+
+### Patch Changes
+
+- @confect/core@1.0.3
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,10 +1,9 @@
-import * as Ref from "@confect/core/Ref";
-import { Effect, Option } from "effect";
+import { Ref } from "@confect/core";
 
 //#region src/index.d.ts
-declare const useQuery: <Query extends Ref.AnyPublicQuery>(ref: Query, args: Ref.Args<Query>["Type"]) => Option.Option<Ref.Returns<Query>["Type"]>;
-declare const useMutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation) => (args: Ref.Args<Mutation>["Type"]) => Effect.Effect<Ref.Returns<Mutation>["Type"]>;
-declare const useAction: <Action extends Ref.AnyPublicAction>(ref: Action) => (args: Ref.Args<Action>["Type"]) => Effect.Effect<Ref.Returns<Action>["Type"]>;
+declare const useQuery: <Query extends Ref.AnyPublicQuery>(ref: Query, args: Ref.Args<Query>["Type"]) => Ref.Returns<Query>["Type"] | undefined;
+declare const useMutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation) => (args: Ref.Args<Mutation>["Type"]) => Promise<Ref.Returns<Mutation>["Type"]>;
+declare const useAction: <Action extends Ref.AnyPublicAction>(ref: Action) => (args: Ref.Args<Action>["Type"]) => Promise<Ref.Returns<Action>["Type"]>;
 //#endregion
 export { useAction, useMutation, useQuery };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAQa,QAAA,iBAA0B,GAAA,CAAI,cAAA,EACzC,GAAA,EAAK,KAAA,EACL,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,KAAA,cACd,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,KAAA;AAAA,cAoBhB,WAAA,oBAAgC,GAAA,CAAI,iBAAA,EAC/C,GAAA,EAAK,QAAA,MAOH,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,QAAA,cACd,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,QAAA;AAAA,cAYlB,SAAA,kBAA4B,GAAA,CAAI,eAAA,EAAiB,GAAA,EAAK,MAAA,MAM/D,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,MAAA,cACd,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAQa,QAAA,iBAA0B,GAAA,CAAI,cAAA,EACzC,GAAA,EAAK,KAAA,EACL,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,KAAA,cACd,GAAA,CAAI,OAAA,CAAQ,KAAA;AAAA,cAkBF,WAAA,oBAAgC,GAAA,CAAI,iBAAA,EAC/C,GAAA,EAAK,QAAA,MAOH,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,QAAA,cACd,OAAA,CAAQ,GAAA,CAAI,OAAA,CAAQ,QAAA;AAAA,cAOZ,SAAA,kBAA4B,GAAA,CAAI,eAAA,EAAiB,GAAA,EAAK,MAAA,MAM/D,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,MAAA,cACd,OAAA,CAAQ,GAAA,CAAI,OAAA,CAAQ,MAAA"}

package/dist/index.js

@@ -1,31 +1,29 @@
-import * as Ref from "@confect/core/Ref";
+import { Ref } from "@confect/core";
 import { useAction as useAction$1, useMutation as useMutation$1, useQuery as useQuery$1 } from "convex/react";
-import { Effect, Option, Schema } from "effect";
+import { Schema } from "effect";
 
 //#region src/index.ts
 const useQuery = (ref, args) => {
 	const function_ = Ref.getFunction(ref);
 	const encodedReturnsOrUndefined = useQuery$1(Ref.getConvexFunctionName(ref), Schema.encodeSync(function_.args)(args));
-	if (encodedReturnsOrUndefined === void 0) return Option.none();
-	else return Option.some(Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined));
+	if (encodedReturnsOrUndefined === void 0) return;
+	else return Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined);
 };
 const useMutation = (ref) => {
 	const function_ = Ref.getFunction(ref);
 	const actualMutation = useMutation$1(Ref.getConvexFunctionName(ref));
-	return (args) => Effect.gen(function* () {
-		const encodedArgs = yield* Schema.encode(function_.args)(args);
-		const actualReturns = yield* Effect.promise(() => actualMutation(encodedArgs));
-		return yield* Schema.decode(function_.returns)(actualReturns);
-	}).pipe(Effect.orDie);
+	return async (args) => {
+		const actualReturns = await actualMutation(Schema.encodeSync(function_.args)(args));
+		return Schema.decodeSync(function_.returns)(actualReturns);
+	};
 };
 const useAction = (ref) => {
 	const function_ = Ref.getFunction(ref);
 	const actualAction = useAction$1(Ref.getConvexFunctionName(ref));
-	return (args) => Effect.gen(function* () {
-		const encodedArgs = yield* Schema.encode(function_.args)(args);
-		const actualReturns = yield* Effect.promise(() => actualAction(encodedArgs));
-		return yield* Schema.decode(function_.returns)(actualReturns);
-	}).pipe(Effect.orDie);
+	return async (args) => {
+		const actualReturns = await actualAction(Schema.encodeSync(function_.args)(args));
+		return Schema.decodeSync(function_.returns)(actualReturns);
+	};
 };
 
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["useConvexQuery","useConvexMutation","useConvexAction"],"sources":["../src/index.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport {\n  useAction as useConvexAction,\n  useMutation as useConvexMutation,\n  useQuery as useConvexQuery,\n} from \"convex/react\";\nimport { Effect, Option, Schema } from \"effect\";\n\nexport const useQuery = <Query extends Ref.AnyPublicQuery>(\n  ref: Query,\n  args: Ref.Args<Query>[\"Type\"],\n): Option.Option<Ref.Returns<Query>[\"Type\"]> => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n\n  const encodedArgs = Schema.encodeSync(function_.args)(args);\n\n  const encodedReturnsOrUndefined = useConvexQuery(\n    functionName as any,\n    encodedArgs,\n  );\n\n  if (encodedReturnsOrUndefined === undefined) {\n    return Option.none();\n  } else {\n    return Option.some(\n      Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined),\n    );\n  }\n};\n\nexport const useMutation = <Mutation extends Ref.AnyPublicMutation>(\n  ref: Mutation,\n) => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n  const actualMutation = useConvexMutation(functionName as any);\n\n  return (\n    args: Ref.Args<Mutation>[\"Type\"],\n  ): Effect.Effect<Ref.Returns<Mutation>[\"Type\"]> =>\n    Effect.gen(function* () {\n      const encodedArgs = yield* Schema.encode(function_.args)(args);\n\n      const actualReturns = yield* Effect.promise(() =>\n        actualMutation(encodedArgs),\n      );\n\n      return yield* Schema.decode(function_.returns)(actualReturns);\n    }).pipe(Effect.orDie);\n};\n\nexport const useAction = <Action extends Ref.AnyPublicAction>(ref: Action) => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n  const actualAction = useConvexAction(functionName as any);\n\n  return (\n    args: Ref.Args<Action>[\"Type\"],\n  ): Effect.Effect<Ref.Returns<Action>[\"Type\"]> =>\n    Effect.gen(function* () {\n      const encodedArgs = yield* Schema.encode(function_.args)(args);\n\n      const actualReturns = yield* Effect.promise(() =>\n        actualAction(encodedArgs),\n      );\n\n      return yield* Schema.decode(function_.returns)(actualReturns);\n    }).pipe(Effect.orDie);\n};\n"],"mappings":";;;;;AAQA,MAAa,YACX,KACA,SAC8C;CAC9C,MAAM,YAAY,IAAI,YAAY,IAAI;CAKtC,MAAM,4BAA4BA,WAJb,IAAI,sBAAsB,IAAI,EAE/B,OAAO,WAAW,UAAU,KAAK,CAAC,KAAK,CAK1D;AAED,KAAI,8BAA8B,OAChC,QAAO,OAAO,MAAM;KAEpB,QAAO,OAAO,KACZ,OAAO,WAAW,UAAU,QAAQ,CAAC,0BAA0B,CAChE;;AAIL,MAAa,eACX,QACG;CACH,MAAM,YAAY,IAAI,YAAY,IAAI;CAEtC,MAAM,iBAAiBC,cADF,IAAI,sBAAsB,IAAI,CACU;AAE7D,SACE,SAEA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,OAAO,OAAO,UAAU,KAAK,CAAC,KAAK;EAE9D,MAAM,gBAAgB,OAAO,OAAO,cAClC,eAAe,YAAY,CAC5B;AAED,SAAO,OAAO,OAAO,OAAO,UAAU,QAAQ,CAAC,cAAc;GAC7D,CAAC,KAAK,OAAO,MAAM;;AAGzB,MAAa,aAAiD,QAAgB;CAC5E,MAAM,YAAY,IAAI,YAAY,IAAI;CAEtC,MAAM,eAAeC,YADA,IAAI,sBAAsB,IAAI,CACM;AAEzD,SACE,SAEA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,OAAO,OAAO,UAAU,KAAK,CAAC,KAAK;EAE9D,MAAM,gBAAgB,OAAO,OAAO,cAClC,aAAa,YAAY,CAC1B;AAED,SAAO,OAAO,OAAO,OAAO,UAAU,QAAQ,CAAC,cAAc;GAC7D,CAAC,KAAK,OAAO,MAAM"}
+{"version":3,"file":"index.js","names":["useConvexQuery","useConvexMutation","useConvexAction"],"sources":["../src/index.ts"],"sourcesContent":["import { Ref } from \"@confect/core\";\nimport {\n  useAction as useConvexAction,\n  useMutation as useConvexMutation,\n  useQuery as useConvexQuery,\n} from \"convex/react\";\nimport { Schema } from \"effect\";\n\nexport const useQuery = <Query extends Ref.AnyPublicQuery>(\n  ref: Query,\n  args: Ref.Args<Query>[\"Type\"],\n): Ref.Returns<Query>[\"Type\"] | undefined => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n\n  const encodedArgs = Schema.encodeSync(function_.args)(args);\n\n  const encodedReturnsOrUndefined = useConvexQuery(\n    functionName as any,\n    encodedArgs,\n  );\n\n  if (encodedReturnsOrUndefined === undefined) {\n    return undefined;\n  } else {\n    return Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined);\n  }\n};\n\nexport const useMutation = <Mutation extends Ref.AnyPublicMutation>(\n  ref: Mutation,\n) => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n  const actualMutation = useConvexMutation(functionName as any);\n\n  return async (\n    args: Ref.Args<Mutation>[\"Type\"],\n  ): Promise<Ref.Returns<Mutation>[\"Type\"]> => {\n    const encodedArgs = Schema.encodeSync(function_.args)(args);\n    const actualReturns = await actualMutation(encodedArgs);\n    return Schema.decodeSync(function_.returns)(actualReturns);\n  };\n};\n\nexport const useAction = <Action extends Ref.AnyPublicAction>(ref: Action) => {\n  const function_ = Ref.getFunction(ref);\n  const functionName = Ref.getConvexFunctionName(ref);\n  const actualAction = useConvexAction(functionName as any);\n\n  return async (\n    args: Ref.Args<Action>[\"Type\"],\n  ): Promise<Ref.Returns<Action>[\"Type\"]> => {\n    const encodedArgs = Schema.encodeSync(function_.args)(args);\n    const actualReturns = await actualAction(encodedArgs);\n    return Schema.decodeSync(function_.returns)(actualReturns);\n  };\n};\n"],"mappings":";;;;;AAQA,MAAa,YACX,KACA,SAC2C;CAC3C,MAAM,YAAY,IAAI,YAAY,IAAI;CAKtC,MAAM,4BAA4BA,WAJb,IAAI,sBAAsB,IAAI,EAE/B,OAAO,WAAW,UAAU,KAAK,CAAC,KAAK,CAK1D;AAED,KAAI,8BAA8B,OAChC;KAEA,QAAO,OAAO,WAAW,UAAU,QAAQ,CAAC,0BAA0B;;AAI1E,MAAa,eACX,QACG;CACH,MAAM,YAAY,IAAI,YAAY,IAAI;CAEtC,MAAM,iBAAiBC,cADF,IAAI,sBAAsB,IAAI,CACU;AAE7D,QAAO,OACL,SAC2C;EAE3C,MAAM,gBAAgB,MAAM,eADR,OAAO,WAAW,UAAU,KAAK,CAAC,KAAK,CACJ;AACvD,SAAO,OAAO,WAAW,UAAU,QAAQ,CAAC,cAAc;;;AAI9D,MAAa,aAAiD,QAAgB;CAC5E,MAAM,YAAY,IAAI,YAAY,IAAI;CAEtC,MAAM,eAAeC,YADA,IAAI,sBAAsB,IAAI,CACM;AAEzD,QAAO,OACL,SACyC;EAEzC,MAAM,gBAAgB,MAAM,aADR,OAAO,WAAW,UAAU,KAAK,CAAC,KAAK,CACN;AACrD,SAAO,OAAO,WAAW,UAAU,QAAQ,CAAC,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@confect/react",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Client-side bindings for React apps",
   "repository": {
     "type": "git",
@@ -35,20 +35,19 @@
   "author": "RJ Dellecese",
   "license": "ISC",
   "devDependencies": {
-    "@effect/language-service": "0.73.1",
-    "@eslint/js": "9.39.2",
-    "@types/node": "25.2.3",
-    "eslint": "9.39.2",
+    "@eslint/js": "10.0.1",
+    "@types/node": "25.3.3",
+    "eslint": "10.0.2",
     "prettier": "3.8.1",
     "tsdown": "0.20.3",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.55.0"
+    "typescript-eslint": "8.56.1"
   },
   "peerDependencies": {
     "convex": "^1.30.0",
     "effect": "^3.19.16",
     "react": "^18.0.0 || ^19.0.0",
-    "@confect/core": "1.0.2"
+    "@confect/core": "2.0.0"
   },
   "engines": {
     "node": ">=22",

package/src/index.ts

@@ -1,15 +1,15 @@
-import * as Ref from "@confect/core/Ref";
+import { Ref } from "@confect/core";
 import {
   useAction as useConvexAction,
   useMutation as useConvexMutation,
   useQuery as useConvexQuery,
 } from "convex/react";
-import { Effect, Option, Schema } from "effect";
+import { Schema } from "effect";
 
 export const useQuery = <Query extends Ref.AnyPublicQuery>(
   ref: Query,
   args: Ref.Args<Query>["Type"],
-): Option.Option<Ref.Returns<Query>["Type"]> => {
+): Ref.Returns<Query>["Type"] | undefined => {
   const function_ = Ref.getFunction(ref);
   const functionName = Ref.getConvexFunctionName(ref);
 
@@ -21,11 +21,9 @@ export const useQuery = <Query extends Ref.AnyPublicQuery>(
   );
 
   if (encodedReturnsOrUndefined === undefined) {
-    return Option.none();
+    return undefined;
   } else {
-    return Option.some(
-      Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined),
-    );
+    return Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined);
   }
 };
 
@@ -36,18 +34,13 @@ export const useMutation = <Mutation extends Ref.AnyPublicMutation>(
   const functionName = Ref.getConvexFunctionName(ref);
   const actualMutation = useConvexMutation(functionName as any);
 
-  return (
+  return async (
     args: Ref.Args<Mutation>["Type"],
-  ): Effect.Effect<Ref.Returns<Mutation>["Type"]> =>
-    Effect.gen(function* () {
-      const encodedArgs = yield* Schema.encode(function_.args)(args);
-
-      const actualReturns = yield* Effect.promise(() =>
-        actualMutation(encodedArgs),
-      );
-
-      return yield* Schema.decode(function_.returns)(actualReturns);
-    }).pipe(Effect.orDie);
+  ): Promise<Ref.Returns<Mutation>["Type"]> => {
+    const encodedArgs = Schema.encodeSync(function_.args)(args);
+    const actualReturns = await actualMutation(encodedArgs);
+    return Schema.decodeSync(function_.returns)(actualReturns);
+  };
 };
 
 export const useAction = <Action extends Ref.AnyPublicAction>(ref: Action) => {
@@ -55,16 +48,11 @@ export const useAction = <Action extends Ref.AnyPublicAction>(ref: Action) => {
   const functionName = Ref.getConvexFunctionName(ref);
   const actualAction = useConvexAction(functionName as any);
 
-  return (
+  return async (
     args: Ref.Args<Action>["Type"],
-  ): Effect.Effect<Ref.Returns<Action>["Type"]> =>
-    Effect.gen(function* () {
-      const encodedArgs = yield* Schema.encode(function_.args)(args);
-
-      const actualReturns = yield* Effect.promise(() =>
-        actualAction(encodedArgs),
-      );
-
-      return yield* Schema.decode(function_.returns)(actualReturns);
-    }).pipe(Effect.orDie);
+  ): Promise<Ref.Returns<Action>["Type"]> => {
+    const encodedArgs = Schema.encodeSync(function_.args)(args);
+    const actualReturns = await actualAction(encodedArgs);
+    return Schema.decodeSync(function_.returns)(actualReturns);
+  };
 };