@nest-boot/graphql-connection 7.6.0 → 7.6.2

package/dist/connection-query-builder.d.ts

@@ -2,6 +2,22 @@ import { EntityManager } from "@mikro-orm/core";
 import { ConnectionFindOptions } from "./connection.manager";
 import { ConnectionArgsInterface, EdgeInterface } from "./interfaces";
 import { ConnectionClass } from "./types";
+/**
+ * Builds and executes paginated queries for GraphQL connections.
+ *
+ * This class handles the complexity of cursor-based pagination including:
+ * - Forward and backward pagination
+ * - Custom ordering with fallback to ID ordering
+ * - Filter query construction from multiple sources (args, options, query string)
+ * - Cursor encoding/decoding for stable pagination
+ *
+ * @typeParam Entity - The entity type being queried
+ * @typeParam Hint - Type hints for population
+ * @typeParam Fields - Fields to select
+ * @typeParam Excludes - Fields to exclude
+ *
+ * @internal This class is used internally by ConnectionManager
+ */
 export declare class ConnectionQueryBuilder<Entity extends object, Hint extends string = never, Fields extends string = "*", Excludes extends string = never> {
     private readonly entityManager;
     private readonly connectionClass;
@@ -30,6 +46,11 @@ export declare class ConnectionQueryBuilder<Entity extends object, Hint extends
     private getCursorFilterQuery;
     private getQueryStringToFilterQuery;
     private mergeFilterQuery;
+    /**
+     * Executes the paginated query and returns the connection result.
+     *
+     * @returns A promise that resolves to the connection with edges, pageInfo, and totalCount
+     */
     query(): Promise<{
         totalCount: number;
         edges: EdgeInterface<Entity>[];

package/dist/connection-query-builder.js

@@ -12,6 +12,22 @@ const search_syntax_1 = require("search-syntax");
 const cursor_1 = require("./cursor");
 const enums_1 = require("./enums");
 const graphql_connection_constants_1 = require("./graphql-connection.constants");
+/**
+ * Builds and executes paginated queries for GraphQL connections.
+ *
+ * This class handles the complexity of cursor-based pagination including:
+ * - Forward and backward pagination
+ * - Custom ordering with fallback to ID ordering
+ * - Filter query construction from multiple sources (args, options, query string)
+ * - Cursor encoding/decoding for stable pagination
+ *
+ * @typeParam Entity - The entity type being queried
+ * @typeParam Hint - Type hints for population
+ * @typeParam Fields - Fields to select
+ * @typeParam Excludes - Fields to exclude
+ *
+ * @internal This class is used internally by ConnectionManager
+ */
 class ConnectionQueryBuilder {
     constructor(entityManager, connectionClass, args, options) {
         this.entityManager = entityManager;
@@ -176,6 +192,11 @@ class ConnectionQueryBuilder {
             $and: filterQueryGroup,
         };
     }
+    /**
+     * Executes the paginated query and returns the connection result.
+     *
+     * @returns A promise that resolves to the connection with edges, pageInfo, and totalCount
+     */
     async query() {
         const [entities, totalCount] = await Promise.all([
             this.allFilterQuery === null

package/dist/connection-query-builder.js.map

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

package/dist/connection.builder.d.ts

@@ -3,6 +3,14 @@ import { type Type } from "@nestjs/common";
 import { GraphQLScalarType } from "graphql";
 import type { ZodType } from "zod";
 import { ConnectionArgsInterface, ConnectionBuilderOptions, ConnectionInterface, EdgeInterface, FieldOptions, OrderFieldType, OrderInterface } from "./interfaces";
+/**
+ * The result of building a connection with ConnectionBuilder.
+ *
+ * Contains all the GraphQL types needed for cursor-based pagination,
+ * including dynamic named types based on the entity name.
+ *
+ * @typeParam Entity - The entity type for the connection
+ */
 type ConnectionBuildResult<Entity extends object> = {
     Connection: Type<ConnectionInterface<Entity>>;
     ConnectionArgs: Type<ConnectionArgsInterface<Entity>>;
@@ -12,13 +20,88 @@ type ConnectionBuildResult<Entity extends object> = {
     Order: Type<OrderInterface<Entity>>;
     OrderField?: OrderFieldType<Entity>;
 } & Record<`${EntityClass<Entity>["name"]}Connection`, Type<ConnectionInterface<Entity>>> & Record<`${EntityClass<Entity>["name"]}ConnectionArgs`, Type<ConnectionArgsInterface<Entity>>> & Record<`${EntityClass<Entity>["name"]}Edge`, Type<EdgeInterface<Entity>>> & Record<`${EntityClass<Entity>["name"]}Order`, Type<OrderInterface<Entity>>> & Record<`${EntityClass<Entity>["name"]}OrderField`, OrderFieldType<Entity>> & Record<`${EntityClass<Entity>["name"]}Filter`, GraphQLScalarType<FilterQuery<Entity>>>;
+/**
+ * Builder class for creating GraphQL connection types following the Relay specification.
+ *
+ * The ConnectionBuilder generates all necessary GraphQL types for cursor-based pagination:
+ * - Connection type with edges, pageInfo, and totalCount
+ * - Edge type with node and cursor
+ * - ConnectionArgs type with first, last, after, before, orderBy, filter, and query
+ * - Order input type for sorting
+ * - Filter scalar type for MongoDB-style filtering
+ *
+ * @typeParam Entity - The MikroORM entity type for the connection
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { ConnectionBuilder } from "@nest-boot/graphql-connection";
+ * import { User } from "./user.entity";
+ *
+ * const { Connection, ConnectionArgs, Edge } = new ConnectionBuilder(User)
+ *   .addField({ field: "name", type: "string", filterable: true, sortable: true })
+ *   .addField({ field: "createdAt", type: "date", sortable: true })
+ *   .build();
+ *
+ * // Use in resolver
+ * @Query(() => Connection)
+ * async users(@Args() args: typeof ConnectionArgs) {
+ *   return this.connectionManager.find(Connection, args);
+ * }
+ * ```
+ *
+ * @example With custom filter options
+ * ```typescript
+ * const { Connection, ConnectionArgs } = new ConnectionBuilder(User, {
+ *   filter: {
+ *     maxDepth: 3,
+ *     maxConditions: 10,
+ *   },
+ * })
+ *   .addField({ field: "email", type: "string", filterable: true })
+ *   .build();
+ * ```
+ */
 export declare class ConnectionBuilder<Entity extends object> {
     private readonly entityClass;
     private readonly entityName;
     private readonly options;
     private readonly fieldOptionsMap;
+    /**
+     * Creates a new ConnectionBuilder instance.
+     *
+     * @param entityClass - The MikroORM entity class to build connection types for
+     * @param options - Optional configuration for the connection builder
+     */
     constructor(entityClass: EntityClass<Entity>, options?: Partial<ConnectionBuilderOptions>);
+    /**
+     * Adds a field configuration to the connection builder.
+     *
+     * Fields can be configured for filtering, sorting, and searching.
+     * The field type determines what filter operators are available.
+     *
+     * @typeParam Type - The field type ("string", "number", "boolean", or "date")
+     * @typeParam Field - The field path in the entity
+     * @param options - The field configuration options
+     * @returns The builder instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .addField({ field: "name", type: "string", filterable: true, searchable: true })
+     *   .addField({ field: "age", type: "number", filterable: true, sortable: true })
+     *   .addField({ field: "isActive", type: "boolean", filterable: true })
+     *   .addField({ field: "createdAt", type: "date", sortable: true });
+     * ```
+     */
     addField<Type extends "string" | "number" | "boolean" | "date" = never, Field extends string = never>(options: FieldOptions<Entity, Type, Field>): this;
+    /**
+     * Builds and returns all GraphQL types for the connection.
+     *
+     * The returned object contains both generic type references and
+     * entity-specific named types (e.g., UserConnection, UserEdge).
+     *
+     * @returns An object containing all generated connection types
+     */
     build(): ConnectionBuildResult<Entity>;
 }
 export {};

package/dist/connection.builder.js

@@ -2,7 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionBuilder = void 0;
 const utils_1 = require("./utils");
+/**
+ * Builder class for creating GraphQL connection types following the Relay specification.
+ *
+ * The ConnectionBuilder generates all necessary GraphQL types for cursor-based pagination:
+ * - Connection type with edges, pageInfo, and totalCount
+ * - Edge type with node and cursor
+ * - ConnectionArgs type with first, last, after, before, orderBy, filter, and query
+ * - Order input type for sorting
+ * - Filter scalar type for MongoDB-style filtering
+ *
+ * @typeParam Entity - The MikroORM entity type for the connection
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { ConnectionBuilder } from "@nest-boot/graphql-connection";
+ * import { User } from "./user.entity";
+ *
+ * const { Connection, ConnectionArgs, Edge } = new ConnectionBuilder(User)
+ *   .addField({ field: "name", type: "string", filterable: true, sortable: true })
+ *   .addField({ field: "createdAt", type: "date", sortable: true })
+ *   .build();
+ *
+ * // Use in resolver
+ * @Query(() => Connection)
+ * async users(@Args() args: typeof ConnectionArgs) {
+ *   return this.connectionManager.find(Connection, args);
+ * }
+ * ```
+ *
+ * @example With custom filter options
+ * ```typescript
+ * const { Connection, ConnectionArgs } = new ConnectionBuilder(User, {
+ *   filter: {
+ *     maxDepth: 3,
+ *     maxConditions: 10,
+ *   },
+ * })
+ *   .addField({ field: "email", type: "string", filterable: true })
+ *   .build();
+ * ```
+ */
 class ConnectionBuilder {
+    /**
+     * Creates a new ConnectionBuilder instance.
+     *
+     * @param entityClass - The MikroORM entity class to build connection types for
+     * @param options - Optional configuration for the connection builder
+     */
     constructor(entityClass, options) {
         this.entityClass = entityClass;
         this.fieldOptionsMap = new Map();
@@ -18,10 +65,38 @@ class ConnectionBuilder {
             },
         };
     }
+    /**
+     * Adds a field configuration to the connection builder.
+     *
+     * Fields can be configured for filtering, sorting, and searching.
+     * The field type determines what filter operators are available.
+     *
+     * @typeParam Type - The field type ("string", "number", "boolean", or "date")
+     * @typeParam Field - The field path in the entity
+     * @param options - The field configuration options
+     * @returns The builder instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .addField({ field: "name", type: "string", filterable: true, searchable: true })
+     *   .addField({ field: "age", type: "number", filterable: true, sortable: true })
+     *   .addField({ field: "isActive", type: "boolean", filterable: true })
+     *   .addField({ field: "createdAt", type: "date", sortable: true });
+     * ```
+     */
     addField(options) {
         this.fieldOptionsMap.set(options.field, options);
         return this;
     }
+    /**
+     * Builds and returns all GraphQL types for the connection.
+     *
+     * The returned object contains both generic type references and
+     * entity-specific named types (e.g., UserConnection, UserEdge).
+     *
+     * @returns An object containing all generated connection types
+     */
     build() {
         const Edge = (0, utils_1.createEdge)(this.entityClass, this.entityName);
         const { Order, OrderField } = (0, utils_1.createOrder)(this.entityName, this.fieldOptionsMap);

package/dist/connection.builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.builder.js","sourceRoot":"","sources":["../src/connection.builder.ts"],"names":[],"mappings":";;;AAeA,mCAMiB;AA0BjB,MAAa,iBAAiB;IAU5B,YACmB,WAAgC,EACjD,OAA2C;QAD1B,gBAAW,GAAX,WAAW,CAAqB;QANlC,oBAAe,GAAG,IAAI,GAAG,EAGvC,CAAC;QAMF,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC;QAEnC,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC;gBACX,aAAa,EAAE,EAAE;gBACjB,aAAa,EAAE,CAAC;gBAChB,cAAc,EAAE,GAAG;gBACnB,GAAG,OAAO,EAAE,MAAM;aACnB;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAGN,OAA0C;QAC1C,IAAI,CAAC,eAAe,CAAC,GAAG,CACtB,OAAO,CAAC,KAAK,EACb,OAAkD,CACnD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAA,mBAAW,EACvC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,CACrB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAA,oBAAY,EAChD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,OAAO,EAAE,MAAM,CACrB,CAAC;QAEF,MAAM,UAAU,GAAG,IAAA,wBAAgB,EACjC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,IAAI,EACJ,IAAI,CAAC,eAAe,EACpB,iBAAiB,CAClB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAA,4BAAoB,EACzC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,EACpB,KAAK,EACL,MAAM,CACP,CAAC;QAEF,OAAO;YACL,UAAU;YACV,cAAc;YACd,IAAI;YACJ,MAAM;YACN,iBAAiB;YACjB,KAAK;YACL,UAAU;YACV,CAAC,GAAG,IAAI,CAAC,UAAU,YAAY,CAAC,EAAE,UAAU;YAC5C,CAAC,GAAG,IAAI,CAAC,UAAU,gBAAgB,CAAC,EAAE,cAAc;YACpD,CAAC,GAAG,IAAI,CAAC,UAAU,MAAM,CAAC,EAAE,IAAI;YAChC,CAAC,GAAG,IAAI,CAAC,UAAU,QAAQ,CAAC,EAAE,MAAM;YACpC,CAAC,GAAG,IAAI,CAAC,UAAU,OAAO,CAAC,EAAE,KAAK;YAClC,CAAC,GAAG,IAAI,CAAC,UAAU,YAAY,CAAC,EAAE,UAAU;SACZ,CAAC;IACrC,CAAC;CACF;AApFD,8CAoFC"}
+{"version":3,"file":"connection.builder.js","sourceRoot":"","sources":["../src/connection.builder.ts"],"names":[],"mappings":";;;AAeA,mCAMiB;AAkCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAa,iBAAiB;IAU5B;;;;;OAKG;IACH,YACmB,WAAgC,EACjD,OAA2C;QAD1B,gBAAW,GAAX,WAAW,CAAqB;QAZlC,oBAAe,GAAG,IAAI,GAAG,EAGvC,CAAC;QAYF,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC;QAEnC,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC;gBACX,aAAa,EAAE,EAAE;gBACjB,aAAa,EAAE,CAAC;gBAChB,cAAc,EAAE,GAAG;gBACnB,GAAG,OAAO,EAAE,MAAM;aACnB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAGN,OAA0C;QAC1C,IAAI,CAAC,eAAe,CAAC,GAAG,CACtB,OAAO,CAAC,KAAK,EACb,OAAkD,CACnD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK;QACH,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAA,mBAAW,EACvC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,CACrB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAA,oBAAY,EAChD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,OAAO,EAAE,MAAM,CACrB,CAAC;QAEF,MAAM,UAAU,GAAG,IAAA,wBAAgB,EACjC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,IAAI,EACJ,IAAI,CAAC,eAAe,EACpB,iBAAiB,CAClB,CAAC;QAEF,MAAM,cAAc,GAAG,IAAA,4BAAoB,EACzC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,eAAe,EACpB,KAAK,EACL,MAAM,CACP,CAAC;QAEF,OAAO;YACL,UAAU;YACV,cAAc;YACd,IAAI;YACJ,MAAM;YACN,iBAAiB;YACjB,KAAK;YACL,UAAU;YACV,CAAC,GAAG,IAAI,CAAC,UAAU,YAAY,CAAC,EAAE,UAAU;YAC5C,CAAC,GAAG,IAAI,CAAC,UAAU,gBAAgB,CAAC,EAAE,cAAc;YACpD,CAAC,GAAG,IAAI,CAAC,UAAU,MAAM,CAAC,EAAE,IAAI;YAChC,CAAC,GAAG,IAAI,CAAC,UAAU,QAAQ,CAAC,EAAE,MAAM;YACpC,CAAC,GAAG,IAAI,CAAC,UAAU,OAAO,CAAC,EAAE,KAAK;YAClC,CAAC,GAAG,IAAI,CAAC,UAAU,YAAY,CAAC,EAAE,UAAU;SACZ,CAAC;IACrC,CAAC;CACF;AAtHD,8CAsHC"}

package/dist/connection.manager.d.ts

@@ -2,11 +2,67 @@ import { EntityManager, type FilterQuery } from "@mikro-orm/core";
 import type { FindOptions } from "@mikro-orm/core/drivers";
 import { ConnectionArgsInterface, ConnectionInterface } from "./interfaces";
 import { ConnectionClass } from "./types";
+/**
+ * Options for the ConnectionManager.find method.
+ *
+ * Extends MikroORM FindOptions but excludes pagination-related options
+ * (limit, offset, orderBy) which are handled by the connection arguments.
+ *
+ * @typeParam Entity - The entity type being queried
+ * @typeParam Hint - Type hints for population
+ * @typeParam Fields - Fields to select
+ * @typeParam Excludes - Fields to exclude
+ */
 export interface ConnectionFindOptions<Entity extends object, Hint extends string = never, Fields extends string = "*", Excludes extends string = never> extends Exclude<FindOptions<Entity, Hint, Fields, Excludes>, "limit" | "offset" | "orderBy"> {
+    /**
+     * Additional filter query to apply to the connection query.
+     * This is merged with any filters from the connection arguments.
+     */
     where?: FilterQuery<Entity>;
 }
+/**
+ * Service for executing paginated GraphQL connection queries.
+ *
+ * The ConnectionManager provides a high-level API for querying entities
+ * with cursor-based pagination following the Relay connection specification.
+ *
+ * @example Basic usage in a resolver
+ * ```typescript
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   constructor(private readonly connectionManager: ConnectionManager) {}
+ *
+ *   @Query(() => UserConnection)
+ *   async users(@Args() args: UserConnectionArgs): Promise<UserConnection> {
+ *     return this.connectionManager.find(UserConnection, args);
+ *   }
+ * }
+ * ```
+ *
+ * @example With additional filters
+ * ```typescript
+ * @Query(() => UserConnection)
+ * async activeUsers(@Args() args: UserConnectionArgs): Promise<UserConnection> {
+ *   return this.connectionManager.find(UserConnection, args, {
+ *     where: { isActive: true },
+ *   });
+ * }
+ * ```
+ */
 export declare class ConnectionManager {
     private readonly em;
     constructor(em: EntityManager);
+    /**
+     * Finds entities and returns them as a paginated connection.
+     *
+     * @typeParam Entity - The entity type being queried
+     * @typeParam Hint - Type hints for population
+     * @typeParam Fields - Fields to select
+     * @typeParam Excludes - Fields to exclude
+     * @param connectionClass - The connection class generated by ConnectionBuilder
+     * @param args - The connection arguments (first, last, after, before, orderBy, filter, query)
+     * @param options - Additional find options (where, populate, etc.)
+     * @returns A promise that resolves to the paginated connection result
+     */
     find<Entity extends object, Hint extends string = never, Fields extends string = "*", Excludes extends string = never>(connectionClass: ConnectionClass<Entity>, args: ConnectionArgsInterface<Entity>, options?: ConnectionFindOptions<Entity, Hint, Fields, Excludes>): Promise<ConnectionInterface<Entity>>;
 }

package/dist/connection.manager.js

@@ -13,10 +13,51 @@ exports.ConnectionManager = void 0;
 const core_1 = require("@mikro-orm/core");
 const common_1 = require("@nestjs/common");
 const connection_query_builder_1 = require("./connection-query-builder");
+/**
+ * Service for executing paginated GraphQL connection queries.
+ *
+ * The ConnectionManager provides a high-level API for querying entities
+ * with cursor-based pagination following the Relay connection specification.
+ *
+ * @example Basic usage in a resolver
+ * ```typescript
+ * @Resolver(() => User)
+ * export class UserResolver {
+ *   constructor(private readonly connectionManager: ConnectionManager) {}
+ *
+ *   @Query(() => UserConnection)
+ *   async users(@Args() args: UserConnectionArgs): Promise<UserConnection> {
+ *     return this.connectionManager.find(UserConnection, args);
+ *   }
+ * }
+ * ```
+ *
+ * @example With additional filters
+ * ```typescript
+ * @Query(() => UserConnection)
+ * async activeUsers(@Args() args: UserConnectionArgs): Promise<UserConnection> {
+ *   return this.connectionManager.find(UserConnection, args, {
+ *     where: { isActive: true },
+ *   });
+ * }
+ * ```
+ */
 let ConnectionManager = class ConnectionManager {
     constructor(em) {
         this.em = em;
     }
+    /**
+     * Finds entities and returns them as a paginated connection.
+     *
+     * @typeParam Entity - The entity type being queried
+     * @typeParam Hint - Type hints for population
+     * @typeParam Fields - Fields to select
+     * @typeParam Excludes - Fields to exclude
+     * @param connectionClass - The connection class generated by ConnectionBuilder
+     * @param args - The connection arguments (first, last, after, before, orderBy, filter, query)
+     * @param options - Additional find options (where, populate, etc.)
+     * @returns A promise that resolves to the paginated connection result
+     */
     async find(connectionClass, args, options) {
         return await new connection_query_builder_1.ConnectionQueryBuilder(this.em, connectionClass, args, options).query();
     }

package/dist/connection.manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.manager.js","sourceRoot":"","sources":["../src/connection.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAkE;AAElE,2CAA4C;AAE5C,yEAAoE;AAiB7D,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD,KAAK,CAAC,IAAI,CAMR,eAAwC,EACxC,IAAqC,EACrC,OAA+D;QAE/D,OAAO,MAAM,IAAI,iDAAsB,CACrC,IAAI,CAAC,EAAE,EACP,eAAe,EACf,IAAI,EACJ,OAAO,CACR,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;CACF,CAAA;AApBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAEsB,oBAAa;GADnC,iBAAiB,CAoB7B"}
+{"version":3,"file":"connection.manager.js","sourceRoot":"","sources":["../src/connection.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAkE;AAElE,2CAA4C;AAE5C,yEAAoE;AA+BpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,CAMR,eAAwC,EACxC,IAAqC,EACrC,OAA+D;QAE/D,OAAO,MAAM,IAAI,iDAAsB,CACrC,IAAI,CAAC,EAAE,EACP,eAAe,EACf,IAAI,EACJ,OAAO,CACR,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;CACF,CAAA;AAhCY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAEsB,oBAAa;GADnC,iBAAiB,CAgC7B"}

package/dist/cursor.d.ts

@@ -1,6 +1,41 @@
+/**
+ * Represents a cursor for cursor-based pagination in GraphQL connections.
+ *
+ * Cursors are encoded as base64 JSON strings containing the position information
+ * needed for pagination. They typically include the entity ID and optionally
+ * the value of the field being sorted by.
+ *
+ * @example Creating a cursor from an object
+ * ```typescript
+ * const cursor = new Cursor({ id: '123', value: 'some-value' });
+ * console.log(cursor.toString()); // Base64 encoded string
+ * ```
+ *
+ * @example Parsing a cursor string
+ * ```typescript
+ * const cursor = new Cursor('eyJpZCI6IjEyMyJ9');
+ * console.log(cursor.id); // '123'
+ * ```
+ */
 export declare class Cursor implements Record<string, any> {
+    /**
+     * The entity ID stored in the cursor.
+     */
     id?: string;
+    /**
+     * Allows additional properties to be stored in the cursor.
+     */
     [key: string]: any;
+    /**
+     * Creates a new Cursor instance.
+     *
+     * @param cursor - Either a base64-encoded cursor string or an object containing cursor data
+     */
     constructor(cursor: string | Record<string, any>);
+    /**
+     * Converts the cursor to a base64-encoded string representation.
+     *
+     * @returns The cursor encoded as a base64 JSON string
+     */
     toString(): string;
 }

package/dist/cursor.js

@@ -1,7 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cursor = void 0;
+/**
+ * Represents a cursor for cursor-based pagination in GraphQL connections.
+ *
+ * Cursors are encoded as base64 JSON strings containing the position information
+ * needed for pagination. They typically include the entity ID and optionally
+ * the value of the field being sorted by.
+ *
+ * @example Creating a cursor from an object
+ * ```typescript
+ * const cursor = new Cursor({ id: '123', value: 'some-value' });
+ * console.log(cursor.toString()); // Base64 encoded string
+ * ```
+ *
+ * @example Parsing a cursor string
+ * ```typescript
+ * const cursor = new Cursor('eyJpZCI6IjEyMyJ9');
+ * console.log(cursor.id); // '123'
+ * ```
+ */
 class Cursor {
+    /**
+     * Creates a new Cursor instance.
+     *
+     * @param cursor - Either a base64-encoded cursor string or an object containing cursor data
+     */
     constructor(cursor) {
         if (typeof cursor === "string") {
             try {
@@ -21,6 +45,11 @@ class Cursor {
             });
         }
     }
+    /**
+     * Converts the cursor to a base64-encoded string representation.
+     *
+     * @returns The cursor encoded as a base64 JSON string
+     */
     toString() {
         return Buffer.from(JSON.stringify(this)).toString("base64");
     }

package/dist/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../src/cursor.ts"],"names":[],"mappings":";;;AAAA,MAAa,MAAM;IAKjB,YAAY,MAAoC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAErE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;oBAC/C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACpB,CAAC,CAAC,CAAC;gBACH,6DAA6D;YAC/D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,EAAE;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF;AA3BD,wBA2BC"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../src/cursor.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,MAAM;IAWjB;;;;OAIG;IACH,YAAY,MAAoC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAErE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;oBAC/C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACpB,CAAC,CAAC,CAAC;gBACH,6DAA6D;YAC/D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,EAAE;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF;AA3CD,wBA2CC"}

package/dist/enums/order-direction.enum.d.ts

@@ -1,4 +1,21 @@
+/**
+ * Specifies the direction for ordering query results.
+ *
+ * @example
+ * ```typescript
+ * const order = {
+ *   field: "CREATED_AT",
+ *   direction: OrderDirection.DESC,
+ * };
+ * ```
+ */
 export declare enum OrderDirection {
+    /**
+     * Ascending order (smallest to largest, A to Z, oldest to newest).
+     */
     ASC = "ASC",
+    /**
+     * Descending order (largest to smallest, Z to A, newest to oldest).
+     */
     DESC = "DESC"
 }

package/dist/enums/order-direction.enum.js

@@ -2,9 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrderDirection = void 0;
 const graphql_1 = require("@nest-boot/graphql");
+/**
+ * Specifies the direction for ordering query results.
+ *
+ * @example
+ * ```typescript
+ * const order = {
+ *   field: "CREATED_AT",
+ *   direction: OrderDirection.DESC,
+ * };
+ * ```
+ */
 var OrderDirection;
 (function (OrderDirection) {
+    /**
+     * Ascending order (smallest to largest, A to Z, oldest to newest).
+     */
     OrderDirection["ASC"] = "ASC";
+    /**
+     * Descending order (largest to smallest, Z to A, newest to oldest).
+     */
     OrderDirection["DESC"] = "DESC";
 })(OrderDirection || (exports.OrderDirection = OrderDirection = {}));
 (0, graphql_1.registerEnumType)(OrderDirection, { name: "OrderDirection" });

package/dist/enums/order-direction.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"order-direction.enum.js","sourceRoot":"","sources":["../../src/enums/order-direction.enum.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAEtD,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB;AAED,IAAA,0BAAgB,EAAC,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC"}
+{"version":3,"file":"order-direction.enum.js","sourceRoot":"","sources":["../../src/enums/order-direction.enum.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAEtD;;;;;;;;;;GAUG;AACH,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB;;OAEG;IACH,6BAAW,CAAA;IAEX;;OAEG;IACH,+BAAa,CAAA;AACf,CAAC,EAVW,cAAc,8BAAd,cAAc,QAUzB;AAED,IAAA,0BAAgB,EAAC,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC"}

package/dist/enums/paging-type.enum.d.ts

@@ -1,4 +1,17 @@
+/**
+ * Represents the pagination direction for cursor-based pagination.
+ *
+ * @internal Used by ConnectionQueryBuilder to determine query direction
+ */
 export declare enum PagingType {
+    /**
+     * Forward pagination using `first` and `after` arguments.
+     * Fetches items after the cursor, moving towards the end of the list.
+     */
     FORWARD = "FORWARD",
+    /**
+     * Backward pagination using `last` and `before` arguments.
+     * Fetches items before the cursor, moving towards the start of the list.
+     */
     BACKWARD = "BACKWARD"
 }

package/dist/enums/paging-type.enum.js

@@ -1,9 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PagingType = void 0;
+/**
+ * Represents the pagination direction for cursor-based pagination.
+ *
+ * @internal Used by ConnectionQueryBuilder to determine query direction
+ */
 var PagingType;
 (function (PagingType) {
+    /**
+     * Forward pagination using `first` and `after` arguments.
+     * Fetches items after the cursor, moving towards the end of the list.
+     */
     PagingType["FORWARD"] = "FORWARD";
+    /**
+     * Backward pagination using `last` and `before` arguments.
+     * Fetches items before the cursor, moving towards the start of the list.
+     */
     PagingType["BACKWARD"] = "BACKWARD";
 })(PagingType || (exports.PagingType = PagingType = {}));
 //# sourceMappingURL=paging-type.enum.js.map

package/dist/enums/paging-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"paging-type.enum.js","sourceRoot":"","sources":["../../src/enums/paging-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,mCAAqB,CAAA;AACvB,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB"}
+{"version":3,"file":"paging-type.enum.js","sourceRoot":"","sources":["../../src/enums/paging-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,UAYX;AAZD,WAAY,UAAU;IACpB;;;OAGG;IACH,iCAAmB,CAAA;IAEnB;;;OAGG;IACH,mCAAqB,CAAA;AACvB,CAAC,EAZW,UAAU,0BAAV,UAAU,QAYrB"}

package/dist/graphql-connection.constants.d.ts

@@ -1 +1,10 @@
+/**
+ * Symbol used as a metadata key for storing connection metadata on connection classes.
+ *
+ * This symbol is used internally by the connection builder to attach metadata
+ * (entity class, field options, filter schema) to generated connection classes.
+ * The metadata is then used by the ConnectionQueryBuilder to construct queries.
+ *
+ * @internal
+ */
 export declare const GRAPHQL_CONNECTION_METADATA: unique symbol;