@confect/js 4.0.0 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @confect/js
 
+## 6.0.0
+
+### Patch Changes
+
+- df95ce7: Add `Ref.OptionalArgs` type utility to `@confect/core` for conditionally optional function args. `QueryRunner`, `MutationRunner`, and `ActionRunner` now accept optional args for no-arg Confect functions. `useQuery`, `useMutation`, and `useAction` now accept optional args for no-arg Confect functions. `TestConfect` `query`/`mutation`/`action` helpers now accept optional args for no-arg Confect functions.
+- Updated dependencies [df95ce7]
+- Updated dependencies [a8083e8]
+  - @confect/core@6.0.0
+
+## 5.0.0
+
+### Minor Changes
+
+- fb17b7e: Add `WebSocketClient`, a WebSocket-based client wrapping Convex's `ConvexClient`. Provides the same `query`, `mutation`, and `action` methods as `HttpClient`, plus `reactiveQuery` which returns a `Stream` of live query results.
+
+### Patch Changes
+
+- 2c4b0c9: Fix `HttpClient` to only accept public `Ref`s
+
+  `HttpClient` query, mutation, and action methods now correctly reject internal `Ref`s at the type level, matching the runtime behavior of Convex browser clients which can only call public functions.
+  - @confect/core@5.0.0
+
 ## 4.0.0
 
 ### Minor Changes

package/dist/HttpClient.d.ts

@@ -12,7 +12,6 @@ declare const HttpClientError_base: Schema.TaggedErrorClass<HttpClientError, "Ht
   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).
  */
@@ -20,25 +19,25 @@ 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>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.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>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.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>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, HttpClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, HttpClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, HttpClientError | ParseResult.ParseError>;
 }, never, never>;
 //#endregion
 export { HttpClient_d_exports };

package/dist/HttpClient.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"HttpClient.d.ts","names":[],"sources":["../src/HttpClient.ts"],"mappings":";;;;;;;;cAGwD,oBAAA;;;;;cAE3C,eAAA,SAAwB,oBAAA;AAFmB;;;AAAA,cAuF3C,UAAA,EAAU,OAAA,CAAA,GAAA;;8BAtES,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,cAAA,EAAc,GAAA,EACxC,KAAA,KAAK,IAAA,EACD,GAAA,CAAI,YAAA,CAAa,KAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAWG,GAAA,CAAI,iBAAA,EAAiB,GAAA,EACjD,QAAA,KAAQ,IAAA,EACJ,GAAA,CAAI,YAAA,CAAa,QAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAWD,GAAA,CAAI,eAAA,EAAe,GAAA,EAC3C,MAAA,KAAM,IAAA,EACF,GAAA,CAAI,YAAA,CAAa,MAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA;;8BA9CF,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,cAAA,EAAc,GAAA,EACxC,KAAA,KAAK,IAAA,EACD,GAAA,CAAI,YAAA,CAAa,KAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAWG,GAAA,CAAI,iBAAA,EAAiB,GAAA,EACjD,QAAA,KAAQ,IAAA,EACJ,GAAA,CAAI,YAAA,CAAa,QAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAWD,GAAA,CAAI,eAAA,EAAe,GAAA,EAC3C,MAAA,KAAM,IAAA,EACF,GAAA,CAAI,YAAA,CAAa,MAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA;AAAA,KA4BtB,UAAA,UAAoB,UAAA,CAAW,UAAA;AAAA,cAE9B,KAAA,GACX,OAAA,UACA,OAAA,GAAU,qBAAA,QAA6B,gBAAA,SAAoB,KAAA,CAAA,KAAA;;8BA9E7B,MAAA,CAAA,MAAA;;wBASD,GAAA,CAAI,cAAA,EAAc,GAAA,EACxC,KAAA,KAAK,IAAA,EACD,GAAA,CAAI,YAAA,CAAa,KAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,KAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;8BAWG,GAAA,CAAI,iBAAA,EAAiB,GAAA,EACjD,QAAA,KAAQ,IAAA,EACJ,GAAA,CAAI,YAAA,CAAa,QAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,QAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;0BAWD,GAAA,CAAI,eAAA,EAAe,GAAA,EAC3C,MAAA,KAAM,IAAA,EACF,GAAA,CAAI,YAAA,CAAa,MAAA,MACzB,MAAA,CAAO,MAAA,CACR,GAAA,CAAI,OAAA,CAAQ,MAAA,GACZ,eAAA,GAAkB,WAAA,CAAY,UAAA;AAAA"}

