@ttoss/graphql-api 0.2.0 → 0.3.1

package/README.md

@@ -163,6 +163,52 @@ composeWithConnection(AuthorTC, {
 });
 ```
 
+### Middlewares
+
+This package provides a way to add middlewares to your final schema. You can add middlewares compatible with [`graphql-middleware`](https://github.com/dimatill/graphql-middleware) by passing them to the `middlewares` option on `buildSchema` method. For example, you can use [GraphQL Shield](https://the-guild.dev/graphql/shield) to add authorization to your API:
+
+```typescript
+import { buildSchema } from '@ttoss/graphql-api';
+import { allow, deny, shield } from '@ttoss/graphql-api/shield';
+import { schemaComposer } from './schemaComposer';
+
+const NotAuthorizedError = new Error('Not authorized!');
+/**
+ * The error name is the same value `errorType` on GraphQL errors response.
+ */
+NotAuthorizedError.name = 'NotAuthorizedError';
+
+const permissions = shield(
+  {
+    Query: {
+      '*': deny,
+      author: allow,
+    },
+    Author: {
+      id: allow,
+      name: allow,
+    },
+  },
+  {
+    fallbackRule: deny,
+    fallbackError: NotAuthorizedError,
+  }
+);
+
+const schema = buildSchema({
+  schemaComposer,
+  middlewares; [permissions],
+})
+```
+
+#### Shield
+
+This package re-exports the all methods from [GraphQL Shield](https://the-guild.dev/graphql/shield).
+
+```typescript
+import { allow, deny, shield } from '@ttoss/graphql-api/shield';
+```
+
 ## Building Schema
 
 As Relay needs an introspection query to work, this package provides a way to build the GraphQL schema by running `ttoss-graphl-api build-schema`.
@@ -171,6 +217,16 @@ As Relay needs an introspection query to work, this package provides a way to bu
 ttoss-graphl-api build-schema
 ```
 
