feat(hyperboard): enhance hyperboard functionality and restructure related components

- Introduced new fields in hyperboardArgs for collections and improved type definitions in hyperboardTypeDefs.
- Migrated HyperboardResolver to services directory
- Updated HyperboardService with comprehensive documentation and new methods for managing hyperboard collections and admins.
- Documented and tested HyperboardsQueryStrategy for optimized query handling with filtering capabilities.
- Added extensive test coverage for HyperboardResolver, HyperboardService, and HyperboardsQueryStrategy, ensuring robust functionality and error handling.
- Improved mock data generation utilities for hyperboards and related entities.

Author: bitbeckers

src/graphql/schemas/args/hyperboardArgs.ts

@@ -7,6 +7,13 @@ import { ArgsType } from "type-graphql";
 const { WhereInput: HyperboardWhereInput, SortOptions: HyperboardSortOptions } =
   createEntityArgs("Hyperboard", {
     ...WhereFieldDefinitions.Hyperboard.fields,
+    collections: {
+      type: "id",
+      references: {
+        entity: EntityTypeDefs.Collection,
+        fields: WhereFieldDefinitions.Collection.fields,
+      },
+    },
     admins: {
       type: "id",
       references: {

src/graphql/schemas/resolvers/composed.ts

@@ -5,7 +5,7 @@ import { FractionResolver } from "../../../services/graphql/resolvers/fractionRe
 import { AttestationResolver } from "../../../services/graphql/resolvers/attestationResolver.js";
 import { AttestationSchemaResolver } from "../../../services/graphql/resolvers/attestationSchemaResolver.js";
 import { OrderResolver } from "../../../services/graphql/resolvers/orderResolver.js";
-import { HyperboardResolver } from "./hyperboardResolver.js";
+import { HyperboardResolver } from "../../../services/graphql/resolvers/hyperboardResolver.js";
 import { AllowlistRecordResolver } from "../../../services/graphql/resolvers/allowlistRecordResolver.js";
 import { SalesResolver } from "../../../services/graphql/resolvers/salesResolver.js";
 import { UserResolver } from "../../../services/graphql/resolvers/userResolver.js";

src/graphql/schemas/resolvers/hyperboardResolver.ts

@@ -1,10 +1,20 @@
 import { Field, ObjectType } from "type-graphql";
-import { BasicTypeDef } from "./baseTypes/basicTypeDef.js";
+import { DataResponse } from "../../../lib/graphql/DataResponse.js";
 import { EthBigInt } from "../../scalars/ethBigInt.js";
-import GetUsersResponse, { User } from "./userTypeDefs.js";
-import { GraphQLBigInt } from "graphql-scalars";
+import { BasicTypeDef } from "./baseTypes/basicTypeDef.js";
 import { Collection } from "./collectionTypeDefs.js";
-import { DataResponse } from "../../../lib/graphql/DataResponse.js";
+import GetUsersResponse, { User } from "./userTypeDefs.js";
+
+@ObjectType()
+export class HyperboardOwner extends User {
+  @Field()
+  percentage_owned?: number;
+}
+
+@ObjectType()
+export class GetHyperboardOwnersResponse extends DataResponse(
+  HyperboardOwner,
+) {}
 
 @ObjectType({
   description: "Hyperboard of hypercerts for reference and display purposes",
@@ -37,8 +47,8 @@ export class Hyperboard extends BasicTypeDef {
   @Field(() => [SectionResponseType])
   sections?: SectionResponseType[];
 
-  @Field(() => [HyperboardOwner])
-  owners?: HyperboardOwner[];
+  @Field(() => GetHyperboardOwnersResponse)
+  owners?: GetHyperboardOwnersResponse;
 }
 
 @ObjectType({})
@@ -63,16 +73,23 @@ export class Section {
   @Field(() => [SectionEntry])
   entries?: SectionEntry[];
 
-  @Field(() => [HyperboardOwner])
-  owners?: HyperboardOwner[];
+  @Field(() => GetHyperboardOwnersResponse)
+  owners?: GetHyperboardOwnersResponse[];
 }
 
 @ObjectType()
-export class HyperboardOwner extends User {
+class SectionEntryOwner extends User {
   @Field()
-  percentage_owned?: number;
+  percentage?: number;
+  @Field(() => EthBigInt, { nullable: true })
+  units?: bigint | number | string;
 }
 
+@ObjectType()
+export class GetSectionEntryOwnersResponse extends DataResponse(
+  SectionEntryOwner,
+) {}
+
 @ObjectType({
   description: "Entry representing a hypercert or blueprint within a section",
 })
@@ -87,19 +104,11 @@ class SectionEntry {
   display_size?: number;
   @Field({ description: "Name of the hypercert or blueprint", nullable: true })
   name?: string;
-  @Field(() => GraphQLBigInt, { nullable: true })
+  @Field(() => EthBigInt, { nullable: true })
   total_units?: bigint | number | string;
 
-  @Field(() => [SectionEntryOwner])
-  owners?: SectionEntryOwner[];
-}
-
-@ObjectType()
-class SectionEntryOwner extends User {
-  @Field()
-  percentage?: number;
-  @Field(() => GraphQLBigInt, { nullable: true })
-  units?: bigint | number | string;
+  @Field(() => GetSectionEntryOwnersResponse)
+  owners?: GetSectionEntryOwnersResponse;
 }
 
 @ObjectType()