@webiny/api-graphql 0.0.0-unstable.0d717d18dd

package/graphql/abstractions.public.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const GraphQLSchemaFactory = createAbstraction("GraphQLSchemaFactory");
+export { GraphQLSchemaFactory };
+
+//# sourceMappingURL=abstractions.public.js.map

package/graphql/abstractions.public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql/abstractions.public.js","sources":["../../src/graphql/abstractions.public.ts"],"sourcesContent":["/**\n * This file contains abstraction for use by third party developers.\n */\nimport { createAbstraction } from \"@webiny/feature/api\";\nimport type {\n    Resolvers as IResolvers,\n    TypeDefs as ITypeDefs,\n    ResolverDecorators as IResolverDecorators\n} from \"~/types.js\";\nimport type { GraphQLSchemaBuilder } from \"~/features/GraphQLSchemaBuilder/abstractions.js\";\n\nexport interface IGraphQLSchema {\n    typeDefs?: ITypeDefs;\n    resolvers?: IResolvers<any>;\n    resolverDecorators?: IResolverDecorators;\n}\n\n/** Define custom GraphQL schema extensions. */\nexport interface IGraphQLSchemaFactory {\n    execute(builder: GraphQLSchemaBuilder.Interface): Promise<GraphQLSchemaBuilder.Interface>;\n}\n\n/** Define custom GraphQL schema extensions. */\nexport const GraphQLSchemaFactory =\n    createAbstraction<IGraphQLSchemaFactory>(\"GraphQLSchemaFactory\");\n\nexport namespace GraphQLSchemaFactory {\n    export type Interface = IGraphQLSchemaFactory;\n    export type SchemaBuilder = GraphQLSchemaBuilder.Interface;\n    export type Return = Promise<GraphQLSchemaBuilder.Interface>;\n}\n"],"names":["GraphQLSchemaFactory","createAbstraction"],"mappings":";AAuBO,MAAMA,uBACTC,kBAAyC"}

package/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./errors.js";
+export { registerLegacyPluginsViaGqlContextEnhancer } from "./registerLegacyPluginsViaGqlContextEnhancer.js";
+export * from "./responses.js";
+export * from "./utils/index.js";
+export * from "./plugins/index.js";
+export * from "./createRequestBody.js";
+export * from "./processRequestBody.js";
+export * from "./createResolverDecorator.js";
+export * from "./ResolverDecoration.js";
+export * from "./engine/index.js";
+export default _default;
+declare function _default(): never[];

package/index.js

@@ -0,0 +1,14 @@
+export * from "./errors.js";
+export * from "./responses.js";
+export * from "./utils/index.js";
+export * from "./plugins/index.js";
+export * from "./createRequestBody.js";
+export * from "./processRequestBody.js";
+export * from "./createResolverDecorator.js";
+export * from "./ResolverDecoration.js";
+export * from "./engine/index.js";
+const src = ()=>[];
+export { registerLegacyPluginsViaGqlContextEnhancer } from "./registerLegacyPluginsViaGqlContextEnhancer.js";
+export default src;
+
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"./errors.js\";\nexport { registerLegacyPluginsViaGqlContextEnhancer } from \"./registerLegacyPluginsViaGqlContextEnhancer.js\";\nexport * from \"./responses.js\";\nexport * from \"./utils/index.js\";\nexport * from \"./plugins/index.js\";\nexport * from \"./createRequestBody.js\";\nexport * from \"./processRequestBody.js\";\nexport * from \"./createResolverDecorator.js\";\nexport * from \"./ResolverDecoration.js\";\nexport * from \"./engine/index.js\";\n\n// Backward-compat stub — the Fastify GraphQL route was replaced by GraphQLRoute\n// registered via GraphQLEngineFeature. This default export is a no-op.\nexport default () => [];\n"],"names":[],"mappings":";;;;;;;;;AAaA,YAAgB,IAAK,EAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@webiny/api-graphql",
+	"version": "0.0.0-unstable.0d717d18dd",
+	"type": "module",
+	"exports": {
+		".": "./index.js",
+		"./*": "./*"
+	},
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"description": "The Server as a function.",
+	"contributors": [
+		"Pavel Denisjuk <pavel@webiny.com>",
+		"Sven Al Hamad <sven@webiny.com>",
+		"Adrian Smijulj <adrian@webiny.com>"
+	],
+	"dependencies": {
+		"@graphql-tools/merge": "9.2.2",
+		"@graphql-tools/resolvers-composition": "7.0.35",
+		"@graphql-tools/schema": "10.0.38",
+		"@graphql-tools/utils": "11.2.2",
+		"@webiny/api": "0.0.0-unstable.0d717d18dd",
+		"@webiny/di": "1.0.2",
+		"@webiny/error": "0.0.0-unstable.0d717d18dd",
+		"@webiny/event-handler-core": "0.0.0-unstable.0d717d18dd",
+		"@webiny/feature": "0.0.0-unstable.0d717d18dd",
+		"@webiny/handler": "0.0.0-unstable.0d717d18dd",
+		"@webiny/plugins": "0.0.0-unstable.0d717d18dd",
+		"@webiny/utils": "0.0.0-unstable.0d717d18dd",
+		"graphql": "16.14.2",
+		"graphql-scalars": "1.25.0",
+		"zod": "4.4.3"
+	},
+	"devDependencies": {
+		"@webiny/build-tools": "0.0.0-unstable.0d717d18dd",
+		"rimraf": "6.1.3",
+		"typescript": "7.0.2",
+		"vitest": "4.1.10"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"gitHead": "b8aec8a1be3f25c3b428b357fe1e352c7cbff9ae",
+	"webiny": {
+		"publishFrom": "dist"
+	}
+}