package/dist/HttpClient.js

@@ -1,7 +1,7 @@
 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";
+import { Context, Effect, Layer, Schema } from "effect";
 
 //#region src/HttpClient.ts
 var HttpClient_exports = /* @__PURE__ */ __exportAll({
@@ -19,54 +19,27 @@ const make = (address, options) => {
 	const clearAuth = Effect.sync(() => {
 		client.clearAuth();
 	});
-	const query = (ref, ...rest) => Effect.gen(function* () {
+	const query = (ref, ...rest) => {
 		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),
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => client.query(functionReference, encodedArgs),
 			catch: (cause) => new HttpClientError({ cause })
-		})), Match.exhaustive);
-	});
-	const mutation = (ref, ...rest) => Effect.gen(function* () {
+		}));
+	};
+	const mutation = (ref, ...rest) => {
 		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),
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => client.mutation(functionReference, encodedArgs),
 			catch: (cause) => new HttpClientError({ cause })
-		})), Match.exhaustive);
-	});
-	const action = (ref, ...rest) => Effect.gen(function* () {
+		}));
+	};
+	const action = (ref, ...rest) => {
 		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),
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => client.action(functionReference, encodedArgs),
 			catch: (cause) => new HttpClientError({ cause })
-		})), Match.exhaustive);
-	});
+		}));
+	};
 	return {
 		url,
 		setAuth,

package/dist/HttpClient.js.map

@@ -1 +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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"}
+{"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 { ParseResult } from \"effect\";\nimport { Context, Effect, Layer, Schema } from \"effect\";\n\nexport class HttpClientError extends Schema.TaggedError<HttpClientError>()(\n  \"HttpClientError\",\n  {\n    cause: Schema.Unknown,\n  },\n) {}\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.AnyPublicQuery>(\n    ref: Query,\n    ...rest: Ref.OptionalArgs<Query>\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    HttpClientError | ParseResult.ParseError\n  > => {\n    const args = (rest[0] ?? {}) as Ref.Args<Query>;\n    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n      Effect.tryPromise({\n        try: () => client.query(functionReference, encodedArgs),\n        catch: (cause) => new HttpClientError({ cause }),\n      }),\n    );\n  };\n\n  const mutation = <Mutation extends Ref.AnyPublicMutation>(\n    ref: Mutation,\n    ...rest: Ref.OptionalArgs<Mutation>\n  ): Effect.Effect<\n    Ref.Returns<Mutation>,\n    HttpClientError | ParseResult.ParseError\n  > => {\n    const args = (rest[0] ?? {}) as Ref.Args<Mutation>;\n    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n      Effect.tryPromise({\n        try: () => client.mutation(functionReference, encodedArgs),\n        catch: (cause) => new HttpClientError({ cause }),\n      }),\n    );\n  };\n\n  const action = <Action extends Ref.AnyPublicAction>(\n    ref: Action,\n    ...rest: Ref.OptionalArgs<Action>\n  ): Effect.Effect<\n    Ref.Returns<Action>,\n    HttpClientError | ParseResult.ParseError\n  > => {\n    const args = (rest[0] ?? {}) as Ref.Args<Action>;\n    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n      Effect.tryPromise({\n        try: () => client.action(functionReference, encodedArgs),\n        catch: (cause) => new HttpClientError({ cause }),\n      }),\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":";;;;;;;;;;;AAKA,IAAa,kBAAb,cAAqC,OAAO,aAA8B,CACxE,mBACA,EACE,OAAO,OAAO,SACf,CACF,CAAC;AAEF,MAAM,QACJ,SACA,YACG;CACH,MAAM,SAAS,IAAI,iBAAiB,SAAS,QAAQ;CAErD,MAAM,MAAM,OAAO;CAEnB,MAAM,WAAW,UACf,OAAO,WAAW;AAChB,SAAO,QAAQ,MAAM;GACrB;CAEJ,MAAM,YAAY,OAAO,WAAW;AAClC,SAAO,WAAW;GAClB;CAEF,MAAM,SACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,OAAO,MAAM,mBAAmB,YAAY;GACvD,QAAQ,UAAU,IAAI,gBAAgB,EAAE,OAAO,CAAC;GACjD,CAAC,CACH;;CAGH,MAAM,YACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,OAAO,SAAS,mBAAmB,YAAY;GAC1D,QAAQ,UAAU,IAAI,gBAAgB,EAAE,OAAO,CAAC;GACjD,CAAC,CACH;;CAGH,MAAM,UACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,OAAO,OAAO,mBAAmB,YAAY;GACxD,QAAQ,UAAU,IAAI,gBAAgB,EAAE,OAAO,CAAC;GACjD,CAAC,CACH;;AAGH,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD;;;;;AAMH,MAAa,aAAa,QAAQ,WAChC,yBACD;AAID,MAAa,SACX,SACA,YACG,MAAM,KAAK,kBAAkB,KAAK,SAAS,QAAQ,CAAC"}

package/dist/WebSocketClient.d.ts

@@ -0,0 +1,50 @@
+import * as Ref from "@confect/core/Ref";
+import { ConvexClient } from "convex/browser";
+import { Context, Effect, Layer, ParseResult, Schema, Stream } from "effect";
+
+//#region src/WebSocketClient.d.ts
+declare namespace WebSocketClient_d_exports {
+  export { WebSocketClient, WebSocketClientError, layer };
+}
+declare const WebSocketClientError_base: Schema.TaggedErrorClass<WebSocketClientError, "WebSocketClientError", {
+  readonly _tag: Schema.tag<"WebSocketClientError">;
+} & {
+  cause: typeof Schema.Unknown;
+}>;
+declare class WebSocketClientError extends WebSocketClientError_base {}
+/**
+ * A Confect client which uses a WebSocket to communicate with your Convex backend and supports reactive query subscriptions. The WebSocket connection is managed by the layer's scope and closed automatically when the scope ends. Wraps [ConvexClient](https://docs.convex.dev/api/classes/browser.ConvexClient).
+ */
+declare const WebSocketClient: Context.Tag<{
+  url: string;
+  setAuth: (fetchToken: (args: {
+    forceRefreshToken: boolean;
+  }) => Effect.Effect<string | null | undefined>, onChange?: (isAuthenticated: boolean) => Effect.Effect<void>) => Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, WebSocketClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, WebSocketClientError | ParseResult.ParseError>;
+  reactiveQuery: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Stream.Stream<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+}, {
+  url: string;
+  setAuth: (fetchToken: (args: {
+    forceRefreshToken: boolean;
+  }) => Effect.Effect<string | null | undefined>, onChange?: (isAuthenticated: boolean) => Effect.Effect<void>) => Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, WebSocketClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, WebSocketClientError | ParseResult.ParseError>;
+  reactiveQuery: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Stream.Stream<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+}>;
+type WebSocketClient = typeof WebSocketClient.Identifier;
+declare const layer: (address: string, options?: ConstructorParameters<typeof ConvexClient>[1]) => Layer.Layer<{
+  url: string;
+  setAuth: (fetchToken: (args: {
+    forceRefreshToken: boolean;
+  }) => Effect.Effect<string | null | undefined>, onChange?: (isAuthenticated: boolean) => Effect.Effect<void>) => Effect.Effect<void, never, never>;
+  query: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Effect.Effect<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+  mutation: <Mutation extends Ref.AnyPublicMutation>(ref: Mutation, ...rest: Ref.OptionalArgs<Mutation>) => Effect.Effect<Ref.Returns<Mutation>, WebSocketClientError | ParseResult.ParseError>;
+  action: <Action extends Ref.AnyPublicAction>(ref: Action, ...rest: Ref.OptionalArgs<Action>) => Effect.Effect<Ref.Returns<Action>, WebSocketClientError | ParseResult.ParseError>;
+  reactiveQuery: <Query extends Ref.AnyPublicQuery>(ref: Query, ...rest: Ref.OptionalArgs<Query>) => Stream.Stream<Ref.Returns<Query>, WebSocketClientError | ParseResult.ParseError>;
+}, never, never>;
+//#endregion
+export { WebSocketClient_d_exports };
+//# sourceMappingURL=WebSocketClient.d.ts.map

package/dist/WebSocketClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketClient.d.ts","names":[],"sources":["../src/WebSocketClient.ts"],"mappings":"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"}

package/dist/WebSocketClient.js

@@ -0,0 +1,71 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import * as Ref from "@confect/core/Ref";
+import { ConvexClient } from "convex/browser";
+import { Context, Effect, Layer, Schema, Stream } from "effect";
+
+//#region src/WebSocketClient.ts
+var WebSocketClient_exports = /* @__PURE__ */ __exportAll({
+	WebSocketClient: () => WebSocketClient,
+	WebSocketClientError: () => WebSocketClientError,
+	layer: () => layer
+});
+var WebSocketClientError = class extends Schema.TaggedError()("WebSocketClientError", { cause: Schema.Unknown }) {};
+const make = (address, options) => Effect.acquireRelease(Effect.sync(() => new ConvexClient(address, options)), (convexClient) => Effect.promise(() => convexClient.close())).pipe(Effect.map((convexClient) => {
+	const url = address;
+	const setAuth = (fetchToken, onChange) => Effect.sync(() => {
+		convexClient.setAuth((args) => Effect.runPromise(fetchToken(args)), ...onChange ? [(isAuthenticated) => Effect.runFork(onChange(isAuthenticated))] : []);
+	});
+	const query = (ref, ...rest) => {
+		const args = rest[0] ?? {};
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => convexClient.query(functionReference, encodedArgs),
+			catch: (cause) => new WebSocketClientError({ cause })
+		}));
+	};
+	const mutation = (ref, ...rest) => {
+		const args = rest[0] ?? {};
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => convexClient.mutation(functionReference, encodedArgs),
+			catch: (cause) => new WebSocketClientError({ cause })
+		}));
+	};
+	const action = (ref, ...rest) => {
+		const args = rest[0] ?? {};
+		return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) => Effect.tryPromise({
+			try: () => convexClient.action(functionReference, encodedArgs),
+			catch: (cause) => new WebSocketClientError({ cause })
+		}));
+	};
+	const reactiveQuery = (ref, ...rest) => {
+		const args = rest[0] ?? {};
+		const functionReference = Ref.getFunctionReference(ref);
+		return Stream.unwrapScoped(Effect.gen(function* () {
+			const encodedArgs = yield* Ref.encodeArgs(ref, args);
+			return Stream.asyncScoped((emit) => Effect.gen(function* () {
+				const unsubscribe = convexClient.onUpdate(functionReference, encodedArgs, (result) => {
+					emit.single(result);
+				}, (error) => {
+					emit.fail(new WebSocketClientError({ cause: error }));
+				});
+				yield* Effect.addFinalizer(() => Effect.sync(() => unsubscribe()));
+			}));
+		})).pipe(Stream.mapEffect((encodedReturns) => Ref.decodeReturns(ref, encodedReturns)));
+	};
+	return {
+		url,
+		setAuth,
+		query,
+		mutation,
+		action,
+		reactiveQuery
+	};
+}));
+/**
+* A Confect client which uses a WebSocket to communicate with your Convex backend and supports reactive query subscriptions. The WebSocket connection is managed by the layer's scope and closed automatically when the scope ends. Wraps [ConvexClient](https://docs.convex.dev/api/classes/browser.ConvexClient).
+*/
+const WebSocketClient = Context.GenericTag("@confect/js/WebSocketClient");
+const layer = (address, options) => Layer.scoped(WebSocketClient, make(address, options));
+
+//#endregion
+export { WebSocketClient_exports };
+//# sourceMappingURL=WebSocketClient.js.map

