@envelop/core 2.5.0 → 2.5.1-alpha-20220824152235-afd061e6

package/esm/plugins/use-timing.js

@@ -1,134 +0,0 @@
-import { getOperationAST } from 'graphql';
-import { isIntrospectionOperationString, envelopIsIntrospectionSymbol } from '../utils.js';
-const HR_TO_NS = 1e9;
-const NS_TO_MS = 1e6;
-const DEFAULT_OPTIONS = {
-    onExecutionMeasurement: (args, timing) => console.log(`Operation execution "${args.operationName}" done in ${timing.ms}ms`),
-    onSubscriptionMeasurement: (args, timing) => console.log(`Operation subscription "${args.operationName}" done in ${timing.ms}ms`),
-    onParsingMeasurement: (source, timing) => console.log(`Parsing "${source}" done in ${timing.ms}ms`),
-    onValidationMeasurement: (document, timing) => { var _a, _b; return console.log(`Validation "${((_b = (_a = getOperationAST(document)) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.value) || '-'}" done in ${timing.ms}ms`); },
-    onResolverMeasurement: (info, timing) => console.log(`\tResolver of "${info.parentType.toString()}.${info.fieldName}" done in ${timing.ms}ms`),
-    onContextBuildingMeasurement: (timing) => console.log(`Context building done in ${timing.ms}ms`),
-};
-const deltaFrom = (hrtime) => {
-    const delta = process.hrtime(hrtime);
-    const ns = delta[0] * HR_TO_NS + delta[1];
-    return {
-        ns,
-        get ms() {
-            return ns / NS_TO_MS;
-        },
-    };
-};
-export const useTiming = (rawOptions) => {
-    const options = {
-        ...DEFAULT_OPTIONS,
-        ...rawOptions,
-    };
-    const result = {};
-    if (options.onContextBuildingMeasurement) {
-        result.onContextBuilding = ({ context }) => {
-            if (context[envelopIsIntrospectionSymbol]) {
-                return;
-            }
-            const contextStartTime = process.hrtime();
-            return () => {
-                options.onContextBuildingMeasurement(deltaFrom(contextStartTime));
-            };
-        };
-    }
-    if (options.onParsingMeasurement) {
-        result.onParse = ({ params, extendContext }) => {
-            if (options.skipIntrospection && isIntrospectionOperationString(params.source)) {
-                extendContext({
-                    [envelopIsIntrospectionSymbol]: true,
-                });
-                return;
-            }
-            const parseStartTime = process.hrtime();
-            return () => {
-                options.onParsingMeasurement(params.source, deltaFrom(parseStartTime));
-            };
-        };
-    }
-    if (options.onValidationMeasurement) {
-        result.onValidate = ({ params, context }) => {
-            if (context[envelopIsIntrospectionSymbol]) {
-                return;
-            }
-            const validateStartTime = process.hrtime();
-            return () => {
-                options.onValidationMeasurement(params.documentAST, deltaFrom(validateStartTime));
-            };
-        };
-    }
-    if (options.onExecutionMeasurement) {
-        if (options.onResolverMeasurement) {
-            result.onExecute = ({ args }) => {
-                if (args.contextValue[envelopIsIntrospectionSymbol]) {
-                    return;
-                }
-                const executeStartTime = process.hrtime();
-                return {
-                    onExecuteDone: () => {
-                        options.onExecutionMeasurement(args, deltaFrom(executeStartTime));
-                    },
-                };
-            };
-            result.onResolverCalled = ({ info }) => {
-                const resolverStartTime = process.hrtime();
-                return () => {
-                    options.onResolverMeasurement(info, deltaFrom(resolverStartTime));
-                };
-            };
-        }
-        else {
-            result.onExecute = ({ args }) => {
-                if (args.contextValue[envelopIsIntrospectionSymbol]) {
-                    return;
-                }
-                const executeStartTime = process.hrtime();
-                return {
-                    onExecuteDone: () => {
-                        options.onExecutionMeasurement(args, deltaFrom(executeStartTime));
-                    },
-                };
-            };
-        }
-    }
-    if (options.onSubscriptionMeasurement) {
-        if (options.onResolverMeasurement) {
-            result.onSubscribe = ({ args }) => {
-                if (args.contextValue[envelopIsIntrospectionSymbol]) {
-                    return;
-                }
-                const subscribeStartTime = process.hrtime();
-                return {
-                    onSubscribeResult: () => {
-                        options.onSubscriptionMeasurement && options.onSubscriptionMeasurement(args, deltaFrom(subscribeStartTime));
-                    },
-                };
-            };
-            result.onResolverCalled = ({ info }) => {
-                const resolverStartTime = process.hrtime();
-                return () => {
-                    options.onResolverMeasurement && options.onResolverMeasurement(info, deltaFrom(resolverStartTime));
-                };
-            };
-        }
-        else {
-            result.onSubscribe = ({ args }) => {
-                if (args.contextValue[envelopIsIntrospectionSymbol]) {
-                    return;
-                }
-                const subscribeStartTime = process.hrtime();
-                return {
-                    onSubscribeResult: () => {
-                        options.onSubscriptionMeasurement && options.onSubscriptionMeasurement(args, deltaFrom(subscribeStartTime));
-                    },
-                };
-            };
-        }
-    }
-    return result;
-};