package/plugins/GraphQLSchemaPlugin.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "@webiny/api/types.js";
+import { Plugin } from "@webiny/plugins";
+import type { GraphQLSchemaDefinition, ResolverDecorators, Resolvers, TypeDefs } from "../types.js";
+export interface IGraphQLSchemaPlugin<TContext = Context> extends Plugin {
+    schema: GraphQLSchemaDefinition<TContext>;
+    isApplicable: (context: TContext) => boolean;
+}
+export interface GraphQLSchemaPluginConfig<TContext> {
+    typeDefs?: TypeDefs;
+    resolvers?: Resolvers<TContext>;
+    resolverDecorators?: ResolverDecorators;
+    isApplicable?: (context: TContext) => boolean;
+}
+export declare class GraphQLSchemaPlugin<TContext = Context> extends Plugin implements IGraphQLSchemaPlugin<TContext> {
+    static readonly type: string;
+    protected config: GraphQLSchemaPluginConfig<TContext>;
+    constructor(config: GraphQLSchemaPluginConfig<TContext>);
+    get schema(): GraphQLSchemaDefinition<TContext>;
+    isApplicable(context: TContext): boolean;
+}
+export declare const createGraphQLSchemaPlugin: <T = Context>(config: GraphQLSchemaPluginConfig<T>) => GraphQLSchemaPlugin<T>;

package/plugins/GraphQLSchemaPlugin.js

@@ -0,0 +1,25 @@
+import { Plugin } from "@webiny/plugins";
+class GraphQLSchemaPlugin extends Plugin {
+    static{
+        this.type = "graphql-schema";
+    }
+    constructor(config){
+        super();
+        this.config = config;
+    }
+    get schema() {
+        return {
+            typeDefs: this.config.typeDefs || "",
+            resolvers: this.config.resolvers,
+            resolverDecorators: this.config.resolverDecorators
+        };
+    }
+    isApplicable(context) {
+        if (this.config.isApplicable) return this.config.isApplicable(context);
+        return true;
+    }
+}
+const createGraphQLSchemaPlugin = (config)=>new GraphQLSchemaPlugin(config);
+export { GraphQLSchemaPlugin, createGraphQLSchemaPlugin };
+
+//# sourceMappingURL=GraphQLSchemaPlugin.js.map