package/dist/WebSocketClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketClient.js","names":[],"sources":["../src/WebSocketClient.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport { ConvexClient } from \"convex/browser\";\nimport type { ParseResult } from \"effect\";\nimport { Context, Effect, Layer, Schema, Stream } from \"effect\";\n\nexport class WebSocketClientError extends Schema.TaggedError<WebSocketClientError>()(\n  \"WebSocketClientError\",\n  {\n    cause: Schema.Unknown,\n  },\n) {}\n\nconst make = (\n  address: string,\n  options?: ConstructorParameters<typeof ConvexClient>[1],\n) =>\n  Effect.acquireRelease(\n    Effect.sync(() => new ConvexClient(address, options)),\n    (convexClient) => Effect.promise(() => convexClient.close()),\n  ).pipe(\n    Effect.map((convexClient) => {\n      const url = address;\n\n      const setAuth = (\n        fetchToken: (args: {\n          forceRefreshToken: boolean;\n        }) => Effect.Effect<string | null | undefined>,\n        onChange?: (isAuthenticated: boolean) => Effect.Effect<void>,\n      ) =>\n        Effect.sync(() => {\n          convexClient.setAuth(\n            (args) => Effect.runPromise(fetchToken(args)),\n            ...(onChange\n              ? [\n                  (isAuthenticated: boolean) =>\n                    Effect.runFork(onChange(isAuthenticated)),\n                ]\n              : []),\n          );\n        });\n\n      const query = <Query extends Ref.AnyPublicQuery>(\n        ref: Query,\n        ...rest: Ref.OptionalArgs<Query>\n      ): Effect.Effect<\n        Ref.Returns<Query>,\n        WebSocketClientError | ParseResult.ParseError\n      > => {\n        const args = (rest[0] ?? {}) as Ref.Args<Query>;\n        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n          Effect.tryPromise({\n            try: () => convexClient.query(functionReference, encodedArgs),\n            catch: (cause) => new WebSocketClientError({ cause }),\n          }),\n        );\n      };\n\n      const mutation = <Mutation extends Ref.AnyPublicMutation>(\n        ref: Mutation,\n        ...rest: Ref.OptionalArgs<Mutation>\n      ): Effect.Effect<\n        Ref.Returns<Mutation>,\n        WebSocketClientError | ParseResult.ParseError\n      > => {\n        const args = (rest[0] ?? {}) as Ref.Args<Mutation>;\n        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n          Effect.tryPromise({\n            try: () => convexClient.mutation(functionReference, encodedArgs),\n            catch: (cause) => new WebSocketClientError({ cause }),\n          }),\n        );\n      };\n\n      const action = <Action extends Ref.AnyPublicAction>(\n        ref: Action,\n        ...rest: Ref.OptionalArgs<Action>\n      ): Effect.Effect<\n        Ref.Returns<Action>,\n        WebSocketClientError | ParseResult.ParseError\n      > => {\n        const args = (rest[0] ?? {}) as Ref.Args<Action>;\n        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>\n          Effect.tryPromise({\n            try: () => convexClient.action(functionReference, encodedArgs),\n            catch: (cause) => new WebSocketClientError({ cause }),\n          }),\n        );\n      };\n\n      const reactiveQuery = <Query extends Ref.AnyPublicQuery>(\n        ref: Query,\n        ...rest: Ref.OptionalArgs<Query>\n      ): Stream.Stream<\n        Ref.Returns<Query>,\n        WebSocketClientError | ParseResult.ParseError\n      > => {\n        const args = (rest[0] ?? {}) as Ref.Args<Query>;\n        const functionReference = Ref.getFunctionReference(ref);\n\n        return Stream.unwrapScoped(\n          Effect.gen(function* () {\n            const encodedArgs = yield* Ref.encodeArgs(ref, args);\n\n            return Stream.asyncScoped<unknown, WebSocketClientError>((emit) =>\n              Effect.gen(function* () {\n                const unsubscribe = convexClient.onUpdate(\n                  functionReference,\n                  encodedArgs,\n                  (result) => {\n                    emit.single(result);\n                  },\n                  (error) => {\n                    emit.fail(new WebSocketClientError({ cause: error }));\n                  },\n                );\n                yield* Effect.addFinalizer(() =>\n                  Effect.sync(() => unsubscribe()),\n                );\n              }),\n            );\n          }),\n        ).pipe(\n          Stream.mapEffect((encodedReturns) =>\n            Ref.decodeReturns(ref, encodedReturns),\n          ),\n        );\n      };\n\n      return {\n        url,\n        setAuth,\n        query,\n        mutation,\n        action,\n        reactiveQuery,\n      };\n    }),\n  );\n\n/**\n * A Confect client which uses a WebSocket to communicate with your Convex backend and supports reactive query subscriptions. The WebSocket connection is managed by the layer's scope and closed automatically when the scope ends. Wraps [ConvexClient](https://docs.convex.dev/api/classes/browser.ConvexClient).\n */\nexport const WebSocketClient = Context.GenericTag<\n  Effect.Effect.Success<ReturnType<typeof make>>\n>(\"@confect/js/WebSocketClient\");\n\nexport type WebSocketClient = typeof WebSocketClient.Identifier;\n\nexport const layer = (\n  address: string,\n  options?: ConstructorParameters<typeof ConvexClient>[1],\n) => Layer.scoped(WebSocketClient, make(address, options));\n"],"mappings":";;;;;;;;;;;AAKA,IAAa,uBAAb,cAA0C,OAAO,aAAmC,CAClF,wBACA,EACE,OAAO,OAAO,SACf,CACF,CAAC;AAEF,MAAM,QACJ,SACA,YAEA,OAAO,eACL,OAAO,WAAW,IAAI,aAAa,SAAS,QAAQ,CAAC,GACpD,iBAAiB,OAAO,cAAc,aAAa,OAAO,CAAC,CAC7D,CAAC,KACA,OAAO,KAAK,iBAAiB;CAC3B,MAAM,MAAM;CAEZ,MAAM,WACJ,YAGA,aAEA,OAAO,WAAW;AAChB,eAAa,SACV,SAAS,OAAO,WAAW,WAAW,KAAK,CAAC,EAC7C,GAAI,WACA,EACG,oBACC,OAAO,QAAQ,SAAS,gBAAgB,CAAC,CAC5C,GACD,EAAE,CACP;GACD;CAEJ,MAAM,SACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,aAAa,MAAM,mBAAmB,YAAY;GAC7D,QAAQ,UAAU,IAAI,qBAAqB,EAAE,OAAO,CAAC;GACtD,CAAC,CACH;;CAGH,MAAM,YACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,aAAa,SAAS,mBAAmB,YAAY;GAChE,QAAQ,UAAU,IAAI,qBAAqB,EAAE,OAAO,CAAC;GACtD,CAAC,CACH;;CAGH,MAAM,UACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;AAC3B,SAAO,IAAI,aAAa,KAAK,OAAO,mBAAmB,gBACrD,OAAO,WAAW;GAChB,WAAW,aAAa,OAAO,mBAAmB,YAAY;GAC9D,QAAQ,UAAU,IAAI,qBAAqB,EAAE,OAAO,CAAC;GACtD,CAAC,CACH;;CAGH,MAAM,iBACJ,KACA,GAAG,SAIA;EACH,MAAM,OAAQ,KAAK,MAAM,EAAE;EAC3B,MAAM,oBAAoB,IAAI,qBAAqB,IAAI;AAEvD,SAAO,OAAO,aACZ,OAAO,IAAI,aAAa;GACtB,MAAM,cAAc,OAAO,IAAI,WAAW,KAAK,KAAK;AAEpD,UAAO,OAAO,aAA4C,SACxD,OAAO,IAAI,aAAa;IACtB,MAAM,cAAc,aAAa,SAC/B,mBACA,cACC,WAAW;AACV,UAAK,OAAO,OAAO;QAEpB,UAAU;AACT,UAAK,KAAK,IAAI,qBAAqB,EAAE,OAAO,OAAO,CAAC,CAAC;MAExD;AACD,WAAO,OAAO,mBACZ,OAAO,WAAW,aAAa,CAAC,CACjC;KACD,CACH;IACD,CACH,CAAC,KACA,OAAO,WAAW,mBAChB,IAAI,cAAc,KAAK,eAAe,CACvC,CACF;;AAGH,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD;EACD,CACH;;;;AAKH,MAAa,kBAAkB,QAAQ,WAErC,8BAA8B;AAIhC,MAAa,SACX,SACA,YACG,MAAM,OAAO,iBAAiB,KAAK,SAAS,QAAQ,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@confect/js",
-  "version": "4.0.0",
+  "version": "6.0.0",
   "description": "JavaScript client bindings for any JS runtime",
   "repository": {
     "type": "git",
@@ -48,7 +48,7 @@
   "peerDependencies": {
     "convex": "^1.30.0",
     "effect": "^3.19.16",
-    "@confect/core": "4.0.0"
+    "@confect/core": "6.0.0"
   },
   "engines": {
     "node": ">=22",

package/src/HttpClient.ts

@@ -1,8 +1,7 @@
 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";
+import { Context, Effect, Layer, Schema } from "effect";
 
 export class HttpClientError extends Schema.TaggedError<HttpClientError>()(
   "HttpClientError",
@@ -11,9 +10,6 @@ export class HttpClientError extends Schema.TaggedError<HttpClientError>()(
   },
 ) {}
 
-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],
@@ -31,128 +27,53 @@ const make = (
     client.clearAuth();
   });
 
