{cacheValue.data.echo}

a

a

b

) - }, new Error('GraphQL context missing.')) - - t.end() - }) - - await t.test('GraphQL context not a GraphQL instance', t => { - t.throws(() => { - ReactDOMServer.renderToString( - - - - ) - }, new Error('GraphQL context must be a GraphQL instance.')) - - t.end() - }) -}) diff --git a/src/universal/.babelrc.js b/src/universal/.babelrc.js deleted file mode 100644 index 6b07f07..0000000 --- a/src/universal/.babelrc.js +++ /dev/null @@ -1,21 +0,0 @@ -module.exports = { - comments: false, - presets: [ - { plugins: ['babel-plugin-transform-replace-object-assign'] }, - [ - '@babel/env', - { - targets: 'Node >= 8.10, > 0.5%, not OperaMini all, not dead', - modules: process.env.BABEL_ESM ? false : 'commonjs', - shippedProposals: true, - loose: true - } - ], - ['@babel/react', { useBuiltIns: true }] - ], - plugins: [ - ['@babel/proposal-object-rest-spread', { loose: true, useBuiltIns: true }], - ['@babel/proposal-class-properties', { loose: true }], - '@babel/transform-runtime' - ] -} diff --git a/src/universal/FirstRenderDateContext.mjs b/src/universal/FirstRenderDateContext.mjs deleted file mode 100644 index 3eb780d..0000000 --- a/src/universal/FirstRenderDateContext.mjs +++ /dev/null @@ -1,14 +0,0 @@ -import React from 'react' - -/** - * [React context object](https://reactjs.org/docs/context#api) for a `Date` - * instance indicating when the ancestor - * [`GraphQLProvider`]{@link GraphQLProvider} first rendered. - * @type {object} - * @prop {Function} Provider [React context provider component](https://reactjs.org/docs/context#contextprovider). - * @prop {Function} Consumer [React context consumer component](https://reactjs.org/docs/context#contextconsumer). - * @ignore - */ -export const FirstRenderDateContext = React.createContext() - -FirstRenderDateContext.displayName = 'FirstRenderDateContext' diff --git a/src/universal/GraphQL.mjs b/src/universal/GraphQL.mjs deleted file mode 100644 index b2a629b..0000000 --- a/src/universal/GraphQL.mjs +++ /dev/null @@ -1,244 +0,0 @@ -import mitt from 'mitt' -import { graphqlFetchOptions } from './graphqlFetchOptions' -import { hashObject } from './hashObject' - -/** - * A lightweight GraphQL client that caches queries and mutations. - * @kind class - * @name GraphQL - * @param {object} [options={}] Options. - * @param {GraphQLCache} [options.cache={}] Cache to import; usually from a server side render. - * @see [`reportCacheErrors`]{@link reportCacheErrors} to setup error reporting. - * @example Construct a GraphQL client. - * ```js - * import { GraphQL } from 'graphql-react' - * - * const graphql = new GraphQL() - * ``` - */ -export class GraphQL { - constructor({ cache = {} } = {}) { - const { on, off, emit } = mitt() - - /** - * Adds an event listener. - * @kind function - * @name GraphQL#on - * @param {string} type Event type. - * @param {Function} handler Event handler. - * @see [`reportCacheErrors`]{@link reportCacheErrors} can be used with this to setup error reporting. - */ - this.on = on - - /** - * Removes an event listener. - * @kind function - * @name GraphQL#off - * @param {string} type Event type. - * @param {Function} handler Event handler. - */ - this.off = off - - /** - * Emits an event with details to listeners. - * @param {string} type Event type. - * @param {*} [details] Event details. - * @ignore - */ - this.emit = emit - - /** - * Cache of loaded GraphQL operations. You probably don’t need to interact - * with this unless you’re implementing a server side rendering framework. - * @kind member - * @name GraphQL#cache - * @type {GraphQLCache} - * @example Export cache as JSON. - * ```js - * const exportedCache = JSON.stringify(graphql.cache) - * ``` - * @example Example cache JSON. - * ```json - * { - * "a1bCd2": { - * "data": { - * "viewer": { - * "name": "Jayden Seric" - * } - * } - * } - * } - * ``` - */ - this.cache = cache - - /** - * A map of loading GraphQL operations. You probably don’t need to interact - * with this unless you’re implementing a server side rendering framework. - * @kind member - * @name GraphQL#operations - * @type {object.>} - */ - this.operations = {} - } - - /** - * Signals that [GraphQL cache]{@link GraphQL#cache} subscribers such as the - * [`useGraphQL`]{@link useGraphQL} React hook should reload their GraphQL - * operation. Emits a [`GraphQL`]{@link GraphQL} instance `reload` event. - * @kind function - * @name GraphQL#reload - * @param {GraphQLCacheKey} [exceptCacheKey] A [GraphQL cache]{@link GraphQL#cache} [key]{@link GraphQLCacheKey} for cache to exempt from reloading. - * @example Reloading the [GraphQL cache]{@link GraphQL#cache}. - * ```js - * graphql.reload() - * ``` - */ - reload = exceptCacheKey => { - this.emit('reload', { exceptCacheKey }) - } - - /** - * Resets the [GraphQL cache]{@link GraphQL#cache}, useful when a user logs - * out. Emits a [`GraphQL`]{@link GraphQL} instance `reset` event. - * @kind function - * @name GraphQL#reset - * @param {GraphQLCacheKey} [exceptCacheKey] A [GraphQL cache]{@link GraphQL#cache} [key]{@link GraphQLCacheKey} for cache to exempt from deletion. Useful for resetting cache after a mutation, preserving the mutation cache. - * @example Resetting the [GraphQL cache]{@link GraphQL#cache}. - * ```js - * graphql.reset() - * ``` - */ - reset = exceptCacheKey => { - let cacheKeys = Object.keys(this.cache) - - if (exceptCacheKey) - cacheKeys = cacheKeys.filter(hash => hash !== exceptCacheKey) - - cacheKeys.forEach(cacheKey => delete this.cache[cacheKey]) - - // Emit cache updates after the entire cache has been updated, so logic in - // listeners can assume cache for all queries is fresh and stable. - this.emit('reset', { exceptCacheKey }) - } - - /** - * Fetches a GraphQL operation. - * @param {GraphQLFetchOptions} fetchOptions URL and options for [`fetch`](https://developer.mozilla.org/docs/Web/API/Fetch_API). - * @param {GraphQLCacheKey} cacheKey [GraphQL cache]{@link GraphQL#cache} [key]{@link GraphQLCacheKey}. - * @returns {Promise} A promise that resolves the [GraphQL cache]{@link GraphQL#cache} [value]{@link GraphQLCacheValue}. - * @ignore - */ - fetch = ({ url, ...options }, cacheKey) => { - let fetchResponse - - const fetcher = - typeof fetch === 'function' - ? fetch - : () => - Promise.reject( - new Error('Global fetch API or polyfill unavailable.') - ) - const cacheValue = {} - const cacheValuePromise = fetcher(url, options) - .then( - response => { - fetchResponse = response - - if (!response.ok) - cacheValue.httpError = { - status: response.status, - statusText: response.statusText - } - - return response.json().then( - ({ errors, data }) => { - // JSON parse ok. - if (!errors && !data) cacheValue.parseError = 'Malformed payload.' - if (errors) cacheValue.graphQLErrors = errors - if (data) cacheValue.data = data - }, - ({ message }) => { - // JSON parse error. - cacheValue.parseError = message - } - ) - }, - ({ message }) => { - cacheValue.fetchError = message - } - ) - .then(() => { - // Cache the operation. - this.cache[cacheKey] = cacheValue - - // Clear the loaded operation. - delete this.operations[cacheKey] - - this.emit('cache', { - cacheKey, - cacheValue, - - // May be undefined if there was a fetch error. - response: fetchResponse - }) - - return cacheValue - }) - - this.operations[cacheKey] = cacheValuePromise - - this.emit('fetch', { cacheKey, cacheValuePromise }) - - return cacheValuePromise - } - - /** - * Loads or reuses an already loading GraphQL operation in - * [GraphQL operations]{@link GraphQL#operations}. Emits a - * [`GraphQL`]{@link GraphQL} instance `fetch` event if an already loading - * operation isn’t reused, and a `cache` event once it’s loaded into the - * [GraphQL cache]{@link GraphQL#cache}. - * @kind function - * @name GraphQL#operate - * @param {object} options Options. - * @param {GraphQLOperation} options.operation GraphQL operation. - * @param {GraphQLFetchOptionsOverride} [options.fetchOptionsOverride] Overrides default GraphQL operation [`fetch` options]{@link GraphQLFetchOptions}. - * @param {boolean} [options.reloadOnLoad=false] Should a [GraphQL reload]{@link GraphQL#reload} happen after the operation loads, excluding the loaded operation cache. - * @param {boolean} [options.resetOnLoad=false] Should a [GraphQL reset]{@link GraphQL#reset} happen after the operation loads, excluding the loaded operation cache. - * @returns {GraphQLOperationLoading} Loading GraphQL operation details. - */ - operate = ({ - operation, - fetchOptionsOverride, - reloadOnLoad, - resetOnLoad - }) => { - if (reloadOnLoad && resetOnLoad) - throw new Error( - 'operate() options “reloadOnLoad” and “resetOnLoad” can’t both be true.' - ) - - const fetchOptions = graphqlFetchOptions(operation) - if (fetchOptionsOverride) fetchOptionsOverride(fetchOptions) - const cacheKey = hashObject(fetchOptions) - const cacheValuePromise = - // Use an identical existing request or… - this.operations[cacheKey] || - // …make a fresh request. - this.fetch(fetchOptions, cacheKey) - - // Potential edge-case issue: Multiple identical queries with resetOnLoad - // enabled will cause excessive resets. - cacheValuePromise.then(() => { - if (reloadOnLoad) this.reload(cacheKey) - else if (resetOnLoad) this.reset(cacheKey) - }) - - return { - cacheKey, - cacheValue: this.cache[cacheKey], - cacheValuePromise - } - } -} diff --git a/src/universal/GraphQLContext.mjs b/src/universal/GraphQLContext.mjs deleted file mode 100644 index ea770e2..0000000 --- a/src/universal/GraphQLContext.mjs +++ /dev/null @@ -1,26 +0,0 @@ -import React from 'react' - -/** - * [React context object](https://reactjs.org/docs/context#api) for a - * [`GraphQL`]{@link GraphQL} instance. - * @kind constant - * @name GraphQLContext - * @type {object} - * @prop {Function} Provider [React context provider component](https://reactjs.org/docs/context#contextprovider). - * @prop {Function} Consumer [React context consumer component](https://reactjs.org/docs/context#contextconsumer). - * @see [`GraphQLProvider`]{@link GraphQLProvider} is used to provide this context. - * @see [`useGraphQL`]{@link useGraphQL} React hook requires an ancestor [`GraphQLContext`]{@link GraphQLContext} `Provider` to work. - * @example A button component that resets the [GraphQL cache]{@link GraphQL#cache}. - * ```jsx - * import React from 'react' - * import { GraphQLContext } from 'graphql-react' - * - * const ResetCacheButton = () => { - * const graphql = React.useContext(GraphQLContext) - * return Reset cache - * } - * ``` - */ -export const GraphQLContext = React.createContext() - -GraphQLContext.displayName = 'GraphQLContext' diff --git a/src/universal/GraphQLProvider.mjs b/src/universal/GraphQLProvider.mjs deleted file mode 100644 index c1a299d..0000000 --- a/src/universal/GraphQLProvider.mjs +++ /dev/null @@ -1,44 +0,0 @@ -import PropTypes from 'prop-types' -import React from 'react' -import { FirstRenderDateContext } from './FirstRenderDateContext' -import { GraphQL } from './GraphQL' -import { GraphQLContext } from './GraphQLContext' - -/** - * A React component that provides a [`GraphQL`]{@link GraphQL} instance for an - * app. - * @kind function - * @name GraphQLProvider - * @param {object} props Component props. - * @param {GraphQL} props.graphql [`GraphQL`]{@link GraphQL} instance. - * @param {ReactNode} [props.children] React children. - * @returns {ReactNode} React virtual DOM node. - * @see [`GraphQLContext`]{@link GraphQLContext} is provided via this component. - * @see [`useGraphQL`]{@link useGraphQL} React hook requires this component to be an ancestor to work. - * @example Provide a [`GraphQL`]{@link GraphQL} instance for an app. - * ```jsx - * import { GraphQL, GraphQLProvider } from 'graphql-react' - * - * const graphql = new GraphQL() - * - * const App = ({ children }) => ( - * {children} - * ) - * ``` - */ -export const GraphQLProvider = ({ graphql, children }) => { - const firstRenderDateRef = React.useRef(new Date()) - - return ( - - - {children} - - - ) -} - -GraphQLProvider.propTypes = { - graphql: PropTypes.instanceOf(GraphQL).isRequired, - children: PropTypes.node -} diff --git a/src/universal/graphqlFetchOptions.mjs b/src/universal/graphqlFetchOptions.mjs deleted file mode 100644 index eab0cd5..0000000 --- a/src/universal/graphqlFetchOptions.mjs +++ /dev/null @@ -1,47 +0,0 @@ -import { extractFiles } from 'extract-files' - -/** - * Gets default [`fetch` options]{@link GraphQLFetchOptions} for a - * [GraphQL operation]{@link GraphQLOperation}. - * @param {GraphQLOperation} operation GraphQL operation. - * @returns {GraphQLFetchOptions} [`fetch`](https://developer.mozilla.org/docs/Web/API/Fetch_API) options. - * @ignore - */ -export function graphqlFetchOptions(operation) { - const fetchOptions = { - url: '/graphql', - method: 'POST', - headers: { Accept: 'application/json' } - } - - const { clone, files } = extractFiles(operation) - const operationJSON = JSON.stringify(clone) - - if (files.size) { - // See the GraphQL multipart request spec: - // https://github.com/jaydenseric/graphql-multipart-request-spec - - const form = new FormData() - - form.append('operations', operationJSON) - - const map = {} - let i = 0 - files.forEach(paths => { - map[++i] = paths - }) - form.append('map', JSON.stringify(map)) - - i = 0 - files.forEach((paths, file) => { - form.append(`${++i}`, file, file.name) - }) - - fetchOptions.body = form - } else { - fetchOptions.headers['Content-Type'] = 'application/json' - fetchOptions.body = operationJSON - } - - return fetchOptions -} diff --git a/src/universal/hashObject.mjs b/src/universal/hashObject.mjs deleted file mode 100644 index 8c7e80b..0000000 --- a/src/universal/hashObject.mjs +++ /dev/null @@ -1,59 +0,0 @@ -import fnv1a from 'fnv1a' - -/** - * `JSON.stringify()` replacer that converts - * [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData) instances - * into a signature string. - * @param {string} key Property name. - * @param {*} value Property value. - * @returns {*} Original value or replaced value if it was a `FormData` instance. - * @ignore - */ -function hashObjectReplacer(key, value) { - // Retrieve the original value, and not the possible .toJSON() version. When a - // value has a .toJSON() method, JSON.stringify provides the replacer - // function with output of that instead of the original value. FormData - // instances in browsers do not have a .toJSON() method, but some polyfill - // implementations might. - // See: https://github.com/octet-stream/form-data/issues/2 - const originalValue = this[key] - - if (typeof FormData !== 'undefined' && originalValue instanceof FormData) { - // Value is a FormData instance. The idea is to return a string representing - // the unique signature of the form, to be hashed with the surrounding JSON - // string. Note that FormData forms can have multiple fields with the same - // name and that the order of form fields also determines the signature. - - let signature = '' - - const fields = originalValue.entries() - - // Iterate manually using next() to avoid bulky for … of syntax - // transpilation. - let field = fields.next() - while (!field.done) { - const [name, value] = field.value - - // If the value is a File or Blob instance, it should cast to a string - // like `[object File]`. It would be good if there was a way to signature - // File or Blob instances. - signature += `${name}${value}` - - field = fields.next() - } - - return signature - } - - // Let JSON.stringify() stringify the value as normal. - return value -} - -/** - * Hashes an object. - * @param {object} object A JSON serializable object that may contain [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData) instances. - * @returns {string} A hash. - * @ignore - */ -export const hashObject = object => - fnv1a(JSON.stringify(object, hashObjectReplacer)).toString(36) diff --git a/src/universal/index.mjs b/src/universal/index.mjs deleted file mode 100644 index 8d54864..0000000 --- a/src/universal/index.mjs +++ /dev/null @@ -1,119 +0,0 @@ -export { GraphQL } from './GraphQL' -export { GraphQLContext } from './GraphQLContext' -export { GraphQLProvider } from './GraphQLProvider' -export { useGraphQL } from './useGraphQL' -export { reportCacheErrors } from './reportCacheErrors' - -/** - * A [GraphQL cache]{@link GraphQL#cache} map of GraphQL operation results. - * @kind typedef - * @name GraphQLCache - * @type {object.} - * @see [`GraphQL`]{@link GraphQL} constructor accepts this type in `options.cache`. - * @see [`GraphQL` instance property `cache`]{@link GraphQL#cache} is this type. - */ - -/** - * A [GraphQL cache]{@link GraphQLCache} key, derived from a hash of the - * [`fetch` options]{@link GraphQLFetchOptions} of the GraphQL operation that populated - * the [value]{@link GraphQLCacheValue}. - * @kind typedef - * @name GraphQLCacheKey - * @type {string} - */ - -/** - * JSON serializable GraphQL operation result that includes errors and data. - * @kind typedef - * @name GraphQLCacheValue - * @type {object} - * @prop {string} [fetchError] `fetch` error message. - * @prop {HttpError} [httpError] `fetch` response HTTP error. - * @prop {string} [parseError] Parse error message. - * @prop {Array