package/plugins/GraphQLSchemaPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins/GraphQLSchemaPlugin.js","sources":["../../src/plugins/GraphQLSchemaPlugin.ts"],"sourcesContent":["import type { Context } from \"@webiny/api/types.js\";\nimport { Plugin } from \"@webiny/plugins\";\nimport type { GraphQLSchemaDefinition, ResolverDecorators, Resolvers, TypeDefs } from \"~/types.js\";\n\nexport interface IGraphQLSchemaPlugin<TContext = Context> extends Plugin {\n    schema: GraphQLSchemaDefinition<TContext>;\n    isApplicable: (context: TContext) => boolean;\n}\n\nexport interface GraphQLSchemaPluginConfig<TContext> {\n    typeDefs?: TypeDefs;\n    resolvers?: Resolvers<TContext>;\n    resolverDecorators?: ResolverDecorators;\n    isApplicable?: (context: TContext) => boolean;\n}\n\nexport class GraphQLSchemaPlugin<TContext = Context>\n    extends Plugin\n    implements IGraphQLSchemaPlugin<TContext>\n{\n    public static override readonly type: string = \"graphql-schema\";\n    protected config: GraphQLSchemaPluginConfig<TContext>;\n\n    constructor(config: GraphQLSchemaPluginConfig<TContext>) {\n        super();\n        this.config = config;\n    }\n\n    get schema(): GraphQLSchemaDefinition<TContext> {\n        return {\n            typeDefs: this.config.typeDefs || \"\",\n            resolvers: this.config.resolvers,\n            resolverDecorators: this.config.resolverDecorators\n        };\n    }\n\n    isApplicable(context: TContext): boolean {\n        if (this.config.isApplicable) {\n            return this.config.isApplicable(context);\n        }\n        return true;\n    }\n}\n\nexport const createGraphQLSchemaPlugin = <T = Context>(config: GraphQLSchemaPluginConfig<T>) => {\n    return new GraphQLSchemaPlugin<T>(config);\n};\n"],"names":["GraphQLSchemaPlugin","Plugin","config","context","createGraphQLSchemaPlugin"],"mappings":";AAgBO,MAAMA,4BACDC;;aAGwB,IAAI,GAAW;;IAG/C,YAAYC,MAA2C,CAAE;QACrD,KAAK;QACL,IAAI,CAAC,MAAM,GAAGA;IAClB;IAEA,IAAI,SAA4C;QAC5C,OAAO;YACH,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI;YAClC,WAAW,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,oBAAoB,IAAI,CAAC,MAAM,CAAC,kBAAkB;QACtD;IACJ;IAEA,aAAaC,OAAiB,EAAW;QACrC,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EACxB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAACA;QAEpC,OAAO;IACX;AACJ;AAEO,MAAMC,4BAA4B,CAAcF,SAC5C,IAAIF,oBAAuBE"}

package/plugins/index.d.ts

@@ -0,0 +1 @@
+export * from "./GraphQLSchemaPlugin.js";

package/plugins/index.js

@@ -0,0 +1 @@
+export * from "./GraphQLSchemaPlugin.js";

package/processRequestBody.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionResult, GraphQLSchema } from "graphql";
+import type { GraphQLRequestBody } from "./types.js";
+import type { Context } from "@webiny/api/types.js";
+export declare const processRequestBody: <TData = Record<string, any>, TExtensions = Record<string, any>>(requestBody: GraphQLRequestBody | GraphQLRequestBody[], schema: GraphQLSchema, context: Context) => Promise<ExecutionResult<TData, TExtensions>[] | ExecutionResult<TData, TExtensions>>;

package/processRequestBody.js

@@ -0,0 +1,26 @@
+import { graphql } from "graphql";
+const executeGraphQl = async (body, schema, context)=>{
+    const { query, variables, operationName } = body;
+    return graphql({
+        schema,
+        source: query,
+        rootValue: {},
+        contextValue: context,
+        variableValues: variables,
+        operationName
+    });
+};
+const processRequestBody = async (requestBody, schema, context)=>{
+    if (Array.isArray(requestBody)) {
+        const results = [];
+        for (const body of requestBody){
+            const result = await executeGraphQl(body, schema, context);
+            results.push(result);
+        }
+        return results;
+    }
+    return await executeGraphQl(requestBody, schema, context);
+};
+export { processRequestBody };
+
+//# sourceMappingURL=processRequestBody.js.map