package/esm/traced-orchestrator.js

@@ -1,132 +0,0 @@
-var _a;
-import { GraphQLSchema, } from 'graphql';
-import { isAsyncIterable } from './utils.js';
-const getTimestamp = typeof globalThis !== 'undefined' && ((_a = globalThis === null || globalThis === void 0 ? void 0 : globalThis.performance) === null || _a === void 0 ? void 0 : _a.now)
-    ? () => globalThis.performance.now()
-    : () => Date.now();
-const measure = () => {
-    const start = getTimestamp();
-    return () => {
-        const end = getTimestamp();
-        return end - start;
-    };
-};
-const tracingSymbol = Symbol('envelopTracing');
-export function traceOrchestrator(orchestrator) {
-    const createTracer = (name, ctx) => {
-        const end = measure();
-        return () => {
-            ctx[tracingSymbol][name] = end();
-        };
-    };
-    return {
-        ...orchestrator,
-        init: (ctx = {}) => {
-            ctx[tracingSymbol] = ctx[tracingSymbol] || {};
-            const done = createTracer('init', ctx || {});
-            try {
-                return orchestrator.init(ctx);
-            }
-            finally {
-                done();
-            }
-        },
-        parse: (ctx = {}) => {
-            ctx[tracingSymbol] = ctx[tracingSymbol] || {};
-            const actualFn = orchestrator.parse(ctx);
-            return (...args) => {
-                const done = createTracer('parse', ctx);
-                try {
-                    return actualFn(...args);
-                }
-                finally {
-                    done();
-                }
-            };
-        },
-        validate: (ctx = {}) => {
-            ctx[tracingSymbol] = ctx[tracingSymbol] || {};
-            const actualFn = orchestrator.validate(ctx);
-            return (...args) => {
-                const done = createTracer('validate', ctx);
-                try {
-                    return actualFn(...args);
-                }
-                finally {
-                    done();
-                }
-            };
-        },
-        execute: async (argsOrSchema, document, rootValue, contextValue, variableValues, operationName, fieldResolver, typeResolver) => {
-            const args = argsOrSchema instanceof GraphQLSchema
-                ? {
-                    schema: argsOrSchema,
-                    document: document,
-                    rootValue,
-                    contextValue,
-                    variableValues,
-                    operationName,
-                    fieldResolver,
-                    typeResolver,
-                }
-                : argsOrSchema;
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-ignore GraphQL.js types contextValue as unknown
-            const done = createTracer('execute', args.contextValue || {});
-            try {
-                const result = await orchestrator.execute(args);
-                done();
-                if (!isAsyncIterable(result)) {
-                    result.extensions = result.extensions || {};
-                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                    // @ts-ignore GraphQL.js types contextValue as unknown
-                    result.extensions.envelopTracing = args.contextValue[tracingSymbol];
-                }
-                else {
-                    // eslint-disable-next-line no-console
-                    console.warn(`"traceOrchestrator" encountered a AsyncIterator which is not supported yet, so tracing data is not available for the operation.`);
-                }
-                return result;
-            }
-            catch (e) {
-                done();
-                throw e;
-            }
-        },
-        subscribe: async (argsOrSchema, document, rootValue, contextValue, variableValues, operationName, fieldResolver, subscribeFieldResolver) => {
-            const args = argsOrSchema instanceof GraphQLSchema
-                ? {
-                    schema: argsOrSchema,
-                    document: document,
-                    rootValue,
-                    contextValue,
-                    variableValues,
-                    operationName,
-                    fieldResolver,
-                    subscribeFieldResolver,
-                }
-                : argsOrSchema;
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-ignore GraphQL.js types contextValue as unknown
-            const done = createTracer('subscribe', args.contextValue || {});
-            try {
-                return await orchestrator.subscribe(args);
-            }
-            finally {
-                done();
-            }
-        },
-        contextFactory: (ctx = {}) => {
-            const actualFn = orchestrator.contextFactory(ctx);
-            return async (childCtx) => {
-                const done = createTracer('contextFactory', ctx);
-                try {
-                    return await actualFn(childCtx);
-                }
-                finally {
-                    done();
-                }
-            };
-        },
-    };
-}

