@pothos/plugin-drizzle 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @pothos/plugin-drizzle
+
+## 0.0.1
+
+### Patch Changes
+
+- dd2e758: Initial preview release

package/LICENSE

@@ -0,0 +1,6 @@
+ISC License (ISC)
+Copyright 2021 Michael Hayes
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,437 @@
+# Drizzle Plugin
+
+## Installing
+
+```package-install
+npm install --save @pothos/plugin-drizzle
+```
+
+The drizzle plugin is built on top of drizzles relational query builder, and requires that you
+define and configure all the relevant relations in your drizzle schema. See
+https://orm.drizzle.team/docs/rqb for detailed documentation on the relations API.
+
+In addition to defining relations, the Pothos drizzle plugin also requires defining a `primaryKey`
+for every table used as a `drizzleObject`, `drizzleNode`, or `drizzleInterface`.
+
+Once you have configured you have configured you drizzle schema, you can initialize your Pothos
+SchemaBuilder with the drizzle plugin:
+
+```ts
+import * as schema from './schema';
+import { drizzle } from 'drizzle-orm/...';
+import SchemaBuilder from '@pothos/core';
+import DrizzlePlugin from '@pothos/plugin-drizzle';
+
+const db = drizzle(client, { schema });
+
+export interface PothosTypes {
+  DrizzleSchema: typeof schema;
+}
+
+const builder = new SchemaBuilder<PothosTypes>({
+  plugins: [DrizzlePlugin],
+  drizzle: {
+    client: db,
+  },
+});
+```
+
+### Integration with other plugins
+
+The drizzle plugin has integrations with several other plugins. While the `with-input` and `relay`
+plugins are not required, many examples will assume these plugins have been installed:
+
+```ts
+import * as schema from './schema';
+import { drizzle } from 'drizzle-orm/...';
+import SchemaBuilder from '@pothos/core';
+import DrizzlePlugin from '@pothos/plugin-drizzle';
+import RelayPlugin from '@pothos/plugin-scope-auth';
+import WithInputPlugin from '@pothos/plugin-with-input';
+
+const db = drizzle(client, { schema });
+
+export interface PothosTypes {
+  DrizzleSchema: typeof schema;
+}
+
+const builder = new SchemaBuilder<PothosTypes>({
+  plugins: [RelayPlugin, WithInputPlugin, DrizzlePlugin],
+  drizzle: {
+    client: db,
+  },
+});
+```
+
+## Defining Objects
+
+The `builder.drizzleObject` method can be used to define GraphQL Object types based on a drizzle
+table:
+
+```ts
+const UserRef = builder.drizzleObject('users', {
+  name: 'User',
+  fields: (t) => ({
+    firstName: t.exposeString('first_name'),
+    lastName: t.exposeString('last_name'),
+  }),
+});
+```
+
+You will be able to "expose" any column in the table, and GraphQL fields do not need to match the
+names of the columns in your database. The returned `UserRef` can be used like any other `ObjectRef`
+in Pothos.
+
+## Custom fields
+
+You will often want to define fields in your API that do not correspond to a specific database
+column. To do this, you can define fields with a resolver like any other Pothos object type:
+
+```ts
+const UserRef = builder.drizzleObject('users', {
+  name: 'User',
+  fields: (t) => ({
+    fullName: t.string({
+      resolve: (user, args, ctx, info) => `${user.first_name} ${user.last_name}`,
+    }),
+  }),
+});
+```
+
+## Type selections
+
+In the above example, you can see that by default we have access to all columns of our table. For
+tables with many columns, it can be more efficient to only select the needed columns. You can
+configure the selected columns, and relations by passing a `select` option when defining the type:
+
+```ts
+const UserRef = builder.drizzleObject('users', {
+  name: 'User',
+  select: {
+    columns: {
+      first_name: true,
+      last_name: true,
+    },
+    with: {
+      profile: true,
+    },
+    extras: {
+      lowercaseName: sql<string>`lower(${users.firstName})`.as('lowercaseName'),
+    },
+  },
+  fields: (t) => ({
+    fullName: t.string({
+      resolve: (user, args, ctx, info) => `${user.first_name} ${user.last_name}`,
+    }),
+    bio: t.string({
+      resolve: (user) => user.profile.bio,
+    }),
+    email: t.string({
+      resolve: (user) => `${user.lowercaseName}@example.com`,
+    }),
+  }),
+});
+```
+
+Any selections added to the type will be available to consume in all resolvers. Columns that are not
+selected can still be exposed as before.
+
+## Field selections
+
+The previous example allows you to control what gets selected by default, but you often want to only
+select the columns that are required to fulfill a specific field. You can do this by adding the
+appropriate selections on each field:
+
+```ts
+const UserRef = builder.drizzleObject('users', {
+  name: 'User',
+  select: {
+    // By default all columns are selected, so this is required to default to an empty selection
+    columns: {},
+  },
+  fields: (t) => ({
+    fullName: t.string({
+      select: {
+        columns: { first_name: true, last_name: true },
+      },
+      resolve: (user, args, ctx, info) => `${user.first_name} ${user.last_name}`,
+    }),
+    bio: t.string({
+      select: {
+        // Currently, adding a selection without explicitly defining columns will cause all columns to be selected
+        columns: {},
+        with: { profile: true },
+      },
+      resolve: (user) => user.profile.bio,
+    }),
+    email: t.string({
+      select: {
+        columns: {},
+        extras: {
+          lowercaseName: sql<string>`lower(${users.firstName})`.as('lowercaseName'),
+        },
+      },
+      resolve: (user) => `${user.lowercaseName}@example.com`,
+    }),
+  }),
+});
+```
+
+## Relations
+
+Drizzles relational query builder allows you to define the relationships between your tables. The
+`builder.relation` method makes it easy to add fields to your GraphQL API that implement those
+relations:
+
+```ts
+builder.drizzleObject('profiles', {
+  name: 'Profile',
+  fields: (t) => ({
+    bio: t.exposeString('bio'),
+  }),
+});
+
+builder.drizzleObject('posts', {
+  name: 'Post',
+  fields: (t) => ({
+    title: t.exposeString('title'),
+    author: t.relation('author'),
+  }),
+});
+
+builder.drizzleObject('users', {
+  name: 'User',
+  fields: (t) => ({
+    firstName: t.exposeString('first_name'),
+    profile: t.relation('profile'),
+    posts: t.relation('posts'),
+  }),
+});
+```
+
+The relation will automatically define GraphQL fields of the appropriate type based on the relation
+defined in your drizzle schema.
+
+## Relation queries
+
+For some cases, exposing relations as fields without any customization works great, but in some
+cases you may want to apply some filtering or ordering to your relations. This can be done by
+specifying a `query` option on the relation:
+
+```ts
+builder.drizzleObject('users', {
+  name: 'User',
+  fields: (t) => ({
+    firstName: t.exposeString('first_name'),
+    posts: t.relation('posts', {
+      args: {
+        limit: t.arg.int(),
+        offset: t.arg.int(),
+      },
+      query: (args) => ({
+        limit: args.limit ?? 10,
+        offset: args.offset ?? 0,
+        where: (post, { eq }) => eq(post.published, true),
+        orderBy: (post, { desc }) => desc(post.updatedAt),
+      }),
+    }),
+    drafts: t.relation('posts', {
+      query: {
+        where: (post, { eq }) => eq(post.published, false),
+      },
+    }),
+  }),
+});
+```
+
+The query API enables you to define args and convert them into parameters that will be passed into
+the relational query builder. You can read more about the relation query builder api
+[here](https://orm.drizzle.team/docs/rqb#querying)
+
+## Drizzle Fields
+
+Drizzle objects and relations allow you to define parts of your schema backed by your drizzle
+schema, but don't provide a clear entry point into this Graph of data. To make your drizzle objects
+queryable, we will need to add fields that return our drizzle objects. This can be done using the
+`t.drizzleField` method. This can be used to define fields on the root `Query` type, or any other
+object type in your schema:
+
+```ts
+builder.queryType({
+  fields: (t) => ({
+    post: t.drizzleField({
+      type: 'posts',
+      args: {
+        id: t.arg.id({ required: true }),
+      },
+      resolve: (query, root, args, ctx) =>
+        db.query.posts.findFirst(
+          query({
+            where: eq(posts.id, Number.parseInt(args.id, 10)),
+          }),
+        ),
+    }),
+    posts: t.drizzleField({
+      type: ['posts'],
+      resolve: (query, root, args, ctx) => db.query.posts.findMany(query()),
+    }),
+  }),
+});
+```
+
+The `resolve` function of a `drizzleField` will be passed a `query` function that MUST be called and
+passed to a drizzle `findOne` or `findMany` query. The `query` function optionally accepts any
+arguments that are normally passed into the query, and will merge these options with the selection
+used to resolve data for the nested GraphQL selections.
+
+## Variants
+
+It is often useful to be able to define multiple object types based on the same table. This can be
+done using a feature called `variants`. The `variants` API consists of 3 parts:
+
+- A `variant` option that can be passed instead of a name on `drizzleObjects`
+- The ability to pass an `ObjectRef` to the `type` option of `t.relation` and other similar fields
+- A `t.field` method that works similar to `t.relation, but is used to define a GraphQL field that
+  references a variant of the same record.
+
+```ts
+// Viewer type representing the current user
+export const Viewer = builder.drizzleObject('users', {
+  variant: 'Viewer',
+  select: {
+    columns: {},
+  },
+  fields: (t) => ({
+    id: t.exposeID('id'),
+    // A reference to the normal user type so normal user fields can be queried
+    user: t.variant('users'),
+    // Adding drafts to View allows a user to fetch their own drafts without exposing it for Other Users in the API
+    drafts: t.relation('posts', {
+      query: {
+        where: (post, { eq }) => eq(post.published, false),
+        orderBy: (post, ops) => ops.desc(post.updatedAt),
+      },
+    }),
+  }),
+});
+
+builder.queryType({
+  fields: (t) => ({
+    me: t.drizzleField({
+      // We can use the ref returned by builder.drizzleObject to define our `drizzleField`
+      type: Viewer,
+      resolve: (query, root, args, ctx) =>
+        db.query.users.findFirst(
+          query({
+            where: (user, { eq }) => eq(user.id, ctx.user.id),
+          }),
+        ),
+    }),
+  }),
+});
+
+builder.drizzleNode('users', {
+  name: 'User',
+  fields: (t) => ({
+    firstName: t.exposeString('firstName'),
+    // This field will resolve to the Viewer type, but be set to null if the user is not the current user
+    viewer: t.variant(Viewer, {
+      isNull: (user, args, ctx) => user.id !== ctx.user?.id,
+    }),
+  }),
+});
+```
+
+## Relay integration
+
+Relay provides some very useful best practices that are useful for most GraphQL APIs. To make it
+easy to comply with these best practices, the drizzle plugin has built in support for defining relay
+`nodes` and `connections`.
+
+## Relay Nodes
+
+Defining relay nodes works just like defining normal `drizzleObject`s, but requires specifying a
+colum to use as the nodes `id` field.
+
+```ts
+builder.drizzleNode('users', {
+  name: 'User',
+  id: {
+    column: (user) => user.id,
+    // other options for the ID field can be passed here
+  },
+  fields: (t) => ({
+    firstName: t.exposeString('firstName'),
+    lastName: t.exposeString('lastName'),
+  }),
+});
+```
+
+The id column can also be set to a list of columns for types with a composite primary key.
+
+## Related connections
+
+To implement a relation as a connection, you can use `t.relatedConnection` instead of `t.relation`:
+
+```ts
+builder.drizzleNode('users', {
+  name: 'User',
+  fields: (t) => ({
+    posts: t.relatedConnection('posts'),
+  }),
+});
+```
+
+This will automatically define the `Connection`, and `Edge` types, and their respective fields. To
+customize the Connection and Edge types, options for these types can be passed as additional
+arguments to `t.relatedConnection`, just like `t.connection` from the relay plugin. See the
+[relay plugin docs](https://pothos-graphql.dev/docs/plugins/relay) for more details.
+
+You can also define a `query` like with `t.relation`. The only difference with `t.relatedConnection`
+is that the `orderBy` format is slightly changed.
+
+To comply with the relay spec and efficiently support backwards pagination, some queries need to be
+performed in reverse order, which requires inverting the orderBy clause. To do this automatically,
+the `t.relatedConnection` method accepts orderBy as an object like `{ asc: column }` or
+`{ desc: column }` rather than using the `asc(column)` and `desc(column)` helpers from drizzle.
+orderBy can still be returned as either a single column or array when ordering by multiple columns.
+
+Ordering defaults to using the table `primaryKey`, and the orderBy columns will also be used to
+derive the connections cursor.
+
+```ts
+builder.drizzleNode('users', {
+  name: 'User',
+  fields: (t) => ({
+    posts: t.relatedConnection('posts', {
+      query: () => ({
+        where: (post, { eq }) => eq(post.published, 1),
+        orderBy: (post) => ({
+          desc: post.id,
+        }),
+      }),
+    }),
+  }),
+});
+```
+
+## Drizzle connections
+
+Similar to `t.drizzleField`, `t.drizzleConnection` allows you to define a connection field that acts
+as an entry point to your drizzle query. The `orderBy` in `t.drizzleConnection` works the same way
+as it does for `t.relatedConnection`
+
+```ts
+builder.queryFields((t) => ({
+  posts: t.drizzleConnection({
+    type: 'posts',
+    resolve: (query, root, args, ctx) =>
+      db.query.posts.findMany(
+        query({
+          where: (post, { eq }) => eq(post.published, true),
+          orderBy: (post) => ({ desc: post.id }),
+        }),
+      ),
+  }),
+}));
+```

package/TODO.md

@@ -0,0 +1,21 @@
+## TODO
+
+- [x] connections
+- [ ] connection helpers
+- [ ] query usage checks
+- [x] normalize extras callback functions before merging
+- [x] with input integration
+- [x] errors integration
+- [x] drizzle field methods on builder
+- [x] drizzle refs
+- [x] drizzle interface types
+- [x] relay nodes
+- [ ] tests
+- [x] docs
+- [x] variants
+- [x] fallback dataloader
+- [ ] custom dataloader override
+- [x] default selections for id/data-loading
+- [ ] interface check for compatibility of implementors
+- [ ] totalCount API
+- [ ] Indirect many to many connections (requires v2 relational API)

package/drizzle/meta/_journal.json

@@ -0,0 +1 @@
+{"version":"7","dialect":"postgresql","entries":[]}

package/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './tests/example/db/schema.ts',
+  out: './tests/drizzle',
+  dialect: 'sqlite',
+  dbCredentials: {
+    url: './tests/example/db/dev.db',
+  },
+});

package/dts/drizzle-field-builder.d.ts

@@ -0,0 +1,124 @@
+import { InferModelFromColumns, TableRelationalConfig } from 'drizzle-orm';
+import { CompatibleTypes, ExposeNullability, FieldKind, FieldRef, InputFieldMap, InterfaceParam, NormalizeArgs, ObjectRef, PluginName, SchemaTypes, ShapeFromTypeParam, TypeParam } from '@pothos/core';
+import { DrizzleConnectionShape, ListRelation, RelatedConnectionOptions, RelatedFieldOptions, ShapeFromConnection, TypesForRelation, VariantFieldOptions } from './types';
+import { DrizzleRef } from './interface-ref';
+declare const RootBuilder: {
+    new <Types extends SchemaTypes, Shape, Kind extends FieldKind>(builder: PothosSchemaTypes.SchemaBuilder<Types>, kind: FieldKind, graphqlKind: PothosSchemaTypes.PothosKindToGraphQLType[FieldKind]): PothosSchemaTypes.RootFieldBuilder<Types, Shape, Kind>;
+};
+export declare class DrizzleObjectFieldBuilder<Types extends SchemaTypes, TableConfig extends TableRelationalConfig, Shape, ExposableShape = InferModelFromColumns<TableConfig['columns']>> extends RootBuilder<Types, Shape, 'DrizzleObject'> {
+    exposeBoolean: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, "Boolean", true>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, "Boolean", ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, "Boolean", Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, "Boolean", Nullable>, "DrizzleObject">;
+    exposeFloat: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, "Float", true>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, "Float", ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, "Float", Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, "Float", Nullable>, "DrizzleObject">;
+    exposeInt: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, "Int", true>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, "Int", ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, "Int", Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, "Int", Nullable>, "DrizzleObject">;
+    exposeID: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, "ID", true>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, "ID", ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, "ID", Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, "ID", Nullable>, "DrizzleObject">;
+    exposeString: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, "String", true>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, "String", ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, "String", Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, "String", Nullable>, "DrizzleObject">;
+    exposeBooleanList: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, ["Boolean"], {
+        list: true;
+        items: true;
+    }>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, ["Boolean"], ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, ["Boolean"], Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, ["Boolean"], Nullable>, "DrizzleObject">;
+    exposeFloatList: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, ["Float"], {
+        list: true;
+        items: true;
+    }>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, ["Float"], ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, ["Float"], Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, ["Float"], Nullable>, "DrizzleObject">;
+    exposeIntList: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, ["Int"], {
+        list: true;
+        items: true;
+    }>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, ["Int"], ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, ["Int"], Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, ["Int"], Nullable>, "DrizzleObject">;
+    exposeIDList: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, ["ID"], {
+        list: true;
+        items: true;
+    }>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, ["ID"], ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, ["ID"], Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, ["ID"], Nullable>, "DrizzleObject">;
+    exposeStringList: <Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, ["String"], {
+        list: true;
+        items: true;
+    }>>(...args: NormalizeArgs<[name: Name, options: ExposeNullability<Types, ["String"], ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, ExposableShape, ["String"], Nullable, {}, ResolveReturnShape>, "select" | "resolve" | "nullable" | "type"> & {
+        description?: string | false;
+    }], 1>) => FieldRef<Types, ShapeFromTypeParam<Types, ["String"], Nullable>, "DrizzleObject">;
+    table: string;
+    typename: string;
+    relatedConnection: 'relay' extends PluginName ? <Field extends ListRelation<TableConfig>, Nullable extends boolean, Args extends InputFieldMap, ConnectionInterfaces extends InterfaceParam<Types>[] = [], EdgeInterfaces extends InterfaceParam<Types>[] = []>(field: Field, options: RelatedConnectionOptions<Types, Shape, TableConfig, Field, Nullable, Args>, ...args: NormalizeArgs<[
+        connectionOptions: ObjectRef<Types, ShapeFromConnection<PothosSchemaTypes.ConnectionShapeHelper<Types, TypesForRelation<Types, TableConfig['relations'][Field]>, false>>> | PothosSchemaTypes.ConnectionObjectOptions<Types, ObjectRef<Types, ShapeFromTypeParam<Types, [
+            ObjectRef<Types, TypesForRelation<Types, TableConfig['relations'][Field]>>
+        ], Nullable>>, false, false, DrizzleConnectionShape<Types, ShapeFromTypeParam<Types, [
+            ObjectRef<Types, TypesForRelation<Types, TableConfig['relations'][Field]>>
+        ], Nullable>, Shape, Args>, ConnectionInterfaces>,
+        edgeOptions: ObjectRef<Types, {
+            cursor: string;
+            node?: TypesForRelation<Types, TableConfig['relations'][Field]>;
+        }> | PothosSchemaTypes.ConnectionEdgeObjectOptions<Types, ObjectRef<Types, ShapeFromTypeParam<Types, [
+            ObjectRef<Types, TypesForRelation<Types, TableConfig['relations'][Field]>>
+        ], Nullable>>, false, DrizzleConnectionShape<Types, ShapeFromTypeParam<Types, [
+            ObjectRef<Types, TypesForRelation<Types, TableConfig['relations'][Field]>>
+        ], Nullable>, Shape, Args>, EdgeInterfaces>
+    ], 0>) => FieldRef<Types, ShapeFromConnection<PothosSchemaTypes.ConnectionShapeHelper<Types, Shape, Nullable>>> : '@pothos/plugin-relay is required to use this method';
+    constructor(typename: string, builder: PothosSchemaTypes.SchemaBuilder<Types>, table: string, graphqlKind?: PothosSchemaTypes.PothosKindToGraphQLType[FieldKind]);
+    variant<Variant extends DrizzleRef<Types, TableConfig['tsName']> | TableConfig['tsName'], Args extends InputFieldMap, Nullable, ResolveShape, ResolveReturn>(variant: Variant, ...allArgs: NormalizeArgs<[
+        options: VariantFieldOptions<Types, TableConfig['tsName'] & keyof Types['DrizzleRelationSchema'], Variant, Args, Nullable, Shape, ResolveShape, ResolveReturn>
+    ]>): FieldRef<Types, ResolveReturn, 'Object'>;
+    relation<Field extends keyof TableConfig['relations'], Nullable extends boolean, Args extends InputFieldMap, ResolveReturnShape>(name: Field, ...allArgs: NormalizeArgs<[
+        options: RelatedFieldOptions<Types, TableConfig, Field, Nullable, Args, ResolveReturnShape, Shape>
+    ]>): FieldRef<Types, TypesForRelation<Types, TableConfig['relations'][Field]>, 'Object'>;
+    expose<Type extends TypeParam<Types>, Nullable extends boolean, ResolveReturnShape, Name extends CompatibleTypes<Types, ExposableShape, Type, Nullable>>(...args: NormalizeArgs<[
+        name: Name,
+        options: ExposeNullability<Types, Type, ExposableShape, Name, Nullable> & Omit<PothosSchemaTypes.ObjectFieldOptions<Types, Shape, Type, Nullable, {}, ResolveReturnShape>, 'nullable' | 'resolve' | 'select'>
+    ]>): FieldRef<Types, ShapeFromTypeParam<Types, Type, (false & (Type extends [unknown] ? Awaited<ExposableShape[Name]> extends readonly (infer T)[] | null | undefined ? [T] extends [NonNullable<T>] ? (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? boolean | {
+        items: boolean;
+        list: boolean;
+    } : true | {
+        items: boolean;
+        list: true;
+    } : (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? {
+        items: true;
+        list: boolean;
+    } : {
+        items: true;
+        list: true;
+    } : never : Awaited<ExposableShape[Name]> extends NonNullable<Awaited<ExposableShape[Name]>> ? boolean : true) & Nullable) | (true & (Type extends [unknown] ? Awaited<ExposableShape[Name]> extends readonly (infer T)[] | null | undefined ? [T] extends [NonNullable<T>] ? (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? boolean | {
+        items: boolean;
+        list: boolean;
+    } : true | {
+        items: boolean;
+        list: true;
+    } : (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? {
+        items: true;
+        list: boolean;
+    } : {
+        items: true;
+        list: true;
+    } : never : Awaited<ExposableShape[Name]> extends NonNullable<Awaited<ExposableShape[Name]>> ? boolean : true) & Nullable) | ((Type extends [unknown] ? boolean | {
+        items: boolean;
+        list: boolean;
+    } : boolean) & (Type extends [unknown] ? Awaited<ExposableShape[Name]> extends readonly (infer T)[] | null | undefined ? [T] extends [NonNullable<T>] ? (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? boolean | {
+        items: boolean;
+        list: boolean;
+    } : true | {
+        items: boolean;
+        list: true;
+    } : (readonly T[] | null | undefined) & Awaited<ExposableShape[Name]> extends readonly T[] & Awaited<ExposableShape[Name]> ? {
+        items: true;
+        list: boolean;
+    } : {
+        items: true;
+        list: true;
+    } : never : Awaited<ExposableShape[Name]> extends NonNullable<Awaited<ExposableShape[Name]>> ? boolean : true) & Nullable)>, "DrizzleObject">;
+    private createExpose;
+}
+export {};
+//# sourceMappingURL=drizzle-field-builder.d.ts.map

package/dts/drizzle-field-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-field-builder.d.ts","sourceRoot":"","sources":["../src/drizzle-field-builder.ts"],"names":[],"mappings":"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"}

package/dts/field-builder.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=field-builder.d.ts.map

package/dts/field-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-builder.d.ts","sourceRoot":"","sources":["../src/field-builder.ts"],"names":[],"mappings":""}