package/processRequestBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestBody.js","sources":["../src/processRequestBody.ts"],"sourcesContent":["import type { ExecutionResult, GraphQLSchema } from \"graphql\";\nimport { graphql } from \"graphql\";\nimport type { GraphQLRequestBody } from \"~/types.js\";\nimport type { Context } from \"@webiny/api/types.js\";\n\nconst executeGraphQl = async <TData = Record<string, any>, TExtensions = Record<string, any>>(\n    body: GraphQLRequestBody,\n    schema: GraphQLSchema,\n    context: Context\n): Promise<ExecutionResult<TData, TExtensions>> => {\n    const { query, variables, operationName } = body;\n    return graphql({\n        schema,\n        source: query,\n        rootValue: {},\n        contextValue: context,\n        variableValues: variables,\n        operationName\n    }) as Promise<ExecutionResult<TData, TExtensions>>;\n};\n\nexport const processRequestBody = async <\n    TData = Record<string, any>,\n    TExtensions = Record<string, any>\n>(\n    requestBody: GraphQLRequestBody | GraphQLRequestBody[],\n    schema: GraphQLSchema,\n    context: Context\n): Promise<ExecutionResult<TData, TExtensions>[] | ExecutionResult<TData, TExtensions>> => {\n    if (Array.isArray(requestBody)) {\n        const results: ExecutionResult<TData, TExtensions>[] = [];\n        for (const body of requestBody) {\n            const result = await executeGraphQl<TData, TExtensions>(body, schema, context);\n            results.push(result);\n        }\n        return results;\n    }\n    return await executeGraphQl<TData, TExtensions>(requestBody, schema, context);\n};\n"],"names":["executeGraphQl","body","schema","context","query","variables","operationName","graphql","processRequestBody","requestBody","Array","results","result"],"mappings":";AAKA,MAAMA,iBAAiB,OACnBC,MACAC,QACAC;IAEA,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAEC,aAAa,EAAE,GAAGL;IAC5C,OAAOM,QAAQ;QACXL;QACA,QAAQE;QACR,WAAW,CAAC;QACZ,cAAcD;QACd,gBAAgBE;QAChBC;IACJ;AACJ;AAEO,MAAME,qBAAqB,OAI9BC,aACAP,QACAC;IAEA,IAAIO,MAAM,OAAO,CAACD,cAAc;QAC5B,MAAME,UAAiD,EAAE;QACzD,KAAK,MAAMV,QAAQQ,YAAa;YAC5B,MAAMG,SAAS,MAAMZ,eAAmCC,MAAMC,QAAQC;YACtEQ,QAAQ,IAAI,CAACC;QACjB;QACA,OAAOD;IACX;IACA,OAAO,MAAMX,eAAmCS,aAAaP,QAAQC;AACzE"}

package/registerLegacyPluginsViaGqlContextEnhancer.d.ts

@@ -0,0 +1,12 @@
+import type { Container } from "@webiny/di";
+/**
+ * Escape hatch for legacy plugin-based code that hasn't been migrated to createFeature() yet.
+ *
+ * Accepts any plugin array (same shape as the old createHandler({ plugins: [...] })) and
+ * applies them via a GraphQLContextEnhancer so they still receive the context object.
+ *
+ * Usage in createLambdaHandler request callback:
+ *   registerLegacyPluginsViaGqlContextEnhancer(container, extensions());
+ *   registerLegacyPluginsViaGqlContextEnhancer(container, [myPlugin(), anotherPlugin()]);
+ */
+export declare function registerLegacyPluginsViaGqlContextEnhancer(container: Container, plugins: any | any[]): void;

package/registerLegacyPluginsViaGqlContextEnhancer.js

@@ -0,0 +1,21 @@
+import { PluginsContainer } from "@webiny/plugins";
+import { GraphQLContextEnhancer } from "./engine/index.js";
+function registerLegacyPluginsViaGqlContextEnhancer(container, plugins) {
+    const flat = [
+        plugins
+    ].flat(1 / 0).filter(Boolean);
+    let initialized = false;
+    const enhancer = {
+        async enhance (ctx) {
+            if (initialized) return;
+            initialized = true;
+            if (!ctx.plugins) ctx.plugins = new PluginsContainer([]);
+            for (const plugin of flat)if ("function" == typeof plugin.apply) await plugin.apply(ctx);
+            else if (ctx.plugins) ctx.plugins.register(plugin);
+        }
+    };
+    container.registerInstance(GraphQLContextEnhancer, enhancer);
+}
+export { registerLegacyPluginsViaGqlContextEnhancer };
+
+//# sourceMappingURL=registerLegacyPluginsViaGqlContextEnhancer.js.map