package/esm/traced-schema.js

@@ -1,64 +0,0 @@
-import { defaultFieldResolver, isIntrospectionType, isObjectType } from 'graphql';
-export const trackedSchemaSymbol = Symbol('TRACKED_SCHEMA');
-export const resolversHooksSymbol = Symbol('RESOLVERS_HOOKS');
-export function prepareTracedSchema(schema) {
-    if (!schema || schema[trackedSchemaSymbol]) {
-        return;
-    }
-    schema[trackedSchemaSymbol] = true;
-    const entries = Object.values(schema.getTypeMap());
-    for (const type of entries) {
-        if (!isIntrospectionType(type) && isObjectType(type)) {
-            const fields = Object.values(type.getFields());
-            for (const field of fields) {
-                let resolverFn = (field.resolve || defaultFieldResolver);
-                field.resolve = async (root, args, context, info) => {
-                    if (context && context[resolversHooksSymbol]) {
-                        const hooks = context[resolversHooksSymbol];
-                        const afterCalls = [];
-                        for (const hook of hooks) {
-                            const afterFn = await hook({
-                                root,
-                                args,
-                                context,
-                                info,
-                                resolverFn,
-                                replaceResolverFn: newFn => {
-                                    resolverFn = newFn;
-                                },
-                            });
-                            afterFn && afterCalls.push(afterFn);
-                        }
-                        try {
-                            let result = await resolverFn(root, args, context, info);
-                            for (const afterFn of afterCalls) {
-                                afterFn({
-                                    result,
-                                    setResult: newResult => {
-                                        result = newResult;
-                                    },
-                                });
-                            }
-                            return result;
-                        }
-                        catch (e) {
-                            let resultErr = e;
-                            for (const afterFn of afterCalls) {
-                                afterFn({
-                                    result: resultErr,
-                                    setResult: newResult => {
-                                        resultErr = newResult;
-                                    },
-                                });
-                            }
-                            throw resultErr;
-                        }
-                    }
-                    else {
-                        return resolverFn(root, args, context, info);
-                    }
-                };
-            }
-        }
-    }
-}

package/typings/plugins/use-immediate-introspection.d.cts

@@ -1,6 +0,0 @@
-import type { Plugin } from '@envelop/types';
-/**
- * In case a GraphQL operation only contains introspection fields the context building can be skipped completely.
- * With this plugin any further context extensions will be skipped.
- */
-export declare const useImmediateIntrospection: () => Plugin;

package/typings/plugins/use-immediate-introspection.d.ts

@@ -1,6 +0,0 @@
-import type { Plugin } from '@envelop/types';
-/**
- * In case a GraphQL operation only contains introspection fields the context building can be skipped completely.
- * With this plugin any further context extensions will be skipped.
- */
-export declare const useImmediateIntrospection: () => Plugin;

package/typings/plugins/use-masked-errors.d.cts

