@confect/react 1.0.0-next.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @confect/react
+
+## 1.0.0-next.0
+
+### Major Changes
+
+- 2ff70a7: Initial release.
+
+### Patch Changes
+
+- Updated dependencies [2ff70a7]
+  - @confect/core@1.0.0-next.0

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2024 RJ Dellecese
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import * as Ref from "@confect/core/Ref";
+import { Effect, Option } from "effect";
+
+//#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"]>;
+//#endregion
+export { useAction, useMutation, useQuery };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;cAQa,yBAA0B,GAAA,CAAI,qBACpC,aACC,GAAA,CAAI,KAAK,mBACd,MAAA,CAAO,OAAO,GAAA,CAAI,QAAQ;cAoBhB,+BAAgC,GAAA,CAAI,wBAC1C,oBAOG,GAAA,CAAI,KAAK,sBACd,MAAA,CAAO,OAAO,GAAA,CAAI,QAAQ;AAhClB,cA4CA,SAvBZ,EAAA,CAAA,eAuBwC,GAAA,CAAI,eAvB5C,CAAA,CAAA,GAAA,EAuBkE,MAvBlE,EAAA,GAAA,CAAA,IAAA,EA6BS,GAAA,CAAI,IA7Bb,CA6BkB,MA7BlB,CAAA,CAAA,MAAA,CAAA,EAAA,GA8BI,MAAA,CAAO,MA9BX,CA8BkB,GAAA,CAAI,OA9BtB,CA8B8B,MA9B9B,CAAA,CAAA,MAAA,CAAA,CAAA"}

package/dist/index.js

@@ -0,0 +1,33 @@
+import * as Ref from "@confect/core/Ref";
+import { useAction as useAction$1, useMutation as useMutation$1, useQuery as useQuery$1 } from "convex/react";
+import { Effect, Option, 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));
+};
+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);
+};
+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);
+};
+
+//#endregion
+export { useAction, useMutation, useQuery };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@confect/react",
+  "version": "1.0.0-next.0",
+  "description": "Confect React hooks",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rjdellecese/confect.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rjdellecese/confect/issues"
+  },
+  "homepage": "https://confect.rjdellecese.com",
+  "sideEffects": false,
+  "type": "module",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "dist",
+    "package.json",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "effect",
+    "convex",
+    "react"
+  ],
+  "author": "RJ Dellecese",
+  "license": "ISC",
+  "devDependencies": {
+    "@effect/language-service": "0.56.0",
+    "@eslint/js": "9.39.1",
+    "@tsconfig/strictest": "2.0.8",
+    "@types/node": "24.10.1",
+    "eslint": "9.39.1",
+    "prettier": "3.6.2",
+    "tsdown": "0.16.4",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.46.4"
+  },
+  "peerDependencies": {
+    "convex": "^1.30.0",
+    "effect": "^3.19.3",
+    "react": "^18.0.0 || ^19.0.0",
+    "@confect/core": "1.0.0-next.0"
+  },
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsdown --config-loader unrun",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "fix": "prettier --write . && eslint --fix . --max-warnings=0",
+    "lint": "prettier --check . && eslint . --max-warnings=0",
+    "clean": "rm -rf dist coverage node_modules"
+  }
+}

package/src/index.ts

@@ -0,0 +1,70 @@
+import * as Ref from "@confect/core/Ref";
+import {
+  useAction as useConvexAction,
+  useMutation as useConvexMutation,
+  useQuery as useConvexQuery,
+} from "convex/react";
+import { Effect, Option, Schema } from "effect";
+
+export const useQuery = <Query extends Ref.AnyPublicQuery>(
+  ref: Query,
+  args: Ref.Args<Query>["Type"],
+): Option.Option<Ref.Returns<Query>["Type"]> => {
+  const function_ = Ref.getFunction(ref);
+  const functionName = Ref.getConvexFunctionName(ref);
+
+  const encodedArgs = Schema.encodeSync(function_.args)(args);
+
+  const encodedReturnsOrUndefined = useConvexQuery(
+    functionName as any,
+    encodedArgs,
+  );
+
+  if (encodedReturnsOrUndefined === undefined) {
+    return Option.none();
+  } else {
+    return Option.some(
+      Schema.decodeSync(function_.returns)(encodedReturnsOrUndefined),
+    );
+  }
+};
+
+export const useMutation = <Mutation extends Ref.AnyPublicMutation>(
+  ref: Mutation,
+) => {
+  const function_ = Ref.getFunction(ref);
+  const functionName = Ref.getConvexFunctionName(ref);
+  const actualMutation = useConvexMutation(functionName as any);
+
+  return (
+    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);
+};
+
+export const useAction = <Action extends Ref.AnyPublicAction>(ref: Action) => {
+  const function_ = Ref.getFunction(ref);
+  const functionName = Ref.getConvexFunctionName(ref);
+  const actualAction = useConvexAction(functionName as any);
+
+  return (
+    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);
+};