package/registerLegacyPluginsViaGqlContextEnhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerLegacyPluginsViaGqlContextEnhancer.js","sources":["../src/registerLegacyPluginsViaGqlContextEnhancer.ts"],"sourcesContent":["import type { Container } from \"@webiny/di\";\nimport { PluginsContainer } from \"@webiny/plugins\";\nimport { GraphQLContextEnhancer } from \"./engine/index.js\";\nimport type { IGraphQLContextEnhancer } from \"./engine/index.js\";\n\n/**\n * Escape hatch for legacy plugin-based code that hasn't been migrated to createFeature() yet.\n *\n * Accepts any plugin array (same shape as the old createHandler({ plugins: [...] })) and\n * applies them via a GraphQLContextEnhancer so they still receive the context object.\n *\n * Usage in createLambdaHandler request callback:\n *   registerLegacyPluginsViaGqlContextEnhancer(container, extensions());\n *   registerLegacyPluginsViaGqlContextEnhancer(container, [myPlugin(), anotherPlugin()]);\n */\nexport function registerLegacyPluginsViaGqlContextEnhancer(\n    container: Container,\n    plugins: any | any[]\n): void {\n    const flat = [plugins].flat(Infinity as 1).filter(Boolean);\n    let initialized = false;\n\n    const enhancer: IGraphQLContextEnhancer = {\n        async enhance(ctx: Record<string, any>): Promise<void> {\n            if (initialized) {\n                return;\n            }\n            initialized = true;\n\n            // Legacy plugins assume ctx.plugins exists (they call ctx.plugins.register() directly).\n            // Mirror the contract of the old createHandler which always initialised PluginsContainer.\n            if (!ctx.plugins) {\n                ctx.plugins = new PluginsContainer([]);\n            }\n\n            for (const plugin of flat) {\n                if (typeof plugin.apply === \"function\") {\n                    await plugin.apply(ctx);\n                } else if (ctx.plugins) {\n                    ctx.plugins.register(plugin);\n                }\n            }\n        }\n    };\n\n    container.registerInstance(GraphQLContextEnhancer, enhancer);\n}\n"],"names":["registerLegacyPluginsViaGqlContextEnhancer","container","plugins","flat","Infinity","Boolean","initialized","enhancer","ctx","PluginsContainer","plugin","GraphQLContextEnhancer"],"mappings":";;AAeO,SAASA,2CACZC,SAAoB,EACpBC,OAAoB;IAEpB,MAAMC,OAAO;QAACD;KAAQ,CAAC,IAAI,CAACE,OAAe,MAAM,CAACC;IAClD,IAAIC,cAAc;IAElB,MAAMC,WAAoC;QACtC,MAAM,SAAQC,GAAwB;YAClC,IAAIF,aACA;YAEJA,cAAc;YAId,IAAI,CAACE,IAAI,OAAO,EACZA,IAAI,OAAO,GAAG,IAAIC,iBAAiB,EAAE;YAGzC,KAAK,MAAMC,UAAUP,KACjB,IAAI,AAAwB,cAAxB,OAAOO,OAAO,KAAK,EACnB,MAAMA,OAAO,KAAK,CAACF;iBAChB,IAAIA,IAAI,OAAO,EAClBA,IAAI,OAAO,CAAC,QAAQ,CAACE;QAGjC;IACJ;IAEAT,UAAU,gBAAgB,CAACU,wBAAwBJ;AACvD"}

package/responses.d.ts

@@ -0,0 +1,51 @@
+export interface IMeta {
+    hasMoreItems: boolean;
+    totalCount: number;
+    cursor?: string | null;
+}
+export interface ErrorResponseParams {
+    message: string;
+    code?: string;
+    data?: any;
+    stack?: string | null;
+}
+/** GraphQL error response helper. */
+export declare class ErrorResponse {
+    readonly data: null;
+    readonly error: {
+        code: string;
+        message: string;
+        data: any;
+        stack: string | null;
+    };
+    constructor(params: ErrorResponseParams);
+}
+/** GraphQL not-found response helper. */
+export declare class NotFoundResponse extends ErrorResponse {
+    constructor(message: string);
+}
+/** GraphQL list error response helper. */
+export declare class ListErrorResponse {
+    readonly data: null;
+    readonly meta: null;
+    readonly error: {
+        code: string;
+        message: string;
+        data: any;
+        stack: string | null;
+    };
+    constructor(params: ErrorResponseParams);
+}
+/** GraphQL response helper. */
+export declare class Response<T = any> {
+    readonly data: T;
+    readonly error: null;
+    constructor(data: T);
+}
+/** GraphQL list response helper. */
+export declare class ListResponse<T, M = IMeta> {
+    readonly data: Array<T>;
+    readonly meta: M;
+    readonly error: null;
+    constructor(data: Array<T>, meta?: M);
+}

package/responses.js

