feat(gqlorm): Prisma inspired GraphQL query builder (#1223)

```ts
useLiveQuery((gqlorm) => gqlorm.user.findMany())
```

From Greptile's summary below:

- Implemented a complete query builder system with three core
components: QueryBuilder (proxy-based query capture), QueryParser (ORM
to AST conversion), and GraphQLGenerator (AST to GraphQL string
generation)
- Added `useLiveQuery` React hook that integrates with `@cedarjs/web` to
provide real-time data fetching using the `@live` directive
- Created comprehensive TypeScript type definitions with module
augmentation support allowing Cedar to inject its db type for full type
safety
- Integrated gqlorm into Cedar's internal type generation system to
automatically augment the `GqlormTypeMap` interface with the framework's
database client type
- Includes test coverage for core functionality including `findUnique`,
`findMany`, `findFirst` operations and live query configuration

Author: Tobbe

eslint.config.mjs

@@ -290,6 +290,7 @@ export default [
   {
     files: [
       '**/.babelrc.js',
+      '**/.babelrc.cjs',
       '**/babel.config.js',
       '**/jest.config.js',
       '**/jest.setup.js',

packages/gqlorm/.babelrc.cjs

@@ -0,0 +1 @@
+module.exports = { extends: '../../babel.config.js' }

packages/gqlorm/README.md

@@ -0,0 +1,3 @@
+# gqlorm
+
+Prisma inspired GraphQL query builder

packages/gqlorm/attw.ts

@@ -0,0 +1,31 @@
+import { $ } from 'zx'
+
+interface Problem {
+  kind: string
+  entrypoint?: string
+  resolutionKind?: string
+}
+
+await $({ nothrow: true })`yarn attw -P -f json > .attw.json`
+const output = await $`cat .attw.json`
+await $`rm .attw.json`
+
+const json = JSON.parse(output.stdout)
+
+if (!json.analysis.problems || json.analysis.problems.length === 0) {
+  console.log('No errors found')
+  process.exit(0)
+}
+
+if (
+  json.analysis.problems.every(
+    (problem: Problem) => problem.resolutionKind === 'node10',
+  )
+) {
+  console.log("Only found node10 problems, which we don't care about")
+  process.exit(0)
+}
+
+console.log('Errors found')
+console.log(json.analysis.problems)
+process.exit(1)

packages/gqlorm/build.ts

@@ -0,0 +1,14 @@
+import { buildExternalCjs, buildExternalEsm } from '@cedarjs/framework-tools'
+import {
+  generateTypesCjs,
+  generateTypesEsm,
+  insertCommonJsPackageJson,
+} from '@cedarjs/framework-tools/generateTypes'
+
+await buildExternalEsm()
+await generateTypesEsm()
+
+await buildExternalCjs()
+await generateTypesCjs()
+
+await insertCommonJsPackageJson({ buildFileUrl: import.meta.url })

packages/gqlorm/package.json

@@ -0,0 +1,164 @@
+{
+  "name": "@cedarjs/gqlorm",
+  "version": "2.6.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cedarjs/cedar.git",
+    "directory": "packages/gqlorm"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/queryBuilder.d.ts",
+        "default": "./dist/queryBuilder.js"
+      },
+      "require": {
+        "types": "./dist/cjs/queryBuilder.d.ts",
+        "default": "./dist/cjs/queryBuilder.js"
+      }
+    },
+    "./queryBuilder": {
+      "import": {
+        "types": "./dist/queryBuilder.d.ts",
+        "default": "./dist/queryBuilder.js"
+      },
+      "require": {
+        "types": "./dist/cjs/queryBuilder.d.ts",
+        "default": "./dist/cjs/queryBuilder.js"
+      }
+    },
+    "./react/useLiveQuery": {
+      "import": {
+        "types": "./dist/react/useLiveQuery.d.ts",
+        "default": "./dist/react/useLiveQuery.js"
+      },
+      "require": {
+        "types": "./dist/cjs/react/useLiveQuery.d.ts",
+        "default": "./dist/cjs/react/useLiveQuery.js"
+      }
+    },
+    "./parser/queryParser": {
+      "import": {
+        "types": "./dist/parser/queryParser.d.ts",
+        "default": "./dist/parser/queryParser.js"
+      },
+      "require": {
+        "types": "./dist/cjs/parser/queryParser.d.ts",
+        "default": "./dist/cjs/parser/queryParser.js"
+      }
+    },
+    "./generator/graphqlGenerator": {
+      "import": {
+        "types": "./dist/generator/graphqlGenerator.d.ts",
+        "default": "./dist/generator/graphqlGenerator.js"
+      },
+      "require": {
+        "types": "./dist/cjs/generator/graphqlGenerator.d.ts",
+        "default": "./dist/cjs/generator/graphqlGenerator.js"
+      }
+    },
+    "./live/types": {
+      "import": {
+        "types": "./dist/live/types.d.ts",
+        "default": "./dist/live/types.js"
+      },
+      "require": {
+        "types": "./dist/cjs/live/types.d.ts",
+        "default": "./dist/cjs/live/types.js"
+      }
+    },
+    "./types/ast": {
+      "import": {
+        "types": "./dist/types/ast.d.ts",
+        "default": "./dist/types/ast.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/ast.d.ts",
+        "default": "./dist/cjs/types/ast.js"
+      }
+    },
+    "./types/orm": {
+      "import": {
+        "types": "./dist/types/orm.d.ts",
+        "default": "./dist/types/orm.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/orm.d.ts",
+        "default": "./dist/cjs/types/orm.js"
+      }
+    },
+    "./types/schema": {
+      "import": {
+        "types": "./dist/types/schema.d.ts",
+        "default": "./dist/types/schema.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/schema.d.ts",
+        "default": "./dist/cjs/types/schema.js"
+      }
+    },
+    "./types/typeUtils": {
+      "import": {
+        "types": "./dist/types/typeUtils.d.ts",
+        "default": "./dist/types/typeUtils.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/typeUtils.d.ts",
+        "default": "./dist/cjs/types/typeUtils.js"
+      }
+    }
+  },
+  "main": "dist/queryBuilder.js",
+  "types": "dist/queryBuilder.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsx ./build.ts",
+    "build:pack": "yarn pack -o cedarjs-gqlorm.tgz",
+    "build:types": "tsc --build --verbose tsconfig.build.json",
+    "build:types-cjs": "tsc --build --verbose tsconfig.cjs.json",
+    "build:watch": "nodemon --watch src --ext \"js,jsx,ts,tsx\" --ignore dist --exec \"yarn build\"",
+    "check:attw": "tsx ./attw.ts",
+    "check:package": "concurrently npm:check:attw yarn publint",
+    "prepublishOnly": "NODE_ENV=production yarn build",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
+  },
+  "dependencies": {
+    "@babel/runtime-corejs3": "7.29.0",
+    "@cedarjs/auth": "workspace:*",
+    "@cedarjs/server-store": "workspace:*",
+    "@cedarjs/web": "workspace:*",
+    "core-js": "3.48.0",
+    "graphql": "16.12.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-server-dom-webpack": "19.2.4"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.2",
+    "@babel/cli": "7.28.6",
+    "@babel/core": "^7.26.10",
+    "@cedarjs/framework-tools": "workspace:*",
+    "@testing-library/jest-dom": "6.9.1",
+    "@types/react": "^18.2.55",
+    "@types/react-dom": "^18.2.19",
+    "concurrently": "9.2.1",
+    "publint": "0.3.17",
+    "tstyche": "5.0.2",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "peerDependencies": {
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "3905ed045508b861b495f8d5630d76c7a157d8f1"
+}

packages/gqlorm/src/__tests__/queryBuilder.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  buildQuery,
+  buildQueryFromFunction,
+  QueryBuilder,
+} from '../queryBuilder.js'
+import type * as OrmTypes from '../types/orm.js'
+
+interface CedarUser {
+  id: number
+  createdAt: Date
+  updatedAt: Date
+  email: string
+  name: string
+  isActive: boolean
+}
+
+interface CedarPost {
+  id: number
+  createdAt: Date
+  updatedAt: Date
+  title: string
+  published: boolean
+}
+
+declare module '../types/orm.js' {
+  interface GqlormTypeMap {
+    db: {
+      user: OrmTypes.ModelDelegate<CedarUser>
+      post: OrmTypes.ModelDelegate<CedarPost>
+    }
+  }
+}
+
+describe('QueryBuilder', () => {
+  it('builds a live query when requested', () => {
+    const result = buildQuery(
+      'user',
+      'findMany',
+      { where: { isActive: true } },
+      { isLive: true },
+    )
+
+    expect(result.query).toContain('@live')
+    expect(result.query).toContain('users')
+    expect(result.variables).toEqual({ var0: true })
+  })
+
+  it('supports findUnique', () => {
+    const result = buildQueryFromFunction(
+      (gqlorm) =>
+        gqlorm.user.findUnique({
+          where: { id: 1 },
+          select: { id: true, name: true },
+        }),
+      { isLive: true },
+    )
+
+    expect(result.query).toContain('user(')
+    expect(result.query).toContain('@live')
+    expect(result.query).toMatch(/\bname\b/)
+    expect(result.query).not.toContain('createdAt')
+    expect(Object.values(result.variables || {})).toEqual([1])
+  })
+
+  it('supports findMany', () => {
+    const result = buildQueryFromFunction((gqlorm) =>
+      gqlorm.user.findMany({
+        where: { isActive: true },
+        select: {
+          id: true,
+          email: true,
+          // @ts-expect-error - Making sure types are correct
+          doesNotExist: false,
+        },
+      }),
+    )
+
+    expect(result.query).toContain('query findManyUser')
+    expect(result.query).toContain('users')
+    expect(result.query).toMatch(/\bid\b/)
+    expect(result.query).toMatch(/\bemail\b/)
+    expect(Object.values(result.variables || {})).toEqual([true])
+  })
+
+  it('supports findFirst', () => {
+    const result = buildQueryFromFunction((gqlorm) =>
+      gqlorm.post.findFirst({
+        where: {
+          AND: [{ published: true }, { createdAt: { gt: new Date(0) } }],
+        },
+        select: { id: true, title: true },
+      }),
+    )
+
+    expect(result.query).toContain('query findFirstPost')
+    expect(result.query).toContain('post(')
+    expect(result.query).toMatch(/\bid\b/)
+    expect(result.query).toMatch(/\btitle\b/)
+    expect(result.variables).toEqual({ var0: true, var1: new Date(0) })
+  })
+
+  it('respects forceLiveQueries but allows explicit override', () => {
+    const qb = new QueryBuilder({ forceLiveQueries: true })
+
+    const forcedLive = qb.build('user', 'findMany')
+    expect(forcedLive.query).toContain('@live')
+
+    const explicitNonLive = qb.build('user', 'findMany', undefined, {
+      isLive: false,
+    })
+    expect(explicitNonLive.query).not.toContain('@live')
+  })
+})