@graphprotocol/grc-20 0.27.0 → 0.29.0

package/dist/src/ranks/create-rank.test.js

@@ -0,0 +1,246 @@
+import { describe, expect, it } from 'vitest';
+import { DESCRIPTION_PROPERTY, NAME_PROPERTY, RANK_TYPE, RANK_TYPE_PROPERTY, RANK_VOTES_RELATION_TYPE, TYPES_PROPERTY, VOTE_ORDINAL_VALUE_PROPERTY, VOTE_WEIGHTED_VALUE_PROPERTY, } from '../core/ids/system.js';
+import { Id, isValid } from '../id.js';
+import { createRank } from './create-rank.js';
+describe('createRank', () => {
+    const movie1Id = Id('f47ac10b-58cc-4372-a567-0e02b2c3d479');
+    const movie2Id = Id('550e8400-e29b-41d4-a716-446655440000');
+    const movie3Id = Id('6ba7b810-9dad-11d1-80b4-00c04fd430c8');
+    describe('ordinal ranks', () => {
+        it('creates a basic ordinal rank with one vote', () => {
+            const rank = createRank({
+                name: 'My Favorite Movie',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }],
+            });
+            expect(rank).toBeDefined();
+            expect(typeof rank.id).toBe('string');
+            expect(rank.ops).toBeDefined();
+            expect(rank.voteIds).toHaveLength(1);
+            // 1 UPDATE_ENTITY (rank) + 1 CREATE_RELATION (type) + 1 CREATE_RELATION (vote) + 1 UPDATE_ENTITY (vote value)
+            expect(rank.ops).toHaveLength(4);
+            // Check rank entity creation
+            expect(rank.ops[0]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    id: rank.id,
+                    values: expect.arrayContaining([
+                        { property: NAME_PROPERTY, value: 'My Favorite Movie' },
+                        { property: RANK_TYPE_PROPERTY, value: 'ORDINAL' },
+                    ]),
+                },
+            });
+            // Check type relation to RANK_TYPE
+            expect(rank.ops[1]).toMatchObject({
+                type: 'CREATE_RELATION',
+                relation: {
+                    fromEntity: rank.id,
+                    toEntity: RANK_TYPE,
+                    type: TYPES_PROPERTY,
+                },
+            });
+            // Check vote relation
+            expect(rank.ops[2]).toMatchObject({
+                type: 'CREATE_RELATION',
+                relation: {
+                    fromEntity: rank.id,
+                    toEntity: movie1Id,
+                    type: RANK_VOTES_RELATION_TYPE,
+                },
+            });
+            // Check vote entity with ordinal value
+            expect(rank.ops[3]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    id: rank.voteIds[0],
+                    values: [
+                        {
+                            property: VOTE_ORDINAL_VALUE_PROPERTY,
+                            value: expect.any(String), // fractional index
+                        },
+                    ],
+                },
+            });
+        });
+        it('creates an ordinal rank with multiple votes in order', () => {
+            const rank = createRank({
+                name: 'Top 3 Movies',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }, { entityId: movie2Id }, { entityId: movie3Id }],
+            });
+            expect(rank.voteIds).toHaveLength(3);
+            // 1 UPDATE_ENTITY + 1 type relation + 3 vote relations + 3 vote entities = 8 ops
+            expect(rank.ops).toHaveLength(8);
+            // Verify fractional indices are in ascending order
+            const ordinalValue1 = rank.ops[3].entity.values[0]?.value;
+            const ordinalValue2 = rank.ops[5].entity.values[0]?.value;
+            const ordinalValue3 = rank.ops[7].entity.values[0]?.value;
+            expect(ordinalValue1 && ordinalValue2 && ordinalValue1 < ordinalValue2).toBe(true);
+            expect(ordinalValue2 && ordinalValue3 && ordinalValue2 < ordinalValue3).toBe(true);
+        });
+        it('creates an ordinal rank with optional description', () => {
+            const rank = createRank({
+                name: 'My Movies',
+                description: 'A ranked list of my favorite movies',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }],
+            });
+            expect(rank.ops[0]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    id: rank.id,
+                    values: expect.arrayContaining([
+                        { property: NAME_PROPERTY, value: 'My Movies' },
+                        { property: RANK_TYPE_PROPERTY, value: 'ORDINAL' },
+                        { property: DESCRIPTION_PROPERTY, value: 'A ranked list of my favorite movies' },
+                    ]),
+                },
+            });
+        });
+    });
+    describe('weighted ranks', () => {
+        it('creates a basic weighted rank with one vote', () => {
+            const rank = createRank({
+                name: 'Restaurant Rating',
+                rankType: 'WEIGHTED',
+                votes: [{ entityId: movie1Id, value: 4.5 }],
+            });
+            expect(rank).toBeDefined();
+            expect(rank.voteIds).toHaveLength(1);
+            expect(rank.ops).toHaveLength(4);
+            // Check rank entity has WEIGHTED type
+            expect(rank.ops[0]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    values: expect.arrayContaining([{ property: RANK_TYPE_PROPERTY, value: 'WEIGHTED' }]),
+                },
+            });
+            // Check vote entity with weighted value (serialized as string)
+            expect(rank.ops[3]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    id: rank.voteIds[0],
+                    values: [
+                        {
+                            property: VOTE_WEIGHTED_VALUE_PROPERTY,
+                            value: '4.5', // serialized number
+                        },
+                    ],
+                },
+            });
+        });
+        it('creates a weighted rank with multiple votes', () => {
+            const rank = createRank({
+                name: 'Movie Scores',
+                rankType: 'WEIGHTED',
+                votes: [
+                    { entityId: movie1Id, value: 9.2 },
+                    { entityId: movie2Id, value: 8.5 },
+                    { entityId: movie3Id, value: 7.8 },
+                ],
+            });
+            expect(rank.voteIds).toHaveLength(3);
+            expect(rank.ops).toHaveLength(8);
+            // Verify weighted values are correct
+            expect(rank.ops[3]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    values: [{ property: VOTE_WEIGHTED_VALUE_PROPERTY, value: '9.2' }],
+                },
+            });
+            expect(rank.ops[5]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    values: [{ property: VOTE_WEIGHTED_VALUE_PROPERTY, value: '8.5' }],
+                },
+            });
+            expect(rank.ops[7]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    values: [{ property: VOTE_WEIGHTED_VALUE_PROPERTY, value: '7.8' }],
+                },
+            });
+        });
+        it('handles integer weighted values', () => {
+            const rank = createRank({
+                name: 'Star Ratings',
+                rankType: 'WEIGHTED',
+                votes: [{ entityId: movie1Id, value: 5 }],
+            });
+            expect(rank.ops[3]).toMatchObject({
+                type: 'UPDATE_ENTITY',
+                entity: {
+                    values: [{ property: VOTE_WEIGHTED_VALUE_PROPERTY, value: '5' }],
+                },
+            });
+        });
+    });
+    describe('provided id', () => {
+        it('uses provided id when specified', () => {
+            const providedId = Id('b1dc6e5c-63e1-43ba-b3d4-755b251a4ea1');
+            const rank = createRank({
+                id: providedId,
+                name: 'My Rank',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }],
+            });
+            expect(rank.id).toBe(providedId);
+        });
+        it('generates id when not provided', () => {
+            const rank = createRank({
+                name: 'My Rank',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }],
+            });
+            expect(typeof rank.id).toBe('string');
+            expect(isValid(rank.id)).toBe(true);
+        });
+    });
+    describe('error handling', () => {
+        it('throws an error if the provided id is invalid', () => {
+            expect(() => createRank({
+                id: 'invalid',
+                name: 'My Rank',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }],
+            })).toThrow('Invalid id: "invalid" for `id` in `createRank`');
+        });
+        it('throws an error if a vote entityId is invalid', () => {
+            expect(() => createRank({
+                name: 'My Rank',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: 'invalid-entity-id' }],
+            })).toThrow('Invalid id: "invalid-entity-id" for `entityId` in `votes` in `createRank`');
+        });
+        it('throws an error if duplicate entity IDs are in votes', () => {
+            expect(() => createRank({
+                name: 'My Rank',
+                rankType: 'ORDINAL',
+                votes: [{ entityId: movie1Id }, { entityId: movie2Id }, { entityId: movie1Id }],
+            })).toThrow(`Duplicate entityId in votes: "${movie1Id}". Each entity can only be voted once per rank.`);
+        });
+        it('throws an error for duplicate entity IDs in weighted ranks', () => {
+            expect(() => createRank({
+                name: 'My Scores',
+                rankType: 'WEIGHTED',
+                votes: [
+                    { entityId: movie1Id, value: 5 },
+                    { entityId: movie1Id, value: 3 },
+                ],
+            })).toThrow(`Duplicate entityId in votes: "${movie1Id}". Each entity can only be voted once per rank.`);
+        });
+    });
+    describe('empty votes', () => {
+        it('creates a rank with no votes', () => {
+            const rank = createRank({
+                name: 'Empty Rank',
+                rankType: 'ORDINAL',
+                votes: [],
+            });
+            expect(rank.voteIds).toHaveLength(0);
+            // Only UPDATE_ENTITY (rank) + CREATE_RELATION (type)
+            expect(rank.ops).toHaveLength(2);
+        });
+    });
+});
+//# sourceMappingURL=create-rank.test.js.map