@@ -0,0 +1,59 @@
+const defaultParams = {
+    code: "",
+    message: "",
+    data: null,
+    stack: null
+};
+class ErrorResponse {
+    constructor(params){
+        this.data = null;
+        const debug = "true" === process.env.DEBUG;
+        let stack = defaultParams.stack;
+        if (debug && params.stack) stack = params.stack;
+        this.error = {
+            code: params.code || defaultParams.code,
+            message: params.message || defaultParams.message,
+            data: params.data || defaultParams.data,
+            stack: stack
+        };
+    }
+}
+class NotFoundResponse extends ErrorResponse {
+    constructor(message){
+        super({
+            code: "NOT_FOUND",
+            message
+        });
+    }
+}
+class ListErrorResponse {
+    constructor(params){
+        this.meta = null;
+        this.data = null;
+        const debug = "true" === process.env.DEBUG;
+        let stack = defaultParams.stack;
+        if (debug && params.stack) stack = params.stack;
+        this.error = {
+            code: params.code || defaultParams.code,
+            message: params.message || defaultParams.message,
+            data: params.data || defaultParams.data,
+            stack: stack
+        };
+    }
+}
+class Response {
+    constructor(data){
+        this.data = data;
+        this.error = null;
+    }
+}
+class ListResponse {
+    constructor(data, meta){
+        this.data = Array.isArray(data) ? data : [];
+        this.meta = meta || {};
+        this.error = null;
+    }
+}
+export { ErrorResponse, ListErrorResponse, ListResponse, NotFoundResponse, Response };
+
+//# sourceMappingURL=responses.js.map

package/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sources":["../src/responses.ts"],"sourcesContent":["export interface IMeta {\n    hasMoreItems: boolean;\n    totalCount: number;\n    cursor?: string | null;\n}\n\nexport interface ErrorResponseParams {\n    message: string;\n    code?: string;\n    data?: any;\n    stack?: string | null;\n}\n\nconst defaultParams: Required<ErrorResponseParams> = {\n    code: \"\",\n    message: \"\",\n    data: null,\n    stack: null\n};\n\n/** GraphQL error response helper. */\nexport class ErrorResponse {\n    public readonly data: null;\n    public readonly error: {\n        code: string;\n        message: string;\n        data: any;\n        stack: string | null;\n    };\n\n    constructor(params: ErrorResponseParams) {\n        this.data = null;\n\n        const debug = process.env.DEBUG === \"true\";\n\n        // Ensure `stack` is either `string` or `null`.\n        let stack = defaultParams.stack;\n        if (debug && params.stack) {\n            stack = params.stack;\n        }\n\n        this.error = {\n            code: params.code || defaultParams.code,\n            message: params.message || defaultParams.message,\n            data: params.data || defaultParams.data,\n            stack: stack\n        };\n    }\n}\n\n/** GraphQL not-found response helper. */\nexport class NotFoundResponse extends ErrorResponse {\n    constructor(message: string) {\n        super({\n            code: \"NOT_FOUND\",\n            message\n        });\n    }\n}\n\n/** GraphQL list error response helper. */\nexport class ListErrorResponse {\n    public readonly data: null;\n    public readonly meta: null;\n    public readonly error: {\n        code: string;\n        message: string;\n        data: any;\n        stack: string | null;\n    };\n\n    constructor(params: ErrorResponseParams) {\n        this.meta = null;\n        this.data = null;\n\n        const debug = process.env.DEBUG === \"true\";\n\n        // Ensure `stack` is either `string` or `null`.\n        let stack = defaultParams.stack;\n        if (debug && params.stack) {\n            stack = params.stack;\n        }\n\n        this.error = {\n            code: params.code || defaultParams.code,\n            message: params.message || defaultParams.message,\n            data: params.data || defaultParams.data,\n            stack: stack\n        };\n    }\n}\n\n/** GraphQL response helper. */\nexport class Response<T = any> {\n    public readonly data: T;\n    public readonly error: null;\n\n    constructor(data: T) {\n        this.data = data;\n        this.error = null;\n    }\n}\n\n/** GraphQL list response helper. */\nexport class ListResponse<T, M = IMeta> {\n    public readonly data: Array<T>;\n    public readonly meta: M;\n    public readonly error: null;\n\n    constructor(data: Array<T>, meta?: M) {\n        this.data = Array.isArray(data) ? data : [];\n        this.meta = meta || ({} as M);\n        this.error = null;\n    }\n}\n"],"names":["defaultParams","ErrorResponse","params","debug","process","stack","NotFoundResponse","message","ListErrorResponse","Response","data","ListResponse","meta","Array"],"mappings":"AAaA,MAAMA,gBAA+C;IACjD,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;AACX;AAGO,MAAMC;IAST,YAAYC,MAA2B,CAAE;QACrC,IAAI,CAAC,IAAI,GAAG;QAEZ,MAAMC,QAAQC,AAAsB,WAAtBA,QAAQ,GAAG,CAAC,KAAK;QAG/B,IAAIC,QAAQL,cAAc,KAAK;QAC/B,IAAIG,SAASD,OAAO,KAAK,EACrBG,QAAQH,OAAO,KAAK;QAGxB,IAAI,CAAC,KAAK,GAAG;YACT,MAAMA,OAAO,IAAI,IAAIF,cAAc,IAAI;YACvC,SAASE,OAAO,OAAO,IAAIF,cAAc,OAAO;YAChD,MAAME,OAAO,IAAI,IAAIF,cAAc,IAAI;YACvC,OAAOK;QACX;IACJ;AACJ;AAGO,MAAMC,yBAAyBL;IAClC,YAAYM,OAAe,CAAE;QACzB,KAAK,CAAC;YACF,MAAM;YACNA;QACJ;IACJ;AACJ;AAGO,MAAMC;IAUT,YAAYN,MAA2B,CAAE;QACrC,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,IAAI,GAAG;QAEZ,MAAMC,QAAQC,AAAsB,WAAtBA,QAAQ,GAAG,CAAC,KAAK;QAG/B,IAAIC,QAAQL,cAAc,KAAK;QAC/B,IAAIG,SAASD,OAAO,KAAK,EACrBG,QAAQH,OAAO,KAAK;QAGxB,IAAI,CAAC,KAAK,GAAG;YACT,MAAMA,OAAO,IAAI,IAAIF,cAAc,IAAI;YACvC,SAASE,OAAO,OAAO,IAAIF,cAAc,OAAO;YAChD,MAAME,OAAO,IAAI,IAAIF,cAAc,IAAI;YACvC,OAAOK;QACX;IACJ;AACJ;AAGO,MAAMI;IAIT,YAAYC,IAAO,CAAE;QACjB,IAAI,CAAC,IAAI,GAAGA;QACZ,IAAI,CAAC,KAAK,GAAG;IACjB;AACJ;AAGO,MAAMC;IAKT,YAAYD,IAAc,EAAEE,IAAQ,CAAE;QAClC,IAAI,CAAC,IAAI,GAAGC,MAAM,OAAO,CAACH,QAAQA,OAAO,EAAE;QAC3C,IAAI,CAAC,IAAI,GAAGE,QAAS,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG;IACjB;AACJ"}