-  const query = <Query extends Ref.AnyQuery>(
+  const query = <Query extends Ref.AnyPublicQuery>(
     ref: Query,
-    ...rest: OptionalArgs<Query>
+    ...rest: Ref.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 args = (rest[0] ?? {}) as Ref.Args<Query>;
+    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+      Effect.tryPromise({
+        try: () => client.query(functionReference, encodedArgs),
+        catch: (cause) => new HttpClientError({ cause }),
+      }),
+    );
+  };
 
-  const mutation = <Mutation extends Ref.AnyMutation>(
+  const mutation = <Mutation extends Ref.AnyPublicMutation>(
     ref: Mutation,
-    ...rest: OptionalArgs<Mutation>
+    ...rest: Ref.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 args = (rest[0] ?? {}) as Ref.Args<Mutation>;
+    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+      Effect.tryPromise({
+        try: () => client.mutation(functionReference, encodedArgs),
+        catch: (cause) => new HttpClientError({ cause }),
+      }),
+    );
+  };
 
-  const action = <Action extends Ref.AnyAction>(
+  const action = <Action extends Ref.AnyPublicAction>(
     ref: Action,
-    ...rest: OptionalArgs<Action>
+    ...rest: Ref.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,
-      );
-    });
+  > => {
+    const args = (rest[0] ?? {}) as Ref.Args<Action>;
+    return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+      Effect.tryPromise({
+        try: () => client.action(functionReference, encodedArgs),
+        catch: (cause) => new HttpClientError({ cause }),
+      }),
+    );
+  };
 
   return {
     url,

package/src/WebSocketClient.ts

@@ -0,0 +1,152 @@
+import * as Ref from "@confect/core/Ref";
+import { ConvexClient } from "convex/browser";
+import type { ParseResult } from "effect";
+import { Context, Effect, Layer, Schema, Stream } from "effect";
+
+export class WebSocketClientError extends Schema.TaggedError<WebSocketClientError>()(
+  "WebSocketClientError",
+  {
+    cause: Schema.Unknown,
+  },
+) {}
+
+const make = (
+  address: string,
+  options?: ConstructorParameters<typeof ConvexClient>[1],
+) =>
+  Effect.acquireRelease(
+    Effect.sync(() => new ConvexClient(address, options)),
+    (convexClient) => Effect.promise(() => convexClient.close()),
+  ).pipe(
+    Effect.map((convexClient) => {
+      const url = address;
+
+      const setAuth = (
+        fetchToken: (args: {
+          forceRefreshToken: boolean;
+        }) => Effect.Effect<string | null | undefined>,
+        onChange?: (isAuthenticated: boolean) => Effect.Effect<void>,
+      ) =>
+        Effect.sync(() => {
+          convexClient.setAuth(
+            (args) => Effect.runPromise(fetchToken(args)),
+            ...(onChange
+              ? [
+                  (isAuthenticated: boolean) =>
+                    Effect.runFork(onChange(isAuthenticated)),
+                ]
+              : []),
+          );
+        });
+
+      const query = <Query extends Ref.AnyPublicQuery>(
+        ref: Query,
+        ...rest: Ref.OptionalArgs<Query>
+      ): Effect.Effect<
+        Ref.Returns<Query>,
+        WebSocketClientError | ParseResult.ParseError
+      > => {
+        const args = (rest[0] ?? {}) as Ref.Args<Query>;
+        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+          Effect.tryPromise({
+            try: () => convexClient.query(functionReference, encodedArgs),
+            catch: (cause) => new WebSocketClientError({ cause }),
+          }),
+        );
+      };
+
+      const mutation = <Mutation extends Ref.AnyPublicMutation>(
+        ref: Mutation,
+        ...rest: Ref.OptionalArgs<Mutation>
+      ): Effect.Effect<
+        Ref.Returns<Mutation>,
+        WebSocketClientError | ParseResult.ParseError
+      > => {
+        const args = (rest[0] ?? {}) as Ref.Args<Mutation>;
+        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+          Effect.tryPromise({
+            try: () => convexClient.mutation(functionReference, encodedArgs),
+            catch: (cause) => new WebSocketClientError({ cause }),
+          }),
+        );
+      };
+
+      const action = <Action extends Ref.AnyPublicAction>(
+        ref: Action,
+        ...rest: Ref.OptionalArgs<Action>
+      ): Effect.Effect<
+        Ref.Returns<Action>,
+        WebSocketClientError | ParseResult.ParseError
+      > => {
+        const args = (rest[0] ?? {}) as Ref.Args<Action>;
+        return Ref.runWithCodec(ref, args, (functionReference, encodedArgs) =>
+          Effect.tryPromise({
+            try: () => convexClient.action(functionReference, encodedArgs),
+            catch: (cause) => new WebSocketClientError({ cause }),
+          }),
+        );
+      };
+
+      const reactiveQuery = <Query extends Ref.AnyPublicQuery>(
+        ref: Query,
+        ...rest: Ref.OptionalArgs<Query>
+      ): Stream.Stream<
+        Ref.Returns<Query>,
+        WebSocketClientError | ParseResult.ParseError
+      > => {
+        const args = (rest[0] ?? {}) as Ref.Args<Query>;
+        const functionReference = Ref.getFunctionReference(ref);
+
+        return Stream.unwrapScoped(
+          Effect.gen(function* () {
+            const encodedArgs = yield* Ref.encodeArgs(ref, args);
+
+            return Stream.asyncScoped<unknown, WebSocketClientError>((emit) =>
+              Effect.gen(function* () {
+                const unsubscribe = convexClient.onUpdate(
+                  functionReference,
+                  encodedArgs,
+                  (result) => {
+                    emit.single(result);
+                  },
+                  (error) => {
+                    emit.fail(new WebSocketClientError({ cause: error }));
+                  },
+                );
+                yield* Effect.addFinalizer(() =>
+                  Effect.sync(() => unsubscribe()),
+                );
+              }),
+            );
+          }),
+        ).pipe(
+          Stream.mapEffect((encodedReturns) =>
+            Ref.decodeReturns(ref, encodedReturns),
+          ),
+        );
+      };
+
+      return {
+        url,
+        setAuth,
+        query,
+        mutation,
+        action,
+        reactiveQuery,
+      };
+    }),
+  );
+
+/**
+ * A Confect client which uses a WebSocket to communicate with your Convex backend and supports reactive query subscriptions. The WebSocket connection is managed by the layer's scope and closed automatically when the scope ends. Wraps [ConvexClient](https://docs.convex.dev/api/classes/browser.ConvexClient).
+ */
+export const WebSocketClient = Context.GenericTag<
+  Effect.Effect.Success<ReturnType<typeof make>>
+>("@confect/js/WebSocketClient");
+
+export type WebSocketClient = typeof WebSocketClient.Identifier;
+
+export const layer = (
+  address: string,
+  options?: ConstructorParameters<typeof ConvexClient>[1],
+) => Layer.scoped(WebSocketClient, make(address, options));

package/src/index.ts

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