@@ -1,39 +0,0 @@
-import { Plugin } from '@envelop/types';
-import { GraphQLError, GraphQLErrorExtensions } from 'graphql';
-export declare const DEFAULT_ERROR_MESSAGE = "Unexpected error.";
-export declare class EnvelopError extends GraphQLError {
-    constructor(message: string, extensions?: GraphQLErrorExtensions);
-}
-export declare type FormatErrorHandler = (error: GraphQLError | unknown, message: string, isDev: boolean) => GraphQLError;
-export declare const formatError: FormatErrorHandler;
-export declare type UseMaskedErrorsOpts = {
-    /** The function used for format/identify errors. */
-    formatError?: FormatErrorHandler;
-    /** The error message that shall be used for masked errors. */
-    errorMessage?: string;
-    /**
-     * Additional information that is forwarded to the `formatError` function.
-     * The default value is `process.env['NODE_ENV'] === 'development'`
-     */
-    isDev?: boolean;
-    /**
-     * Whether parse errors should be processed by this plugin.
-     * In general it is not recommend to set this flag to `true`
-     * as a `parse` error contains useful information for debugging a GraphQL operation.
-     * A `parse` error never contains any sensitive information.
-     * @default false
-     */
-    handleParseErrors?: boolean;
-    /**
-     * Whether validation errors should processed by this plugin.
-     * In general we recommend against setting this flag to `true`
-     * as a `validate` error contains useful information for debugging a GraphQL operation.
-     * A `validate` error contains "did you mean x" suggestions that make it easier
-     * to reverse-introspect a GraphQL schema whose introspection capabilities got disabled.
-     * Instead of disabling introspection and masking validation errors, using persisted operations
-     * is a safer solution for avoiding the execution of unwanted/arbitrary operations.
-     * @default false
-     */
-    handleValidationErrors?: boolean;
-};
-export declare const useMaskedErrors: (opts?: UseMaskedErrorsOpts) => Plugin;

package/typings/plugins/use-masked-errors.d.ts

@@ -1,39 +0,0 @@
-import { Plugin } from '@envelop/types';
-import { GraphQLError, GraphQLErrorExtensions } from 'graphql';
-export declare const DEFAULT_ERROR_MESSAGE = "Unexpected error.";
-export declare class EnvelopError extends GraphQLError {
-    constructor(message: string, extensions?: GraphQLErrorExtensions);
-}
-export declare type FormatErrorHandler = (error: GraphQLError | unknown, message: string, isDev: boolean) => GraphQLError;
-export declare const formatError: FormatErrorHandler;
-export declare type UseMaskedErrorsOpts = {
-    /** The function used for format/identify errors. */
-    formatError?: FormatErrorHandler;
-    /** The error message that shall be used for masked errors. */
-    errorMessage?: string;
-    /**
-     * Additional information that is forwarded to the `formatError` function.
-     * The default value is `process.env['NODE_ENV'] === 'development'`
-     */
-    isDev?: boolean;
-    /**
-     * Whether parse errors should be processed by this plugin.
-     * In general it is not recommend to set this flag to `true`
-     * as a `parse` error contains useful information for debugging a GraphQL operation.
-     * A `parse` error never contains any sensitive information.
-     * @default false
-     */
-    handleParseErrors?: boolean;
-    /**
-     * Whether validation errors should processed by this plugin.
-     * In general we recommend against setting this flag to `true`
-     * as a `validate` error contains useful information for debugging a GraphQL operation.
-     * A `validate` error contains "did you mean x" suggestions that make it easier
-     * to reverse-introspect a GraphQL schema whose introspection capabilities got disabled.
-     * Instead of disabling introspection and masking validation errors, using persisted operations
-     * is a safer solution for avoiding the execution of unwanted/arbitrary operations.
-     * @default false
-     */
-    handleValidationErrors?: boolean;
-};
-export declare const useMaskedErrors: (opts?: UseMaskedErrorsOpts) => Plugin;

package/typings/plugins/use-timing.d.cts

