@confect/js 4.0.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @confect/js
+
+## 4.0.0
+
+### Minor Changes
+
+- dbefea8: Add `HttpClient`, an Effect service wrapping Convex's `ConvexHttpClient` with automatic schema encoding and decoding. Works in any JavaScript runtime that supports `fetch`.
+
+### Patch Changes
+
+- @confect/core@4.0.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/README.md

@@ -0,0 +1,11 @@
+# Confect 🧁
+
+Confect is a framework that deeply integrates Effect with Convex. It's more than just Effect bindings! Confect allows you to:
+
+- Define your Convex database schema using Effect schemas.
+- Write Convex function args and returns validators using Effect's schema library.
+- Use Confect functions to automatically decode and encode your data according to your Effect schema definitions for end-to-end rich types, from client to function to database (and back).
+- Use Effect's HTTP API modules to define your HTTP API(s). Includes interactive OpenAPI documentation powered by [Scalar](https://github.com/scalar/scalar).
+- Access Convex platform capabilities via Effect services.
+
+Want to learn more? Read the [docs](https://confect.dev)!

package/dist/HttpClient.d.ts

@@ -0,0 +1,45 @@
+import * as Ref from "@confect/core/Ref";
+import { ConvexHttpClient } from "convex/browser";
+import { Context, Effect, Layer, ParseResult, Schema } from "effect";
+
+//#region src/HttpClient.d.ts
+declare namespace HttpClient_d_exports {
+  export { HttpClient, HttpClientError, layer };
+}
+declare const HttpClientError_base: Schema.TaggedErrorClass<HttpClientError, "HttpClientError", {
+  readonly _tag: Schema.tag<"HttpClientError">;
+} & {
+  cause: typeof Schema.Unknown;
+}>;
+declare class HttpClientError extends HttpClientError_base {}
+type OptionalArgs<R extends Ref.AnyQuery | Ref.AnyMutation | Ref.AnyAction> = keyof Ref.Args<R> extends never ? [args?: Ref.Args<R>] : [args: Ref.Args<R>];
+/**
+ * A Confect client which uses HTTP to communicate with your Convex backend. Works in any JS runtime that supports `fetch`. Wraps [ConvexHttpClient](https://docs.convex.dev/api/classes/browser.ConvexHttpClient).
+ */
+declare const HttpClient: Context.Tag<{
+  url: string;
+  setAuth: (token: string) => Effect.Effect<void, never, never>;
+  clearAuth: Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyQuery>(ref: Query, ...rest: OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyMutation>(ref: Mutation, ...rest: OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyAction>(ref: Action, ...rest: OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, HttpClientError | ParseResult.ParseError>;
+}, {
+  url: string;
+  setAuth: (token: string) => Effect.Effect<void, never, never>;
+  clearAuth: Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyQuery>(ref: Query, ...rest: OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyMutation>(ref: Mutation, ...rest: OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyAction>(ref: Action, ...rest: OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, HttpClientError | ParseResult.ParseError>;
+}>;
+type HttpClient = typeof HttpClient.Identifier;
+declare const layer: (address: string, options?: ConstructorParameters<typeof ConvexHttpClient>[1]) => Layer.Layer<{
+  url: string;
+  setAuth: (token: string) => Effect.Effect<void, never, never>;
+  clearAuth: Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyQuery>(ref: Query, ...rest: OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyMutation>(ref: Mutation, ...rest: OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyAction>(ref: Action, ...rest: OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, HttpClientError | ParseResult.ParseError>;
+}, never, never>;
+//#endregion
+export { HttpClient_d_exports };
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","names":[],"sources":["../src/HttpClient.ts"],"mappings":";;;;;;;;cAI+D,oBAAA;;;;;cAElD,eAAA,SAAwB,oBAAA;AAAA,KAOhC,YAAA,WAAuB,GAAA,CAAI,QAAA,GAAW,GAAA,CAAI,WAAA,GAAc,GAAA,CAAI,SAAA,UACzD,GAAA,CAAI,IAAA,CAAK,CAAA,mBAAoB,IAAA,GAAO,GAAA,CAAI,IAAA,CAAK,CAAA,MAAO,IAAA,EAAM,GAAA,CAAI,IAAA,CAAK,CAAA;;;;cA2J9D,UAAA,EAAU,OAAA,CAAA,GAAA;;8BAjJS,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,QAAA,EAAQ,GAAA,EAClC,KAAA,KAAK,IAAA,EACD,YAAA,CAAa,KAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAoCG,GAAA,CAAI,WAAA,EAAW,GAAA,EAC3C,QAAA,KAAQ,IAAA,EACJ,YAAA,CAAa,QAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAoCD,GAAA,CAAI,SAAA,EAAS,GAAA,EACrC,MAAA,KAAM,IAAA,EACF,YAAA,CAAa,MAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA;;8BAhGF,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,QAAA,EAAQ,GAAA,EAClC,KAAA,KAAK,IAAA,EACD,YAAA,CAAa,KAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAoCG,GAAA,CAAI,WAAA,EAAW,GAAA,EAC3C,QAAA,KAAQ,IAAA,EACJ,YAAA,CAAa,QAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAoCD,GAAA,CAAI,SAAA,EAAS,GAAA,EACrC,MAAA,KAAM,IAAA,EACF,YAAA,CAAa,MAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA;AAAA,KAqDtB,UAAA,UAAoB,UAAA,CAAW,UAAA;AAAA,cAE9B,KAAA,GACX,OAAA,UACA,OAAA,GAAU,qBAAA,QAA6B,gBAAA,SAAoB,KAAA,CAAA,KAAA;;8BAzJ7B,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,QAAA,EAAQ,GAAA,EAClC,KAAA,KAAK,IAAA,EACD,YAAA,CAAa,KAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAoCG,GAAA,CAAI,WAAA,EAAW,GAAA,EAC3C,QAAA,KAAQ,IAAA,EACJ,YAAA,CAAa,QAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAoCD,GAAA,CAAI,SAAA,EAAS,GAAA,EACrC,MAAA,KAAM,IAAA,EACF,YAAA,CAAa,MAAA,MACrB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA"}

package/dist/HttpClient.js

@@ -0,0 +1,87 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import * as Ref from "@confect/core/Ref";
+import { ConvexHttpClient } from "convex/browser";
+import { Context, Effect, Layer, Match, Schema } from "effect";
+
+//#region src/HttpClient.ts
+var HttpClient_exports = /* @__PURE__ */ __exportAll({
+	HttpClient: () => HttpClient,
+	HttpClientError: () => HttpClientError,
+	layer: () => layer
+});
+var HttpClientError = class extends Schema.TaggedError()("HttpClientError", { cause: Schema.Unknown }) {};
+const make = (address, options) => {
+	const client = new ConvexHttpClient(address, options);
+	const url = client.url;
+	const setAuth = (token) => Effect.sync(() => {
+		client.setAuth(token);
+	});
+	const clearAuth = Effect.sync(() => {
+		client.clearAuth();
+	});
+	const query = (ref, ...rest) => Effect.gen(function* () {
+		const args = rest[0] ?? {};
+		const functionSpec = Ref.getFunctionSpec(ref);
+		const functionName = Ref.getConvexFunctionName(ref);
+		return yield* Match.value(functionSpec.functionProvenance).pipe(Match.tag("Confect", (confectFunctionSpec) => Effect.gen(function* () {
+			const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(args);
+			const encodedResult = yield* Effect.tryPromise({
+				try: () => client.query(functionName, encodedArgs),
+				catch: (cause) => new HttpClientError({ cause })
+			});
+			return yield* Schema.decode(confectFunctionSpec.returns)(encodedResult);
+		})), Match.tag("Convex", () => Effect.tryPromise({
+			try: () => client.query(functionName, args),
+			catch: (cause) => new HttpClientError({ cause })
+		})), Match.exhaustive);
+	});
+	const mutation = (ref, ...rest) => Effect.gen(function* () {
+		const args = rest[0] ?? {};
+		const functionSpec = Ref.getFunctionSpec(ref);
+		const functionName = Ref.getConvexFunctionName(ref);
+		return yield* Match.value(functionSpec.functionProvenance).pipe(Match.tag("Confect", (confectFunctionSpec) => Effect.gen(function* () {
+			const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(args);
+			const encodedResult = yield* Effect.tryPromise({
+				try: () => client.mutation(functionName, encodedArgs),
+				catch: (cause) => new HttpClientError({ cause })
+			});
+			return yield* Schema.decode(confectFunctionSpec.returns)(encodedResult);
+		})), Match.tag("Convex", () => Effect.tryPromise({
+			try: () => client.mutation(functionName, args),
+			catch: (cause) => new HttpClientError({ cause })
+		})), Match.exhaustive);
+	});
+	const action = (ref, ...rest) => Effect.gen(function* () {
+		const args = rest[0] ?? {};
+		const functionSpec = Ref.getFunctionSpec(ref);
+		const functionName = Ref.getConvexFunctionName(ref);
+		return yield* Match.value(functionSpec.functionProvenance).pipe(Match.tag("Confect", (confectFunctionSpec) => Effect.gen(function* () {
+			const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(args);
+			const encodedResult = yield* Effect.tryPromise({
+				try: () => client.action(functionName, encodedArgs),
+				catch: (cause) => new HttpClientError({ cause })
+			});
+			return yield* Schema.decode(confectFunctionSpec.returns)(encodedResult);
+		})), Match.tag("Convex", () => Effect.tryPromise({
+			try: () => client.action(functionName, args),
+			catch: (cause) => new HttpClientError({ cause })
+		})), Match.exhaustive);
+	});
+	return {
+		url,
+		setAuth,
+		clearAuth,
+		query,
+		mutation,
+		action
+	};
+};
+/**
+* A Confect client which uses HTTP to communicate with your Convex backend. Works in any JS runtime that supports `fetch`. Wraps [ConvexHttpClient](https://docs.convex.dev/api/classes/browser.ConvexHttpClient).
+*/
+const HttpClient = Context.GenericTag("@confect/js/HttpClient");
+const layer = (address, options) => Layer.sync(HttpClient, () => make(address, options));
+
+//#endregion
+export { HttpClient_exports };
+//# sourceMappingURL=HttpClient.js.map

package/dist/HttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.js","names":[],"sources":["../src/HttpClient.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport { ConvexHttpClient } from \"convex/browser\";\nimport type { FunctionReference } from \"convex/server\";\nimport type { ParseResult } from \"effect\";\nimport { Context, Effect, Layer, Match, Schema } from \"effect\";\n\nexport class HttpClientError extends Schema.TaggedError<HttpClientError>()(\n  \"HttpClientError\",\n  {\n    cause: Schema.Unknown,\n  },\n) {}\n\ntype OptionalArgs<R extends Ref.AnyQuery | Ref.AnyMutation | Ref.AnyAction> =\n  keyof Ref.Args<R> extends never ? [args?: Ref.Args<R>] : [args: Ref.Args<R>];\n\nconst make = (\n  address: string,\n  options?: ConstructorParameters<typeof ConvexHttpClient>[1],\n) => {\n  const client = new ConvexHttpClient(address, options);\n\n  const url = client.url;\n\n  const setAuth = (token: string) =>\n    Effect.sync(() => {\n      client.setAuth(token);\n    });\n\n  const clearAuth = Effect.sync(() => {\n    client.clearAuth();\n  });\n\n  const query = <Query extends Ref.AnyQuery>(\n    ref: Query,\n    ...rest: OptionalArgs<Query>\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    HttpClientError | ParseResult.ParseError\n  > =>\n    Effect.gen(function* () {\n      const args = (rest[0] ?? {}) as Ref.Args<Query>;\n      const functionSpec = Ref.getFunctionSpec(ref);\n      const functionName = Ref.getConvexFunctionName(\n        ref,\n      ) as unknown as FunctionReference<\"query\">;\n\n      return yield* Match.value(functionSpec.functionProvenance).pipe(\n        Match.tag(\"Confect\", (confectFunctionSpec) =>\n          Effect.gen(function* () {\n            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(\n              args,\n            );\n\n            const encodedResult = yield* Effect.tryPromise({\n              try: () => client.query(functionName, encodedArgs),\n              catch: (cause) => new HttpClientError({ cause }),\n            });\n\n            return yield* Schema.decode(confectFunctionSpec.returns)(\n              encodedResult,\n            );\n          }),\n        ),\n        Match.tag(\"Convex\", () =>\n          Effect.tryPromise({\n            try: () => client.query(functionName, args),\n            catch: (cause) => new HttpClientError({ cause }),\n          }),\n        ),\n        Match.exhaustive,\n      );\n    });\n\n  const mutation = <Mutation extends Ref.AnyMutation>(\n    ref: Mutation,\n    ...rest: OptionalArgs<Mutation>\n  ): Effect.Effect<\n    Ref.Returns<Mutation>,\n    HttpClientError | ParseResult.ParseError\n  > =>\n    Effect.gen(function* () {\n      const args = (rest[0] ?? {}) as Ref.Args<Mutation>;\n      const functionSpec = Ref.getFunctionSpec(ref);\n      const functionName = Ref.getConvexFunctionName(\n        ref,\n      ) as unknown as FunctionReference<\"mutation\">;\n\n      return yield* Match.value(functionSpec.functionProvenance).pipe(\n        Match.tag(\"Confect\", (confectFunctionSpec) =>\n          Effect.gen(function* () {\n            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(\n              args,\n            );\n\n            const encodedResult = yield* Effect.tryPromise({\n              try: () => client.mutation(functionName, encodedArgs),\n              catch: (cause) => new HttpClientError({ cause }),\n            });\n\n            return yield* Schema.decode(confectFunctionSpec.returns)(\n              encodedResult,\n            );\n          }),\n        ),\n        Match.tag(\"Convex\", () =>\n          Effect.tryPromise({\n            try: () => client.mutation(functionName, args),\n            catch: (cause) => new HttpClientError({ cause }),\n          }),\n        ),\n        Match.exhaustive,\n      );\n    });\n\n  const action = <Action extends Ref.AnyAction>(\n    ref: Action,\n    ...rest: OptionalArgs<Action>\n  ): Effect.Effect<\n    Ref.Returns<Action>,\n    HttpClientError | ParseResult.ParseError\n  > =>\n    Effect.gen(function* () {\n      const args = (rest[0] ?? {}) as Ref.Args<Action>;\n      const functionSpec = Ref.getFunctionSpec(ref);\n      const functionName = Ref.getConvexFunctionName(\n        ref,\n      ) as unknown as FunctionReference<\"action\">;\n\n      return yield* Match.value(functionSpec.functionProvenance).pipe(\n        Match.tag(\"Confect\", (confectFunctionSpec) =>\n          Effect.gen(function* () {\n            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(\n              args,\n            );\n\n            const encodedResult = yield* Effect.tryPromise({\n              try: () => client.action(functionName, encodedArgs),\n              catch: (cause) => new HttpClientError({ cause }),\n            });\n\n            return yield* Schema.decode(confectFunctionSpec.returns)(\n              encodedResult,\n            );\n          }),\n        ),\n        Match.tag(\"Convex\", () =>\n          Effect.tryPromise({\n            try: () => client.action(functionName, args),\n            catch: (cause) => new HttpClientError({ cause }),\n          }),\n        ),\n        Match.exhaustive,\n      );\n    });\n\n  return {\n    url,\n    setAuth,\n    clearAuth,\n    query,\n    mutation,\n    action,\n  };\n};\n\n/**\n * A Confect client which uses HTTP to communicate with your Convex backend. Works in any JS runtime that supports `fetch`. Wraps [ConvexHttpClient](https://docs.convex.dev/api/classes/browser.ConvexHttpClient).\n */\nexport const HttpClient = Context.GenericTag<ReturnType<typeof make>>(\n  \"@confect/js/HttpClient\",\n);\n\nexport type HttpClient = typeof HttpClient.Identifier;\n\nexport const layer = (\n  address: string,\n  options?: ConstructorParameters<typeof ConvexHttpClient>[1],\n) => Layer.sync(HttpClient, () => make(address, options));\n"],"mappings":"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"}

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,18 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { HttpClient_d_exports } from "./HttpClient.js";
+export { HttpClient_d_exports as HttpClient };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { HttpClient_exports } from "./HttpClient.js";
+
+export { HttpClient_exports as HttpClient };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@confect/js",
+  "version": "4.0.0",
+  "description": "JavaScript client bindings for any JS runtime",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rjdellecese/confect.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rjdellecese/confect/issues"
+  },
+  "homepage": "https://confect.dev",
+  "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"
+  ],
+  "author": "RJ Dellecese",
+  "license": "ISC",
+  "devDependencies": {
+    "@effect/vitest": "0.27.0",
+    "@eslint/js": "10.0.1",
+    "@types/node": "25.3.3",
+    "effect": "3.19.19",
+    "eslint": "10.0.2",
+    "prettier": "3.8.1",
+    "tsdown": "0.20.3",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.56.1",
+    "vitest": "3.2.4"
+  },
+  "peerDependencies": {
+    "convex": "^1.30.0",
+    "effect": "^3.19.16",
+    "@confect/core": "4.0.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",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "fix": "prettier --write . && eslint --fix . --max-warnings=0",
+    "format": "prettier --check .",
+    "lint": "eslint . --max-warnings=0",
+    "clean": "rm -rf dist coverage node_modules"
+  }
+}

package/src/HttpClient.ts

@@ -0,0 +1,179 @@
+import * as Ref from "@confect/core/Ref";
+import { ConvexHttpClient } from "convex/browser";
+import type { FunctionReference } from "convex/server";
+import type { ParseResult } from "effect";
+import { Context, Effect, Layer, Match, Schema } from "effect";
+
+export class HttpClientError extends Schema.TaggedError<HttpClientError>()(
+  "HttpClientError",
+  {
+    cause: Schema.Unknown,
+  },
+) {}
+
+type OptionalArgs<R extends Ref.AnyQuery | Ref.AnyMutation | Ref.AnyAction> =
+  keyof Ref.Args<R> extends never ? [args?: Ref.Args<R>] : [args: Ref.Args<R>];
+
+const make = (
+  address: string,
+  options?: ConstructorParameters<typeof ConvexHttpClient>[1],
+) => {
+  const client = new ConvexHttpClient(address, options);
+
+  const url = client.url;
+
+  const setAuth = (token: string) =>
+    Effect.sync(() => {
+      client.setAuth(token);
+    });
+
+  const clearAuth = Effect.sync(() => {
+    client.clearAuth();
+  });
+
+  const query = <Query extends Ref.AnyQuery>(
+    ref: Query,
+    ...rest: OptionalArgs<Query>
+  ): Effect.Effect<
+    Ref.Returns<Query>,
+    HttpClientError | ParseResult.ParseError
+  > =>
+    Effect.gen(function* () {
+      const args = (rest[0] ?? {}) as Ref.Args<Query>;
+      const functionSpec = Ref.getFunctionSpec(ref);
+      const functionName = Ref.getConvexFunctionName(
+        ref,
+      ) as unknown as FunctionReference<"query">;
+
+      return yield* Match.value(functionSpec.functionProvenance).pipe(
+        Match.tag("Confect", (confectFunctionSpec) =>
+          Effect.gen(function* () {
+            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(
+              args,
+            );
+
+            const encodedResult = yield* Effect.tryPromise({
+              try: () => client.query(functionName, encodedArgs),
+              catch: (cause) => new HttpClientError({ cause }),
+            });
+
+            return yield* Schema.decode(confectFunctionSpec.returns)(
+              encodedResult,
+            );
+          }),
+        ),
+        Match.tag("Convex", () =>
+          Effect.tryPromise({
+            try: () => client.query(functionName, args),
+            catch: (cause) => new HttpClientError({ cause }),
+          }),
+        ),
+        Match.exhaustive,
+      );
+    });
+
+  const mutation = <Mutation extends Ref.AnyMutation>(
+    ref: Mutation,
+    ...rest: OptionalArgs<Mutation>
+  ): Effect.Effect<
+    Ref.Returns<Mutation>,
+    HttpClientError | ParseResult.ParseError
+  > =>
+    Effect.gen(function* () {
+      const args = (rest[0] ?? {}) as Ref.Args<Mutation>;
+      const functionSpec = Ref.getFunctionSpec(ref);
+      const functionName = Ref.getConvexFunctionName(
+        ref,
+      ) as unknown as FunctionReference<"mutation">;
+
+      return yield* Match.value(functionSpec.functionProvenance).pipe(
+        Match.tag("Confect", (confectFunctionSpec) =>
+          Effect.gen(function* () {
+            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(
+              args,
+            );
+
+            const encodedResult = yield* Effect.tryPromise({
+              try: () => client.mutation(functionName, encodedArgs),
+              catch: (cause) => new HttpClientError({ cause }),
+            });
+
+            return yield* Schema.decode(confectFunctionSpec.returns)(
+              encodedResult,
+            );
+          }),
+        ),
+        Match.tag("Convex", () =>
+          Effect.tryPromise({
+            try: () => client.mutation(functionName, args),
+            catch: (cause) => new HttpClientError({ cause }),
+          }),
+        ),
+        Match.exhaustive,
+      );
+    });
+
+  const action = <Action extends Ref.AnyAction>(
+    ref: Action,
+    ...rest: OptionalArgs<Action>
+  ): Effect.Effect<
+    Ref.Returns<Action>,
+    HttpClientError | ParseResult.ParseError
+  > =>
+    Effect.gen(function* () {
+      const args = (rest[0] ?? {}) as Ref.Args<Action>;
+      const functionSpec = Ref.getFunctionSpec(ref);
+      const functionName = Ref.getConvexFunctionName(
+        ref,
+      ) as unknown as FunctionReference<"action">;
+
+      return yield* Match.value(functionSpec.functionProvenance).pipe(
+        Match.tag("Confect", (confectFunctionSpec) =>
+          Effect.gen(function* () {
+            const encodedArgs = yield* Schema.encode(confectFunctionSpec.args)(
+              args,
+            );
+
+            const encodedResult = yield* Effect.tryPromise({
+              try: () => client.action(functionName, encodedArgs),
+              catch: (cause) => new HttpClientError({ cause }),
+            });
+
+            return yield* Schema.decode(confectFunctionSpec.returns)(
+              encodedResult,
+            );
+          }),
+        ),
+        Match.tag("Convex", () =>
+          Effect.tryPromise({
+            try: () => client.action(functionName, args),
+            catch: (cause) => new HttpClientError({ cause }),
+          }),
+        ),
+        Match.exhaustive,
+      );
+    });
+
+  return {
+    url,
+    setAuth,
+    clearAuth,
+    query,
+    mutation,
+    action,
+  };
+};
+
+/**
+ * A Confect client which uses HTTP to communicate with your Convex backend. Works in any JS runtime that supports `fetch`. Wraps [ConvexHttpClient](https://docs.convex.dev/api/classes/browser.ConvexHttpClient).
+ */
+export const HttpClient = Context.GenericTag<ReturnType<typeof make>>(
+  "@confect/js/HttpClient",
+);
+
+export type HttpClient = typeof HttpClient.Identifier;
+
+export const layer = (
+  address: string,
+  options?: ConstructorParameters<typeof ConvexHttpClient>[1],
+) => Layer.sync(HttpClient, () => make(address, options));

package/src/index.ts

@@ -0,0 +1 @@
+export * as HttpClient from "./HttpClient";