+You can add the `schema` script to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "schema": "ttoss-graphl-api build-schema"
+  }
+}
+```
+
 ## How to Create Tests
 
 We recommend testing the whole GraphQL API using the `graphql` object and the schema composer to provide the schema. For example:

package/dist/esm/index.js

@@ -153,4 +153,25 @@ composeWithRelay(schemaComposer.Query);
 // src/index.ts
 import { default as default2 } from "graphql-compose-connection";
 export * from "graphql-compose";
-export { default2 as composeWithConnection, composeWithRelay, fromGlobalId, toGlobalId };
+
+// src/buildSchema.ts
+import { applyMiddleware } from "graphql-middleware";
+var buildSchema = ({
+  schemaComposer: schemaComposer2,
+  middlewares
+}) => {
+  if (!schemaComposer2) {
+    throw new Error("No schemaComposer provided");
+  }
+  const schema = schemaComposer2.buildSchema();
+  if (middlewares) {
+    return applyMiddleware(schema, ...middlewares.map(middleware => {
+      if (middleware.generate) {
+        return middleware.generate(schema);
+      }
+      return middleware;
+    }));
+  }
+  return schema;
+};
+export { buildSchema, default2 as composeWithConnection, composeWithRelay, fromGlobalId, toGlobalId };

package/dist/esm/shield.js

@@ -0,0 +1,4 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+
+// src/shield.ts
+export * from "graphql-shield";

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { ObjectTypeComposer } from 'graphql-compose';
+import { ObjectTypeComposer, SchemaComposer } from 'graphql-compose';
 export * from 'graphql-compose';
 export { default as composeWithConnection } from 'graphql-compose-connection';
+import { GraphQLSchema } from 'graphql';
+import { IMiddleware, IMiddlewareGenerator } from 'graphql-middleware';
 
 declare const composeWithRelay: <TContext>(tc: ObjectTypeComposer<any, TContext>) => ObjectTypeComposer<any, TContext>;
 
@@ -19,4 +21,10 @@ declare const toGlobalId: (type: string, recordId: string | number) => string;
  */
 declare const fromGlobalId: (globalId: string) => ResolvedGlobalId;
 
-export { composeWithRelay, fromGlobalId, toGlobalId };
+type BuildSchemaInput<TContext = any> = {
+    schemaComposer: SchemaComposer<TContext>;
+    middlewares?: (IMiddleware | IMiddlewareGenerator<any, TContext, any>)[];
+};
+declare const buildSchema: ({ schemaComposer, middlewares, }: BuildSchemaInput) => GraphQLSchema;
+
+export { BuildSchemaInput, buildSchema, composeWithRelay, fromGlobalId, toGlobalId };

package/dist/index.js

@@ -39,6 +39,7 @@ var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  buildSchema: () => buildSchema,
   composeWithConnection: () => import_graphql_compose_connection.default,
   composeWithRelay: () => composeWithRelay,
   fromGlobalId: () => fromGlobalId,
@@ -198,8 +199,30 @@ composeWithRelay(import_graphql_compose4.schemaComposer.Query);
 // src/index.ts
 var import_graphql_compose_connection = __toESM(require("graphql-compose-connection"));
 __reExport(src_exports, require("graphql-compose"), module.exports);
+
+// src/buildSchema.ts
+var import_graphql_middleware = require("graphql-middleware");
+var buildSchema = ({
+  schemaComposer: schemaComposer2,
+  middlewares
+}) => {
+  if (!schemaComposer2) {
+    throw new Error("No schemaComposer provided");
+  }
+  const schema = schemaComposer2.buildSchema();
+  if (middlewares) {
+    return (0, import_graphql_middleware.applyMiddleware)(schema, ...middlewares.map(middleware => {
+      if (middleware.generate) {
+        return middleware.generate(schema);
+      }
+      return middleware;
+    }));
+  }
+  return schema;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  buildSchema,
   composeWithConnection,
   composeWithRelay,
   fromGlobalId,

package/dist/shield.d.ts

@@ -0,0 +1,2 @@
+export * from 'graphql-shield';
+export { IMiddleware, IMiddlewareFieldMap, IMiddlewareFunction, IMiddlewareGenerator, IMiddlewareGeneratorConstructor, IMiddlewareTypeMap } from 'graphql-middleware';

package/dist/shield.js

@@ -0,0 +1,29 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+
+// src/shield.ts
+var shield_exports = {};
+module.exports = __toCommonJS(shield_exports);
+__reExport(shield_exports, require("graphql-shield"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("graphql-shield")
+});

package/package.json

@@ -1,11 +1,21 @@
 {
   "name": "@ttoss/graphql-api",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "A library for building GraphQL APIs.",
   "author": "ttoss",
   "contributors": [
     "Pedro Arantes <pedro@arantespp.com> (https://arantespp.com)"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/index.js"
+    },
+    "./shield": {
+      "import": "./dist/esm/shield.js",
+      "require": "./dist/shield.js"
+    }
+  },
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
   "bin": {
@@ -20,6 +30,8 @@
   "dependencies": {
     "graphql-compose": "^9.0.10",
     "graphql-compose-connection": "^8.2.1",
+    "graphql-middleware": "^6.1.34",
+    "graphql-shield": "^7.6.5",
     "npmlog": "^7.0.1",
     "ts-node": "^10.9.1",
     "yargs": "^17.7.2"
@@ -32,7 +44,7 @@
     "graphql": "^16.6.0",
     "jest": "^29.5.0",
     "tsup": "^6.7.0",
-    "@ttoss/config": "^1.30.0"
+    "@ttoss/config": "^1.30.1"
   },
   "keywords": [
     "api",
@@ -41,6 +53,16 @@
   "publishConfig": {
     "access": "public"
   },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/index.d.ts"
+      ],
+      "shield": [
+        "./dist/shield.d.ts"
+      ]
+    }
+  },
   "scripts": {
     "build": "tsup",
     "test": "jest"

package/src/buildSchema.ts

@@ -0,0 +1,45 @@
+import { type GraphQLSchema } from 'graphql';
+import {
+  type IMiddleware,
+  type IMiddlewareGenerator,
+  applyMiddleware,
+} from 'graphql-middleware';
+import { type SchemaComposer } from 'graphql-compose';
+
+export type { IMiddleware, IMiddlewareGenerator };
+
+export type BuildSchemaInput<TContext = any> = {
+  schemaComposer: SchemaComposer<TContext>;
+  middlewares?: (IMiddleware | IMiddlewareGenerator<any, TContext, any>)[];
+};
+
+export const buildSchema = ({
+  schemaComposer,
+  middlewares,
+}: BuildSchemaInput): GraphQLSchema => {
+  if (!schemaComposer) {
+    throw new Error('No schemaComposer provided');
+  }
+
+  const schema = schemaComposer.buildSchema();
+
+  if (middlewares) {
+    return applyMiddleware(
+      schema,
+      ...middlewares.map((middleware) => {
+        /**
+         * https://github.com/dimatill/graphql-middleware/issues/433#issuecomment-1170187160
+         */
+        if ((middleware as IMiddlewareGenerator<any, any, any>).generate) {
+          return (middleware as IMiddlewareGenerator<any, any, any>).generate(
+            schema
+          );
+        }
+
+        return middleware;
+      })
+    );
+  }
+
+  return schema;
+};

package/src/index.ts

@@ -1,3 +1,4 @@
 export { composeWithRelay, toGlobalId, fromGlobalId } from './composeWithRelay';
 export { default as composeWithConnection } from 'graphql-compose-connection';
 export * from 'graphql-compose';
+export { buildSchema, type BuildSchemaInput } from './buildSchema';

package/src/shield.ts

@@ -0,0 +1,14 @@
+export * from 'graphql-shield';
+/**
+ * Export types from graphql-middleware to avoid "The inferred type of 'x'
+ * cannot be named without a reference to '.../graphql-middleware/index.d.ts(1,1)'.
+ * This is likely not portable. A type annotation is necessary."
+ */
+export type {
+  IMiddlewareGenerator,
+  IMiddleware,
+  IMiddlewareFieldMap,
+  IMiddlewareFunction,
+  IMiddlewareGeneratorConstructor,
+  IMiddlewareTypeMap,
+} from 'graphql-middleware';