@@ -1,21 +0,0 @@
-import { Plugin } from '@envelop/types';
-import { DocumentNode, ExecutionArgs, GraphQLResolveInfo, Source, SubscriptionArgs } from 'graphql';
-import { envelopIsIntrospectionSymbol } from '../utils.cjs';
-export declare type ResultTiming = {
-    ms: number;
-    ns: number;
-};
-export declare type TimingPluginOptions = {
-    skipIntrospection?: boolean;
-    onContextBuildingMeasurement?: (timing: ResultTiming) => void;
-    onExecutionMeasurement?: (args: ExecutionArgs, timing: ResultTiming) => void;
-    onSubscriptionMeasurement?: (args: SubscriptionArgs, timing: ResultTiming) => void;
-    onParsingMeasurement?: (source: Source | string, timing: ResultTiming) => void;
-    onValidationMeasurement?: (document: DocumentNode, timing: ResultTiming) => void;
-    onResolverMeasurement?: (info: GraphQLResolveInfo, timing: ResultTiming) => void;
-};
-declare type InternalPluginContext = {
-    [envelopIsIntrospectionSymbol]?: true;
-};
-export declare const useTiming: (rawOptions?: TimingPluginOptions) => Plugin<InternalPluginContext>;
-export {};

package/typings/plugins/use-timing.d.ts

@@ -1,21 +0,0 @@
-import { Plugin } from '@envelop/types';
-import { DocumentNode, ExecutionArgs, GraphQLResolveInfo, Source, SubscriptionArgs } from 'graphql';
-import { envelopIsIntrospectionSymbol } from '../utils.js';
-export declare type ResultTiming = {
-    ms: number;
-    ns: number;
-};
-export declare type TimingPluginOptions = {
-    skipIntrospection?: boolean;
-    onContextBuildingMeasurement?: (timing: ResultTiming) => void;
-    onExecutionMeasurement?: (args: ExecutionArgs, timing: ResultTiming) => void;
-    onSubscriptionMeasurement?: (args: SubscriptionArgs, timing: ResultTiming) => void;
-    onParsingMeasurement?: (source: Source | string, timing: ResultTiming) => void;
-    onValidationMeasurement?: (document: DocumentNode, timing: ResultTiming) => void;
-    onResolverMeasurement?: (info: GraphQLResolveInfo, timing: ResultTiming) => void;
-};
-declare type InternalPluginContext = {
-    [envelopIsIntrospectionSymbol]?: true;
-};
-export declare const useTiming: (rawOptions?: TimingPluginOptions) => Plugin<InternalPluginContext>;
-export {};

package/typings/traced-orchestrator.d.cts

@@ -1,7 +0,0 @@
-import { ArbitraryObject } from '@envelop/types';
-import { EnvelopOrchestrator } from './orchestrator.cjs';
-declare const tracingSymbol: unique symbol;
-export declare function traceOrchestrator<TInitialContext extends ArbitraryObject, TPluginsContext extends ArbitraryObject>(orchestrator: EnvelopOrchestrator<TInitialContext, TPluginsContext>): EnvelopOrchestrator<TInitialContext & {
-    [tracingSymbol]?: {};
-}, TPluginsContext>;
-export {};

package/typings/traced-orchestrator.d.ts

@@ -1,7 +0,0 @@
-import { ArbitraryObject } from '@envelop/types';
-import { EnvelopOrchestrator } from './orchestrator.js';
-declare const tracingSymbol: unique symbol;
-export declare function traceOrchestrator<TInitialContext extends ArbitraryObject, TPluginsContext extends ArbitraryObject>(orchestrator: EnvelopOrchestrator<TInitialContext, TPluginsContext>): EnvelopOrchestrator<TInitialContext & {
-    [tracingSymbol]?: {};
-}, TPluginsContext>;
-export {};

package/typings/traced-schema.d.cts

@@ -1,4 +0,0 @@
-import { GraphQLSchema } from 'graphql';
-export declare const trackedSchemaSymbol: unique symbol;
-export declare const resolversHooksSymbol: unique symbol;
-export declare function prepareTracedSchema(schema: GraphQLSchema | null | undefined): void;

package/typings/traced-schema.d.ts

@@ -1,4 +0,0 @@
-import { GraphQLSchema } from 'graphql';
-export declare const trackedSchemaSymbol: unique symbol;
-export declare const resolversHooksSymbol: unique symbol;
-export declare function prepareTracedSchema(schema: GraphQLSchema | null | undefined): void;