feat: add @constructive-io/react package with React Query hooks and JSDoc comments

Author: pyramation

pnpm-lock.yaml

@@ -0,0 +1,26 @@
+# GraphQL SDK
+
+<p align="center" width="100%">
+  <img height="120" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+## APIs
+
+| API | Endpoint | Generators | Docs |
+|-----|----------|------------|------|
+| admin | - | React Query, ORM | [./src/admin/README.md](./src/admin/README.md) |
+| auth | - | React Query, ORM | [./src/auth/README.md](./src/auth/README.md) |
+| objects | - | React Query, ORM | [./src/objects/README.md](./src/objects/README.md) |
+| public | - | React Query, ORM | [./src/public/README.md](./src/public/README.md) |
+
+---
+
+Built by the [Constructive](https://constructive.io) team.
+
+## Disclaimer
+
+AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
+
+No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.

sdk/constructive-react/README.md

@@ -0,0 +1,61 @@
+{
+  "name": "@constructive-io/react",
+  "version": "0.0.1",
+  "author": "Constructive <developers@constructive.io>",
+  "description": "Constructive React - Auto-generated React Query hooks and ORM client",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "homepage": "https://github.com/constructive-io/constructive",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/constructive-io/constructive"
+  },
+  "bugs": {
+    "url": "https://github.com/constructive-io/constructive/issues"
+  },
+  "scripts": {
+    "clean": "makage clean",
+    "prepack": "npm run build",
+    "build": "makage build",
+    "build:dev": "makage build --dev",
+    "generate": "tsx scripts/generate-react.ts",
+    "lint": "eslint . --fix",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
+  "keywords": [
+    "graphql",
+    "sdk",
+    "orm",
+    "react-query",
+    "tanstack-query",
+    "constructive",
+    "postgraphile",
+    "schema-dir"
+  ],
+  "dependencies": {
+    "@0no-co/graphql.web": "^1.1.2",
+    "@constructive-io/graphql-types": "workspace:^",
+    "@tanstack/react-query": "^5.90.19",
+    "gql-ast": "workspace:^",
+    "graphql": "^16.12.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@constructive-io/graphql-codegen": "workspace:^",
+    "@types/node": "^20.12.7",
+    "@types/react": "^19.2.8",
+    "makage": "^0.1.12",
+    "react": "^19.2.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3"
+  }
+}

sdk/constructive-react/package.json

@@ -0,0 +1,74 @@
+import {
+  generateMulti,
+  expandSchemaDirToMultiTarget,
+} from '@constructive-io/graphql-codegen';
+
+const SCHEMA_DIR = '../constructive-sdk/schemas';
+
+const EXCLUDE_TARGETS = ['private'];
+
+async function main() {
+  console.log('Generating React SDK from schema files...');
+  console.log(`Schema directory: ${SCHEMA_DIR}`);
+
+  const baseConfig = {
+    schemaDir: SCHEMA_DIR,
+    output: './src',
+    orm: true,
+    reactQuery: true,
+    verbose: true,
+    docs: {
+      agents: false,
+      mcp: false,
+      skills: true
+    }
+  };
+
+  const expanded = expandSchemaDirToMultiTarget(baseConfig);
+  if (!expanded) {
+    console.error('No .graphql files found in schema directory.');
+    console.error('Ensure .graphql schema files exist in the schemas/ directory.');
+    process.exit(1);
+  }
+
+  for (const target of EXCLUDE_TARGETS) {
+    if (target in expanded) {
+      delete expanded[target];
+      console.log(`Excluding target: ${target}`);
+    }
+  }
+
+  console.log(`Found targets: ${Object.keys(expanded).join(', ')}`);
+
+  const { results, hasError } = await generateMulti({
+    configs: expanded,
+  });
+
+  let realError = false;
+
+  for (const { name, result } of results) {
+    if (result.success) {
+      console.log(`[${name}] ${result.message}`);
+      if (result.tables?.length) {
+        console.log(`  Tables: ${result.tables.join(', ')}`);
+      }
+    } else if (result.message?.includes('No tables found')) {
+      console.log(`[${name}] SKIP: no tables (empty schema)`);
+    } else {
+      console.error(`[${name}] ERROR: ${result.message}`);
+      realError = true;
+    }
+  }
+
+  if (realError) {
+    console.error('\nReact SDK generation failed for one or more targets');
+    process.exit(1);
+  }
+
+  console.log('\nReact SDK generation completed successfully!');
+}
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

sdk/constructive-react/scripts/generate-react.ts

@@ -0,0 +1,54 @@
+# Generated GraphQL SDK
+
+<p align="center" width="100%">
+  <img height="120" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+## Overview
+
+- **Tables:** 28
+- **Custom queries:** 10
+- **Custom mutations:** 2
+
+**Generators:** ORM, React Query
+
+## Modules
+
+### ORM Client (`./orm`)
+
+Prisma-like ORM client for programmatic GraphQL access.
+
+```typescript
+import { createClient } from './orm';
+
+const db = createClient({
+  endpoint: 'https://api.example.com/graphql',
+});
+```
+
+See [orm/README.md](./orm/README.md) for full API reference.
+
+### React Query Hooks (`./hooks`)
+
+Type-safe React Query hooks for data fetching and mutations.
+
+```typescript
+import { configure } from './hooks';
+import { useCarsQuery } from './hooks';
+
+configure({ endpoint: 'https://api.example.com/graphql' });
+```
+
+See [hooks/README.md](./hooks/README.md) for full hook reference.
+
+---
+
+Built by the [Constructive](https://constructive.io) team.
+
+## Disclaimer
+
+AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
+
+No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.