package/types.d.ts

@@ -0,0 +1,50 @@
+import type { GraphQLScalarType, GraphQLFieldResolver as BaseGraphQLFieldResolver, GraphQLSchema } from "graphql";
+import type { Plugin } from "@webiny/plugins/types.js";
+import type { Context, GenericRecord } from "@webiny/api/types.js";
+import type { ResolversComposition } from "@graphql-tools/resolvers-composition";
+import type { IResolvers, TypeSource } from "@graphql-tools/utils";
+export interface GraphQLScalarPlugin extends Plugin {
+    type: "graphql-scalar";
+    scalar: GraphQLScalarType;
+}
+export type GraphQLFieldResolver<TSource = any, TArgs = any, TContext = Context> = BaseGraphQLFieldResolver<TSource, TContext, TArgs>;
+export type TypeDefs = TypeSource;
+export interface GraphQLSchemaPluginTypeArgs {
+    context?: any;
+    args?: any;
+    source?: any;
+}
+export type Resolvers<TContext> = IResolvers<any, TContext>;
+export type ResolverDecorator<TSource = any, TContext = any, TArgs = any> = ResolversComposition<GraphQLFieldResolver<TSource, TContext, TArgs>>;
+export type ResolverDecorators = GenericRecord<string, ResolverDecorator[]>;
+export interface GraphQLSchemaDefinition<TContext = any> {
+    typeDefs: TypeDefs;
+    resolvers?: Resolvers<TContext>;
+    resolverDecorators?: ResolverDecorators;
+}
+export interface GraphQLSchemaPlugin<TContext extends Context = Context> extends Plugin {
+    type: "graphql-schema";
+    schema: GraphQLSchemaDefinition<TContext>;
+}
+export interface GraphQLRequestBody {
+    query: string;
+    variables?: Record<string, any> | null;
+    operationName?: string;
+}
+export interface GraphQLBeforeQueryPlugin<TContext extends Context = Context> extends Plugin {
+    type: "graphql-before-query";
+    apply(params: {
+        body: GraphQLRequestBody;
+        schema: GraphQLSchema;
+        context: TContext;
+    }): void;
+}
+export interface GraphQLAfterQueryPlugin<TContext extends Context = Context> extends Plugin {
+    type: "graphql-after-query";
+    apply(params: {
+        result: any;
+        body: GraphQLRequestBody;
+        schema: GraphQLSchema;
+        context: TContext;
+    }): void;
+}

