fix!: convert tokens.quantity column to numeric

it does not fit to Postgres bigint

also, fix the parseBigInt transformer by serializing to str:
TypeORM seems to be working incosistently
and accepts js BigInt on INSERT, but not WHERE

Author: mkazlauskas

packages/cardano-services/src/Projection/migrations/1691042603934-tokens-quantity-numeric.ts

@@ -0,0 +1,14 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+import { TokensEntity } from '@cardano-sdk/projection-typeorm';
+
+export class TokensQuantityNumericMigrations1691042603934 implements MigrationInterface {
+  static entity = TokensEntity;
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query('ALTER TABLE "tokens" ALTER COLUMN "quantity" TYPE numeric(20,0) USING quantity::numeric');
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query('ALTER TABLE "tokens" ALTER COLUMN "quantity" TYPE bigint USING quantity::bigint');
+  }
+}

packages/cardano-services/src/Projection/migrations/index.ts

@@ -12,6 +12,7 @@ import { PoolMetricsMigrations1685011799580 } from './1685011799580-stake-pool-m
 import { PoolRegistrationTableMigration1682519108360 } from './1682519108360-pool-registration-table';
 import { PoolRetirementTableMigration1682519108361 } from './1682519108361-pool-retirement-table';
 import { StakePoolTableMigration1682519108362 } from './1682519108362-stake-pool-table';
+import { TokensQuantityNumericMigrations1691042603934 } from './1691042603934-tokens-quantity-numeric';
 import { TokensTableMigration1682519108368 } from './1682519108368-tokens-table';
 
 type ProjectionMigration = Function & {
@@ -33,5 +34,6 @@ export const migrations: ProjectionMigration[] = [
   PoolMetricsMigrations1685011799580,
   HandleTableMigration1686138943349,
   CostPledgeNumericMigration1689091319930,
-  NftMetadataTableMigration1690269355640
+  NftMetadataTableMigration1690269355640,
+  TokensQuantityNumericMigrations1691042603934
 ];

packages/projection-typeorm/src/entity/PoolRegistration.entity.ts

@@ -1,5 +1,5 @@
 /* eslint-disable brace-style */
-import { BigIntColumnOptions, ImaginaryCoinsColumnOptions, OnDeleteCascadeRelationOptions } from './util';
+import { BigIntColumnOptions, OnDeleteCascadeRelationOptions, UInt64ColumnOptions } from './util';
 import { BlockEntity } from './Block.entity';
 import { Cardano } from '@cardano-sdk/core';
 import { Column, Entity, JoinColumn, ManyToOne, OneToOne, PrimaryColumn } from 'typeorm';
@@ -17,9 +17,9 @@ export class PoolRegistrationEntity {
   id?: bigint;
   @Column()
   rewardAccount?: Cardano.RewardAccount;
-  @Column(ImaginaryCoinsColumnOptions)
+  @Column(UInt64ColumnOptions)
   pledge?: bigint;
-  @Column(ImaginaryCoinsColumnOptions)
+  @Column(UInt64ColumnOptions)
   cost?: bigint;
   // Review: should we store this as 'double' instead?
   // Maybe both formats? If we'll need to do computations with this

packages/projection-typeorm/src/entity/Tokens.entity.ts

@@ -1,6 +1,6 @@
 import { AssetEntity } from './Asset.entity';
-import { BigIntColumnOptions, OnDeleteCascadeRelationOptions } from './util';
 import { Column, Entity, JoinColumn, ManyToOne, PrimaryGeneratedColumn } from 'typeorm';
+import { OnDeleteCascadeRelationOptions, UInt64ColumnOptions } from './util';
 import { OutputEntity } from './Output.entity';
 
 @Entity()
@@ -13,6 +13,6 @@ export class TokensEntity {
   @JoinColumn()
   @ManyToOne(() => OutputEntity, (output) => output.tokens, OnDeleteCascadeRelationOptions)
   output?: OutputEntity;
-  @Column(BigIntColumnOptions)
+  @Column(UInt64ColumnOptions)
   quantity?: bigint;
 }

packages/projection-typeorm/src/entity/transformers.ts

@@ -43,7 +43,7 @@ export const parseBigInt: ValueTransformer = {
     return typeof obj === 'string' ? BigInt(obj) : obj;
   },
   to(obj: any) {
-    // Works as-is
-    return obj;
+    // It can also be a FindOperator object
+    return typeof obj === 'bigint' ? obj.toString() : obj;
   }
 };

packages/projection-typeorm/src/entity/util.ts

@@ -22,12 +22,12 @@ export const BigIntColumnOptions: Pick<ColumnOptions, 'transformer' | 'type'> =
 };
 
 /**
- * To be used for user-specified coin quantities that are not validated by the node
- * to not exceed max lovelace supply (up to unsigned 64 bit integer):
- * - pool registration cost
- * - pool registration pledge
+ * To be used for
+ * - user-specified coin quantities that are not validated by the node
+ *   to not exceed max lovelace supply
+ * - native asset quantities
  */
-export const ImaginaryCoinsColumnOptions: Pick<ColumnOptions, 'transformer' | 'type' | 'precision' | 'scale'> = {
+export const UInt64ColumnOptions: Pick<ColumnOptions, 'transformer' | 'type' | 'precision' | 'scale'> = {
   precision: 20,
   scale: 0,
   transformer: parseBigInt,