@effect-gql/core 1.1.0 → 1.3.0

package/README.md

@@ -11,7 +11,33 @@ A GraphQL framework for Effect-TS that brings full type safety, composability, a
 - **Immutable Builder** - Fluent, pipe-able API for composing schemas from reusable parts
 - **Service Integration** - Use Effect's Layer system for dependency injection
 
-## Installation
+## Getting Started
+
+The easiest way to get started is with the CLI:
+
+```bash
+# Create a new project
+npx @effect-gql/cli create my-api --server-type node
+
+# Start the dev server
+cd my-api
+npm run dev
+```
+
+Your GraphQL server will be running at http://localhost:4000/graphql with a GraphiQL playground at http://localhost:4000/graphiql.
+
+### Server Types
+
+The CLI supports multiple server runtimes:
+
+| Type | Command | Best For |
+|------|---------|----------|
+| Node.js | `--server-type node` | General Node.js deployments |
+| Bun | `--server-type bun` | Bun runtime with native WebSocket support |
+| Express | `--server-type express` | Integrating into existing Express apps |
+| Web | `--server-type web` | Cloudflare Workers, Deno, edge runtimes |
+
+## Manual Installation
 
 ```bash
 npm install @effect-gql/core effect graphql

package/index.cjs

@@ -6,7 +6,6 @@ var S2 = require('effect/Schema');
 var AST = require('effect/SchemaAST');
 var DataLoader = require('dataloader');
 var platform = require('@effect/platform');
-var graphqlWs = require('graphql-ws');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -2896,27 +2895,45 @@ var runConnectionLifecycle = (socket, wsServer, extra) => effect.Effect.gen(func
   effect.Effect.catchAllCause(() => effect.Effect.void),
   effect.Effect.scoped
 );
+var importGraphqlWs = effect.Effect.tryPromise({
+  try: () => import('graphql-ws'),
+  catch: () => new Error(
+    "graphql-ws is required for WebSocket subscriptions. Install it with: npm install graphql-ws"
+  )
+});
 var makeGraphQLWSHandler = (schema, layer, options) => {
   const complexityConfig = options?.complexity;
   const fieldComplexities = options?.fieldComplexities ?? /* @__PURE__ */ new Map();
-  const serverOptions = {
-    schema,
-    context: async (ctx) => {
-      const extra = ctx.extra;
-      return {
-        runtime: extra.runtime,
-        ...extra.connectionParams
-      };
-    },
-    subscribe: async (args) => graphql.subscribe(args),
-    onConnect: makeOnConnectHandler(options),
-    onDisconnect: makeOnDisconnectHandler(options),
-    onSubscribe: makeOnSubscribeHandler(options, schema, complexityConfig, fieldComplexities),
-    onComplete: makeOnCompleteHandler(options),
-    onError: makeOnErrorHandler(options)
+  let wsServerPromise = null;
+  const getOrCreateServer = async () => {
+    if (!wsServerPromise) {
+      wsServerPromise = effect.Effect.runPromise(importGraphqlWs).then(({ makeServer }) => {
+        const serverOptions = {
+          schema,
+          context: async (ctx) => {
+            const extra = ctx.extra;
+            return {
+              runtime: extra.runtime,
+              ...extra.connectionParams
+            };
+          },
+          subscribe: async (args) => graphql.subscribe(args),
+          onConnect: makeOnConnectHandler(options),
+          onDisconnect: makeOnDisconnectHandler(options),
+          onSubscribe: makeOnSubscribeHandler(options, schema, complexityConfig, fieldComplexities),
+          onComplete: makeOnCompleteHandler(options),
+          onError: makeOnErrorHandler(options)
+        };
+        return makeServer(serverOptions);
+      });
+    }
+    return wsServerPromise;
   };
-  const wsServer = graphqlWs.makeServer(serverOptions);
   return (socket) => effect.Effect.gen(function* () {
+    const wsServer = yield* effect.Effect.tryPromise({
+      try: () => getOrCreateServer(),
+      catch: (error) => error
+    });
     const runtime = yield* effect.Effect.provide(effect.Effect.runtime(), layer);
     const extra = {
       socket,