package/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./resolve.js";

package/utils/index.js

@@ -0,0 +1 @@
+export * from "./resolve.js";

package/utils/resolve.d.ts

@@ -0,0 +1,21 @@
+import { ErrorResponse, ListErrorResponse, ListResponse, Response } from "../responses.js";
+import type { GenericRecord } from "@webiny/api/types.js";
+export interface Meta {
+    totalCount: number;
+    hasMoreItems: boolean;
+    cursor: string | null;
+}
+export declare const emptyResolver: () => {};
+interface ResolveCallable<T = GenericRecord> {
+    (): Promise<T>;
+}
+export declare const resolve: <T = GenericRecord>(fn: ResolveCallable<T>) => Promise<ErrorResponse | Response<Awaited<T>>>;
+interface ResolveListCallable<T> {
+    (): Promise<IListResult<T>>;
+}
+interface IListResult<T = GenericRecord> {
+    items: T[];
+    meta: Meta;
+}
+export declare const resolveList: <T = GenericRecord>(fn: ResolveListCallable<T>) => Promise<ListErrorResponse | ListResponse<T, Meta>>;
+export {};

package/utils/resolve.js

@@ -0,0 +1,20 @@
+import { ErrorResponse, ListErrorResponse, ListResponse, Response } from "../responses.js";
+const emptyResolver = ()=>({});
+const resolve = async (fn)=>{
+    try {
+        return new Response(await fn());
+    } catch (ex) {
+        return new ErrorResponse(ex);
+    }
+};
+const resolveList = async (fn)=>{
+    try {
+        const result = await fn();
+        return new ListResponse(result.items, result.meta);
+    } catch (ex) {
+        return new ListErrorResponse(ex);
+    }
+};
+export { emptyResolver, resolve, resolveList };
+
+//# sourceMappingURL=resolve.js.map

package/utils/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils/resolve.js","sources":["../../src/utils/resolve.ts"],"sourcesContent":["import { ErrorResponse, ListErrorResponse, ListResponse, Response } from \"~/responses.js\";\nimport type { GenericRecord } from \"@webiny/api/types.js\";\n\nexport interface Meta {\n    totalCount: number;\n    hasMoreItems: boolean;\n    cursor: string | null;\n}\n\nexport const emptyResolver = () => ({});\n\ninterface ResolveCallable<T = GenericRecord> {\n    (): Promise<T>;\n}\n\nexport const resolve = async <T = GenericRecord>(fn: ResolveCallable<T>) => {\n    try {\n        return new Response(await fn());\n    } catch (ex) {\n        return new ErrorResponse(ex);\n    }\n};\n\ninterface ResolveListCallable<T> {\n    (): Promise<IListResult<T>>;\n}\n\ninterface IListResult<T = GenericRecord> {\n    items: T[];\n    meta: Meta;\n}\n\nexport const resolveList = async <T = GenericRecord>(fn: ResolveListCallable<T>) => {\n    try {\n        const result = (await fn()) as IListResult<T>;\n        return new ListResponse(result.items, result.meta);\n    } catch (ex) {\n        return new ListErrorResponse(ex);\n    }\n};\n"],"names":["emptyResolver","resolve","fn","Response","ex","ErrorResponse","resolveList","result","ListResponse","ListErrorResponse"],"mappings":";AASO,MAAMA,gBAAgB,IAAO,EAAC;AAM9B,MAAMC,UAAU,OAA0BC;IAC7C,IAAI;QACA,OAAO,IAAIC,SAAS,MAAMD;IAC9B,EAAE,OAAOE,IAAI;QACT,OAAO,IAAIC,cAAcD;IAC7B;AACJ;AAWO,MAAME,cAAc,OAA0BJ;IACjD,IAAI;QACA,MAAMK,SAAU,MAAML;QACtB,OAAO,IAAIM,aAAaD,OAAO,KAAK,EAAEA,OAAO,IAAI;IACrD,EAAE,OAAOH,IAAI;QACT,OAAO,IAAIK,kBAAkBL;IACjC;AACJ"}