How to use @envelop/* plugins and set the Context?

[mrcleanandfresh]

The docs mention that KitQL uses GraphQL Yoga and Envelop under the hood, which I was really excited about. Before I found this project, I was trying to set up something very similar to this on my own. So I was very excited to try it, but felt the documentation very "alpha" in nature. I almost felt like I was missing some foundational knowledge that was expected. But I was able to piece things together and get it working.

Now I wanted to use an @envelop/auth0 plugin as well as some other plugins. I looked all over the docs and I felt it was missing was
"how to use @envelop/* plugins" even though the tool uses it under the hood.

I am trying to use some of them, but I keep getting type errors when trying to put them in the plugin array. This is my code:

import { useKitqlModules, type KitQLHandleGraphQL } from '@kitql/all-in';
import type { RequestEvent } from '@sveltejs/kit';

import { useAuth0 } from '@envelop/auth0';
import { PrismaClient } from '@prisma/client';
import { modules } from './$kitql/_appModules';
import { envelop } from '@envelop/core';

const getEnveloped = envelop({
	plugins: [
		useAuth0({
                  // truncated
		}),
		useKitqlModules(modules)
	]
});

export type IKitQLContext = ReturnType<Awaited<typeof getContext>>;

async function getContext({ request }: RequestEvent) {
        // The envelop docs say to do this, but I have NO idea if KitQL does this internally or not, so am I wasting my time here? 
	const { contextFactory } = getEnveloped({ req: request });
	const contextValue = await contextFactory({ req: request });
	return {
		...contextValue,
		prisma: new PrismaClient()
	};
}

export const kitqlServer: KitQLHandleGraphQL<IKitQLContext, RequestEvent> = {
	// @ts-expect-error - the context isn't quite right... something is wrong here the type is {} and it's complaing
	plugins: getEnveloped._plugins,
	context: getContext
};

I also tried to use it like this, with some success, but it's the auth0 plugin doesn't seem to be present at all within the context. I am also getting type errors when trying to put anything in the plugin array. The Plugin[] type comes from GraphQL Yoga within KitQL, so I assume I can use it like the above. Originally, I tried to do it like this:

import { useKitqlModules, type KitQLHandleGraphQL } from '@kitql/all-in';
import type { RequestEvent } from '@sveltejs/kit';

import { useAuth0 } from '@envelop/auth0';
import { PrismaClient } from '@prisma/client';
import { modules } from './$kitql/_appModules';
import { envelop } from '@envelop/core';

const plugins = [
	useAuth0({
              // truncated
	}),
	useKitqlModules(modules)
];

export type IKitQLContext = ReturnType<typeof getContext>;

async function getContext({ request }: RequestEvent) {
	return {
		prisma: new PrismaClient()
	};
}

export const kitqlServer: KitQLHandleGraphQL<IKitQLContext, RequestEvent> = {
	// @ts-expect-error - the context isn't quite right... something is wrong here the type is {} and it's complaing
	plugins,
	context: getContext
};

If KitQL does enveloping under the hood, I would expect the context to be:

{
  req,
  auth0,
  prisma
}

Or some kind of indication of whether I should be spreading existing context in to get the same result, like so:

// pseudo code
async function getContext({ request, ctx }: RequestEvent) {
	return {
                ...ctx,
		prisma: new PrismaClient()
	};
}

I'm just confused and could really use some clarification. Some questions I have:

1. Does KitQL use getEnveloped for requests under the hood? Am I doing double work using the context factory?
2. If it does use getEnveloped under the hood, do I simply provide a list of enveloped plugins and it will "envelop" them internally? Or is it a private part of the KitQL API?
3. How do I define the ctx.ts file that gets generated with an empty object export? Seems like a good place to add my PrismaClient to the object, since it has a comment // no DbProvider found above the empty object.

Any help would be greatly appreciated. Trying to figure out how to add authentication but am pretty lost based on the lack of docs.

P.S. Another annoying thing is I am on Windows, and the generator keeps generating code like this:

// graphql/$kitql/_appModules.ts
import { __initModule } from '../../../../src\lib\modules\__init';
import { _settingsModule } from '../../../../src\lib\modules\_settings';

export const modules = [
  __initModule,
  _settingsModule,
];

Then Vite gives me errors:

Failed to load url ../../../../srclibmodules__init (resolved id: ../../../../srclibmodules__init) in C:/Users/<path>/src/lib/graphql/$kitql/_appModules.ts. Does the file exist?
Failed to load url ../../../../srclibmodules_settings (resolved id: ../../../../srclibmodules_settings) in C:/C:/Users/<path>/src/lib/graphql/$kitql/_appModules.ts. Does the file exist?
2:56:28 PM [vite] Error when evaluating SSR module /src/lib/graphql/$kitql/_appModules.ts: failed to import "../../../../srclibmodules__init"
|- Error: Failed to load url ../../../../srclibmodules__init (resolved id: ../../../../srclibmodules__init) in C:/Users/kevin/Code/monthly-budget/src/lib/graphql/$kitql/_appModules.ts. Does the file exist?
    at loadAndTransform (file:///C:/C:/Users/<path>/node_modules/vite/dist/node/chunks/dep-a178814b.js:53325:21)

Changing the import to:

// graphql/$kitql/_appModules.ts
import { __initModule } from '../../../../src/lib/modules/__init';
import { _settingsModule } from '../../../../src/lib/modules/_settings';

fixes this issue until the next time KitQL recompiles, and I have to change it again.