{"bugs":{"url":"https://github.com/dotansimha/graphql-toolkit/issues"},"dist":{"shasum":"028eb9b660b3cb5788cd838874fb2a3a7f1606c1","tarball":"https://registry.npmjs.org/graphql-toolkit/-/graphql-toolkit-0.5.12-e05e214.0.tgz","fileCount":258,"integrity":"sha512-p3lK4Qj4E57Jhfp7BYdr9mf7TqPQdVb+a88TgeA6mxvi+KWB0b0OBF9W/QttApV2g3H3Ls0JLaeTT7Ss9ufRCA==","signatures":[{"sig":"MEUCIDvyY1YkU0odtaUnRoKH5gcfJ1q8kqrkntjetQKqvAKkAiEAihhSwpsM0fVN57rMn9dv9bbWb/UeHQcwLBIgs2GIAZo=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":403836,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJdbfjGCRA9TVsSAnZWagAAIaMP/jfxmDGRnGmJ3wjAqHdD\n2pjmtpMTkwDnO7MWdcnFqGib0ue/itf+yZTES1lnN4meZEbXgQ9pfgG79F3M\ni7afZsrSXwSrFUnga7IiDE1msSJ12xoho2OCv8XkqSkeoOP+jZHSOrd4+rxh\nWB+scKiWCbawgQ4hPcbOpoITwPKU/eMSVcQGTh0elD0aCmeP+YILImFiAlLa\nB3sU/0MJbj/AbR9fgJWzivWdmzbgJX5SkQGrh7tBebU3IhE8stnENsQjn7Md\nC+AJA/f/70rDTpwLmmH4E1p45epCJtCva4mdGkdVW7o5A73jczOnJSWtK/79\ngF6HWffM1M3qIXNHDBetMXwe9cjACdX9YvZJOyuCCsWzm+/HiHk38rWIAYup\nx10b7NhjWZRYDaKwOaK5rj84YU3i09gBTzU+CxcPpCYRAWCyov3rvHG2fu+F\n0FA+IUF+dDOKsL3/1nwKyjhTFUCqPFktGAewmxPlKaNlh8ogyFokKWPd8a8H\n1nYKEZ1/+P1UsnNUQu6LD4iGADKmnsz5qie9+MLVIKJeXoJ1V77s1jjtiXuf\ncqtm+4hCTJzb4Co6sRXRCeCg1ZOUuO7aFr5UuYqV84/m+As91L2DNyHGsZnM\noyxRNZeC4wGuUhuU83vF4RzCn+MWxrHSParJB5NDNCid9YvajYWHTRycuPW3\neqfH\r\n=df3h\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/commonjs/index.js","name":"graphql-toolkit","author":{"name":"Dotan Simha","email":"dotansimha@gmail.com"},"module":"dist/esnext/index.js","readme":"# graphql-toolkit\n\nA set of utils for faster development of GraphQL tools. Use these utils if you are creating a tool that loads schema/documents, merges schemas, scan for schema/documents/resolvers files.\n\nIncluded tools:\n\n### Schema Loading\n\nThese utils are useful for scanning, loading and building a GraphQL schema from any input.\n\nYou can either specify a GraphQL endpoint, local introspection JSON file, code file that `export`s a GraphQLSchema, AST string and `.graphql` files (with support for `glob` expression).\n\nIt also merges all found schema files into a complete schema, and has support for `#import` syntax (using [`graphql-import`](https://github.com/prisma/graphql-import)).\n\nYou can also extend the loads by implementing you own loader (implement the interface `SchemaLoader`).\n\nThe schema loading util is using loaders, and implemented using [chain-of-responsibility pattern](https://en.wikipedia.org/wiki/Chain-of-responsibility_pattern). \n\nYou don't have to specify which loader to use - just provide your input and this utils will detect it automatically.\n\nUsage:\n\n```ts\nimport { loadSchema } from 'graphql-toolkit';\n\nconst schema1 = loadSchema('type A { foo: String }'); // load from string\nconst schema2 = loadSchema('http://localhost:3000/graphql'); // load from endpoint\nconst schema3 = loadSchema('./schema.json'); // load from local json file\nconst schema4 = loadSchema('schema.graphql'); // load from a single schema file\nconst schema5 = loadSchema('./src/**/*.graphql'); // load from multiple files using glob\n```\n\n### Documents Loading\n\nSimilar to schema loading - but meant to use for GraphQL documents (query/mutation/subscription/fragment).\n\nYou an specify any input as source, and this utils will detect it automatically. \n\nIt also extracts usages of `gql` from code files using [`graphql-tag-pluck`](https://github.com/DAB0mB/graphql-tag-pluck).\n\nUsage:\n\n```ts\nimport { loadDocuments } from 'graphql-toolkit';\n\nconst document1 = loadDocuments('query { f }'); // load from string\nconst document2 = loadDocuments('./users.query.graphql'); // load from a single file \nconst document3 = loadDocuments('./src/**/*.graphql'); // load from multiple files using glob\nconst document4 = loadDocuments('./src/my-component.ts'); // load from code file\n```\n\n### Epoxy\n\nOriginally implemented in [graphql-modules](https://github.com/Urigo/graphql-modules). This tools merged GraphQL type definitions and schema. It aims to merge all possible types, interfaces, enums and unions, without conflicts.\n\nIt also merged resolvers by using deep-merge, so you can separate your resolvers implementating across multiple objects and the merge it into a single `resolvers` object.\n\n```graphql\n# a1.graphql\ntype A {\n    f1: String\n}\n\n# a2.graphql\ntype A {\n    f2: String\n}\n```\n\nWill result:\n```graphql\ntype A {\n    f1: String\n    f2: String\n}\n```\n\n### Sonar\n\nSonar is a small util that scans you file-system and find GraphQL files (`.graphql`) and resolvers files (`.js`/`.ts`) and loads them (using `readFile` for GraphQL files and `require` for resolvers files).\n\n### Other Utils\n\nThere are some more utils under `utils` directory:\n\n#### `validateGraphQlDocuments`\n\nA tool for validating GraphQL documents (query/mutation/subscription/fragment) against the schema.\n\nIt uses the original validation logic from `graphql` package, but suspressing some validation rules, and focuses on validating the fields and the structure of the documents.\n\n#### `extractDocumentStringFromCodeFile`\n\nThis method gets a source code file, and using `graphql-tag-pluck` tries to extract GraphQL AST from it. \n\n#### `getDirectives`\n\nThis method accepts `GraphQLSchema` and any AST node, and tries to extract the GraphQL directives of the AST node. \n\nIt returnes a `Map` of the directive name and the arguments of it. \n\n#### `getFieldsWithDirectives`\n\nThis method accepts a GraphQL `DocumentNode` of a GraphQL types definition and creates a map between GraphQL `type.field` and the directives it has. \n\nIt's useful for getting an easy-to-use structure of the directives that are decorating the schema. \n\n#### `getImplementingTypes`\n\nThis method accepts `GraphQLSchema` object and a name of a GraphQL interface, and returns an array of all the GraphQL types that are implementing the GraphQL `interface`.\n\n#### `getSchemaDirectiveFromDirectiveResolver`\n\nThis method accepts a name of a GraphQL Directive and its resolver function; using this method you can easily generate `SchemaDirective` with a single resolver function.\n\n#### `composeResolvers`\n\nThis method accepts `IResolvers` object and mappings for composition functions that would be run before resolver itself.\n\nInstead of doing this,\n\n```js\nconst resolvers ={\n    Query: {\n        myQuery: (root, args, context) => {\n            // Make sure that the user is authenticated\n            if (!context.currentUser) {\n                throw new Error('You are not authenticated!');\n            }\n\n            // Make sure that the user has the correct roles\n            if (!context.currentUser.roles || context.currentUser.roles.includes('EDITOR')) {\n                throw new Error('You are not authorized!');\n            }\n\n            // Business logic\n            if (args.something === '1') {\n                return true;\n            }\n\n            return false;\n        },\n    },\n};\n```\n\nYou can do;\n\n```js\nconst resolvers ={\n    Query: {\n        myQuery: (root, args, context) => {\n            if (args.something === '1') {\n                return true;\n            }\n\n            return false;\n        },\n    },\n};\n\nconst isAuthenticated = () => next => async (root, args, context, info) => {\n    if (!context.currentUser) {\n        throw new Error('You are not authenticated!');\n    }\n\n    return next(root, args, context, info);\n};\n\nconst hasRole = (role: string) => next => async (root, args, context, info) => {\n    if (!context.currentUser.roles || context.currentUser.roles.includes(role)) {\n        throw new Error('You are not authorized!');\n    }\n\n    return next(root, args, context, info);\n};\n\nconst resolversComposition = {\n    'Query.myQuery': [isAuthenticated(), hasRole('EDITOR')],\n};\n\nconst composedResolvers = composeResolvers(resolvers, resolversComposition);\n```\n\n#### `extractResolversFromSchema`\n\nThis methods accepts `GraphQLSchema` object, and returns a map with field resolver functions of all types inside the schema as in [`IResolvers` interface of `graphql-tools`.](https://www.apollographql.com/docs/graphql-tools/resolvers.html)\n\n#### `extractFieldResolversFromObjectType`\n\nThis methods accepts `GraphQLObjectType` or `GraphQLInterfaceType` object, and returns a map with field resolvers of given type.\n","gitHead":"e05e2148d69eb95530ffba3b02e92d0d112ce673","license":"MIT","scripts":{"test":"jest --forceExit && yarn bundlesize","build":"tsc -m esnext --outDir dist/esnext && tsc -m commonjs --outDir dist/commonjs","clean":"rimraf dist","release":"yarn prepare-release && npm publish","prebuild":"yarn clean","bundlesize":"cd bundle-test/ && yarn && yarn test","prepare-release":"yarn build && yarn test","ci:release:canary":"node bump.js && npm publish --tag alpha"},"typings":"dist/esnext/index.d.ts","_npmUser":{"name":"dotansimha","email":"dotansimha@gmail.com"},"homepage":"https://github.com/dotansimha/graphql-toolkit#readme","repository":{"url":"git+ssh://git@github.com/dotansimha/graphql-toolkit.git","type":"git"},"typescript":{"definition":"dist/esnext/index.d.ts"},"_npmVersion":"6.10.2","description":"A set of utils for faster development of GraphQL tools","directories":{},"maintainers":[{"name":"dotansimha","email":"dotansimha@gmail.com"}],"sideEffects":false,"_nodeVersion":"12.9.1","dependencies":{"tslib":"^1.9.3","globby":"10.0.1","lodash":"4.17.15","asyncro":"^3.0.0","is-glob":"4.0.1","deepmerge":"4.0.0","valid-url":"1.0.9","@types/glob":"7.1.1","cross-fetch":"^3.0.4","is-valid-path":"0.1.1","graphql-import":"0.7.1","aggregate-error":"3.0.0","@kamilkisiela/graphql-tools":"4.0.6"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"jest":"24.9.0","rimraf":"3.0.0","semver":"6.3.0","graphql":"14.5.4","ts-jest":"24.0.2","jest-junit":"8.0.0","typescript":"3.6.2","@types/jest":"24.0.18","@types/node":"10.14.17","graphql-tag":"2.10.1","@types/lodash":"4.14.138","@types/graphql":"14.2.3","@types/is-glob":"4.0.1","@types/request":"2.48.2","@types/deepmerge":"2.2.0","@types/valid-url":"1.0.2","graphql-tag-pluck":"0.8.4","graphql-type-json":"0.3.0"},"peerDependencies":{"graphql":"^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0","graphql-tag-pluck":"^0.8.3"},"_npmOperationalInternal":{"tmp":"tmp/graphql-toolkit_0.5.12-e05e214.0_1567488198131_0.12091241814975917","host":"s3://npm-registry-packages"},"_id":"graphql-toolkit@0.5.12-e05e214.0","version":"0.5.12-e05e214.0"}