package/dist/src/ranks/create-rank.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-rank.test.js","sourceRoot":"","sources":["../../../src/ranks/create-rank.test.ts"],"names":[],"mappings":"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"}

package/dist/src/ranks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-rank.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ranks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ranks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/src/ranks/index.js

@@ -0,0 +1,3 @@
+export * from './create-rank.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/src/ranks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ranks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/src/ranks/types.d.ts

@@ -0,0 +1,30 @@
+import type { Id } from '../id.js';
+import type { CreateResult } from '../types.js';
+export type RankType = 'ORDINAL' | 'WEIGHTED';
+/**
+ * Vote with ordinal positioning.
+ * Position is derived from the array order; fractional indexing is generated internally.
+ */
+export type VoteOrdinal = {
+    entityId: Id | string;
+};
+/**
+ * Vote with weighted numeric scoring.
+ * Used for ranked lists where the magnitude of the score matters.
+ */
+export type VoteWeighted = {
+    entityId: Id | string;
+    value: number;
+};
+export type Vote = VoteOrdinal | VoteWeighted;
+export type CreateRankParams = {
+    id?: Id | string;
+    name: string;
+    description?: string;
+    rankType: RankType;
+    votes: Vote[];
+};
+export type CreateRankResult = CreateResult & {
+    voteIds: Id[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/ranks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ranks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,OAAO,EAAE,EAAE,EAAE,CAAC;CACf,CAAC"}

package/dist/src/ranks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/ranks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ranks/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphprotocol/grc-20",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "license": "MIT",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",