@geoprotocol/geo-sdk 0.19.1 → 0.19.3

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

@@ -0,0 +1,33 @@
+import type { CreateRankParams, CreateRankResult } from '../ranks/types.js';
+/**
+ * Builds create-rank ops (pure, no network access).
+ *
+ * Each vote carries a `spaceId` (set as `to_space_id` on the vote relation), so
+ * a rank can include the same entity across multiple space perspectives; item
+ * uniqueness is keyed on `(entityId, spaceId)`. Pass an optional `blockId` to
+ * link the rank to a `Ranking Block`.
+ *
+ * For re-submissions use `geo.ranks.update(...)`, which fetches the rank's
+ * existing vote relations and supersedes them.
+ *
+ * @example
+ * ```ts
+ * import { Ops } from '@geoprotocol/geo-sdk';
+ *
+ * const { id, ops, voteIds } = Ops.ranks.create({
+ *   name: 'My Favorite Movies',
+ *   rankType: 'ORDINAL',
+ *   blockId, // optional
+ *   votes: [
+ *     { entityId: movie1Id, spaceId },
+ *     { entityId: movie2Id, spaceId },
+ *   ],
+ * });
+ * ```
+ *
+ * @param params Rank name, type, optional block link, and ordered votes.
+ * @returns Rank entity ID, ops, and the created vote entity IDs.
+ * @throws When any supplied ID is invalid, or a `(entityId, spaceId)` pair is duplicated.
+ */
+export declare const create: (params: CreateRankParams) => CreateRankResult;
+//# sourceMappingURL=ranks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ranks.d.ts","sourceRoot":"","sources":["../../../src/ops/ranks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,gBAAgB,KAAG,gBAAsC,CAAC"}

package/dist/src/ops/ranks.js

@@ -0,0 +1,33 @@
+import { createRank } from '../ranks/create-rank.js';
+/**
+ * Builds create-rank ops (pure, no network access).
+ *
+ * Each vote carries a `spaceId` (set as `to_space_id` on the vote relation), so
+ * a rank can include the same entity across multiple space perspectives; item
+ * uniqueness is keyed on `(entityId, spaceId)`. Pass an optional `blockId` to
+ * link the rank to a `Ranking Block`.
+ *
+ * For re-submissions use `geo.ranks.update(...)`, which fetches the rank's
+ * existing vote relations and supersedes them.
+ *
+ * @example
+ * ```ts
+ * import { Ops } from '@geoprotocol/geo-sdk';
+ *
+ * const { id, ops, voteIds } = Ops.ranks.create({
+ *   name: 'My Favorite Movies',
+ *   rankType: 'ORDINAL',
+ *   blockId, // optional
+ *   votes: [
+ *     { entityId: movie1Id, spaceId },
+ *     { entityId: movie2Id, spaceId },
+ *   ],
+ * });
+ * ```
+ *
+ * @param params Rank name, type, optional block link, and ordered votes.
+ * @returns Rank entity ID, ops, and the created vote entity IDs.
+ * @throws When any supplied ID is invalid, or a `(entityId, spaceId)` pair is duplicated.
+ */
+export const create = (params) => createRank(params);
+//# sourceMappingURL=ranks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ranks.js","sourceRoot":"","sources":["../../../src/ops/ranks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAwB,EAAoB,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC"}

package/dist/src/ops/ranks.test.d.ts

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

package/dist/src/ops/ranks.test.d.ts.map

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

package/dist/src/ops/ranks.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { RANK_BLOCK_RELATION_TYPE, RANK_VOTES_RELATION_TYPE } from '../core/ids/system.js';
+import { toGrcId } from '../id-utils.js';
+import { create } from './ranks.js';
+const MOVIE_1 = 'f47ac10b58cc4372a5670e02b2c3d479';
+const MOVIE_2 = '550e8400e29b41d4a716446655440000';
+const SPACE_ID = 'd4bc2f205e2d415e971eb0b9fbf6b6fc';
+const BLOCK_ID = '9f8e7d6c5b4a49388271605f4e3d2c1b';
+function relationsOfType(ops, typeId) {
+    return ops.filter((op) => op.type === 'createRelation' &&
+        op.relationType.every((byte, index) => byte === toGrcId(typeId)[index]));
+}
+describe('Ops.ranks.create', () => {
+    it('builds rank creation ops (pure, no network)', () => {
+        const result = create({
+            name: 'Top movies',
+            rankType: 'ORDINAL',
+            votes: [
+                { entityId: MOVIE_1, spaceId: SPACE_ID },
+                { entityId: MOVIE_2, spaceId: SPACE_ID },
+            ],
+        });
+        expect(result.voteIds).toHaveLength(2);
+        expect(relationsOfType(result.ops, RANK_VOTES_RELATION_TYPE)).toHaveLength(2);
+    });
+    it('links the rank to a Ranking Block when blockId is provided', () => {
+        const result = create({
+            name: 'Block-linked rank',
+            rankType: 'ORDINAL',
+            blockId: BLOCK_ID,
+            votes: [{ entityId: MOVIE_1, spaceId: SPACE_ID }],
+        });
+        expect(relationsOfType(result.ops, RANK_BLOCK_RELATION_TYPE)).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=ranks.test.js.map

package/dist/src/ops/ranks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranks.test.js","sourceRoot":"","sources":["../../../src/ops/ranks.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AACnD,MAAM,OAAO,GAAG,kCAAkC,CAAC;AACnD,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AACpD,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAEpD,SAAS,eAAe,CAAC,GAA4B,EAAE,MAAc;IACnE,OAAO,GAAG,CAAC,MAAM,CACf,CAAC,EAAE,EAAwB,EAAE,CAC3B,EAAE,CAAC,IAAI,KAAK,gBAAgB;QAC3B,EAAqB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAC9F,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE;gBACL,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;gBACxC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE;aACzC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/personal-space/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const EDITS_PUBLISHED: `0x${string}`;
-export declare const TOPIC_SET: `0x${string}`;
+export declare const TOPIC_DECLARED: `0x${string}`;
 export declare const EMPTY_TOPIC: "0x0000000000000000000000000000000000000000000000000000000000000000";
 export declare const EMPTY_SIGNATURE: "0x";
 //# sourceMappingURL=constants.d.ts.map

package/dist/src/personal-space/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/personal-space/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,eAAiD,CAAC;AAC9E,eAAO,MAAM,SAAS,eAA2C,CAAC;AAClE,eAAO,MAAM,WAAW,EAAG,oEAA6E,CAAC;AACzG,eAAO,MAAM,eAAe,EAAG,IAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/personal-space/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,eAAiD,CAAC;AAC9E,eAAO,MAAM,cAAc,eAAgD,CAAC;AAC5E,eAAO,MAAM,WAAW,EAAG,oEAA6E,CAAC;AACzG,eAAO,MAAM,eAAe,EAAG,IAAa,CAAC"}

package/dist/src/personal-space/constants.js

@@ -1,6 +1,6 @@
 import { keccak256, toHex } from 'viem';
 export const EDITS_PUBLISHED = keccak256(toHex('GOVERNANCE.EDITS_PUBLISHED'));
-export const TOPIC_SET = keccak256(toHex('GOVERNANCE.TOPIC_SET'));
+export const TOPIC_DECLARED = keccak256(toHex('GOVERNANCE.TOPIC_DECLARED'));
 export const EMPTY_TOPIC = '0x0000000000000000000000000000000000000000000000000000000000000000';
 export const EMPTY_SIGNATURE = '0x';
 //# sourceMappingURL=constants.js.map

package/dist/src/personal-space/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/personal-space/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG,oEAA6E,CAAC;AACzG,MAAM,CAAC,MAAM,eAAe,GAAG,IAAa,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/personal-space/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,oEAA6E,CAAC;AACzG,MAAM,CAAC,MAAM,eAAe,GAAG,IAAa,CAAC"}

package/dist/src/personal-space/create-space.d.ts

@@ -1,8 +1,8 @@
-import type { CreateSpaceParams, CreateSpaceResult } from './types.js';
+import type { CreateSpaceResult } from './types.js';
 /**
  * Get the target address and calldata for creating a personal space.
  *
  * @deprecated Use `createGeoClient({ network }).personalSpaces.create(...)`.
  */
-export declare function createSpace({ network }?: CreateSpaceParams): CreateSpaceResult;
+export declare function createSpace(): CreateSpaceResult;
 //# sourceMappingURL=create-space.d.ts.map

package/dist/src/personal-space/create-space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-space.d.ts","sourceRoot":"","sources":["../../../src/personal-space/create-space.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAmB,EAAE,GAAE,iBAAsB,GAAG,iBAAiB,CAO9F"}
+{"version":3,"file":"create-space.d.ts","sourceRoot":"","sources":["../../../src/personal-space/create-space.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CAK/C"}

package/dist/src/personal-space/create-space.js

@@ -1,14 +1,13 @@
+import { TESTNET } from '../../contracts.js';
 import { getCreatePersonalSpaceCalldata } from '../encodings/index.js';
-import { requireGeoContract, resolveGeoNetwork } from '../networks.js';
 /**
  * Get the target address and calldata for creating a personal space.
  *
  * @deprecated Use `createGeoClient({ network }).personalSpaces.create(...)`.
  */
-export function createSpace({ network = 'TESTNET' } = {}) {
-    const config = resolveGeoNetwork(network);
+export function createSpace() {
     return {
-        to: requireGeoContract(config, 'SPACE_REGISTRY_ADDRESS'),
+        to: TESTNET.SPACE_REGISTRY_ADDRESS,
         calldata: getCreatePersonalSpaceCalldata(),
     };
 }

package/dist/src/personal-space/create-space.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-space.js","sourceRoot":"","sources":["../../../src/personal-space/create-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGvE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,KAAwB,EAAE;IACzE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE1C,OAAO;QACL,EAAE,EAAE,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,CAAC;QACxD,QAAQ,EAAE,8BAA8B,EAAE;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-space.js","sourceRoot":"","sources":["../../../src/personal-space/create-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAGvE;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,sBAAsB;QAClC,QAAQ,EAAE,8BAA8B,EAAE;KAC3C,CAAC;AACJ,CAAC"}

package/dist/src/personal-space/types.d.ts

@@ -1,9 +1,6 @@
 import type { Op } from '@geoprotocol/grc-20';
 import type { Id } from '../id.js';
-import type { Network, Networkish } from '../types.js';
-export type CreateSpaceParams = {
-    network?: Networkish;
-};
+import type { Network } from '../types.js';
 export type CreateSpaceResult = {
     to: `0x${string}`;
     calldata: `0x${string}`;

package/dist/src/personal-space/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/personal-space/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,EAAE,EAAE,CAAC;IACV,sCAAsC;IACtC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,EAAE,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/personal-space/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,EAAE,EAAE,CAAC;IACV,sCAAsC;IACtC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,EAAE,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;CACzB,CAAC"}

package/dist/src/ranks/create-rank.d.ts

@@ -4,8 +4,17 @@ import type { CreateRankParams, CreateRankResult } from './types.js';
  * All IDs passed to this function are validated. If any invalid ID is provided,
  * the function will throw an error.
  *
- * For ORDINAL ranks, the position is derived from the array order and fractional
- * indexing strings are generated internally.
+ * Each vote must carry a `spaceId` that scopes the ranked entity to a space
+ * perspective (set as `to_space_id` on the vote relation). A rank may therefore
+ * include the same entity across multiple spaces; item uniqueness is keyed on
+ * `(entityId, spaceId)`.
+ *
+ * A fractional index is generated from the array order and set as each vote
+ * relation's `position`, so clients can order votes natively. For ORDINAL ranks
+ * the same fractional index is stored on the reified vote entity.
+ *
+ * When `blockId` is provided, a `Rank → Ranking Block` relation is emitted to
+ * associate the rank with a ranking block. The link may also be added later.
  *
  * @example
  * ```ts
@@ -15,10 +24,11 @@ import type { CreateRankParams, CreateRankResult } from './types.js';
  *   name: 'My Favorite Movies',
  *   description: 'A ranked list of my favorite movies', // optional
  *   rankType: 'ORDINAL',
+ *   blockId, // optional, links the rank to a Ranking Block
  *   votes: [
- *     { entityId: movie1Id },  // 1st place
- *     { entityId: movie2Id },  // 2nd place
- *     { entityId: movie3Id },  // 3rd place
+ *     { entityId: movie1Id, spaceId },  // 1st place
+ *     { entityId: movie2Id, spaceId },  // 2nd place
+ *     { entityId: movie3Id, spaceId },  // 3rd place
  *   ],
  * });
  *
@@ -27,8 +37,8 @@ import type { CreateRankParams, CreateRankResult } from './types.js';
  *   name: 'Restaurant Ratings',
  *   rankType: 'WEIGHTED',
  *   votes: [
- *     { entityId: restaurant1Id, value: 4.5 },  // numeric score
- *     { entityId: restaurant2Id, value: 3.8 },
+ *     { entityId: restaurant1Id, spaceId, value: 4.5 },  // numeric score
+ *     { entityId: restaurant2Id, spaceId, value: 3.8 },
  *   ],
  * });
  * ```
@@ -36,7 +46,7 @@ import type { CreateRankParams, CreateRankResult } from './types.js';
  * @param params – {@link CreateRankParams}
  * @returns – {@link CreateRankResult}
  * @throws Will throw an error if any provided ID is invalid
- * @throws Will throw an error if any entityId is duplicated in votes
+ * @throws Will throw an error if any `(entityId, spaceId)` pair is duplicated in votes
  */
-export declare const createRank: ({ id: providedId, name, description, rankType, votes, }: CreateRankParams) => CreateRankResult;
+export declare const createRank: ({ id: providedId, name, description, rankType, blockId, votes, }: CreateRankParams) => CreateRankResult;
 //# sourceMappingURL=create-rank.d.ts.map

package/dist/src/ranks/create-rank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-rank.d.ts","sourceRoot":"","sources":["../../../src/ranks/create-rank.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,UAAU,GAAI,yDAMxB,gBAAgB,KAAG,gBA0HrB,CAAC"}
+{"version":3,"file":"create-rank.d.ts","sourceRoot":"","sources":["../../../src/ranks/create-rank.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,UAAU,GAAI,kEAOxB,gBAAgB,KAAG,gBAiFrB,CAAC"}

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

@@ -1,15 +1,24 @@
 import { createEntity as grcCreateEntity, createRelation as grcCreateRelation, languages, } from '@geoprotocol/grc-20';
-import { generateNJitteredKeysBetween } from 'fractional-indexing-jittered';
-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 { DESCRIPTION_PROPERTY, NAME_PROPERTY, RANK_BLOCK_RELATION_TYPE, RANK_TYPE, RANK_TYPE_PROPERTY, TYPES_PROPERTY, } from '../core/ids/system.js';
 import { Id } from '../id.js';
 import { assertValid, generate, toGrcId } from '../id-utils.js';
+import { buildVoteOps, validateVotes } from './vote-ops.js';
 /**
  * Creates a rank entity with the given name, description, rankType, and votes.
  * All IDs passed to this function are validated. If any invalid ID is provided,
  * the function will throw an error.
  *
- * For ORDINAL ranks, the position is derived from the array order and fractional
- * indexing strings are generated internally.
+ * Each vote must carry a `spaceId` that scopes the ranked entity to a space
+ * perspective (set as `to_space_id` on the vote relation). A rank may therefore
+ * include the same entity across multiple spaces; item uniqueness is keyed on
+ * `(entityId, spaceId)`.
+ *
+ * A fractional index is generated from the array order and set as each vote
+ * relation's `position`, so clients can order votes natively. For ORDINAL ranks
+ * the same fractional index is stored on the reified vote entity.
+ *
+ * When `blockId` is provided, a `Rank → Ranking Block` relation is emitted to
+ * associate the rank with a ranking block. The link may also be added later.
  *
  * @example
  * ```ts
@@ -19,10 +28,11 @@ import { assertValid, generate, toGrcId } from '../id-utils.js';
  *   name: 'My Favorite Movies',
  *   description: 'A ranked list of my favorite movies', // optional
  *   rankType: 'ORDINAL',
+ *   blockId, // optional, links the rank to a Ranking Block
  *   votes: [
- *     { entityId: movie1Id },  // 1st place
- *     { entityId: movie2Id },  // 2nd place
- *     { entityId: movie3Id },  // 3rd place
+ *     { entityId: movie1Id, spaceId },  // 1st place
+ *     { entityId: movie2Id, spaceId },  // 2nd place
+ *     { entityId: movie3Id, spaceId },  // 3rd place
  *   ],
  * });
  *
@@ -31,8 +41,8 @@ import { assertValid, generate, toGrcId } from '../id-utils.js';
  *   name: 'Restaurant Ratings',
  *   rankType: 'WEIGHTED',
  *   votes: [
- *     { entityId: restaurant1Id, value: 4.5 },  // numeric score
- *     { entityId: restaurant2Id, value: 3.8 },
+ *     { entityId: restaurant1Id, spaceId, value: 4.5 },  // numeric score
+ *     { entityId: restaurant2Id, spaceId, value: 3.8 },
  *   ],
  * });
  * ```
@@ -40,28 +50,19 @@ import { assertValid, generate, toGrcId } from '../id-utils.js';
  * @param params – {@link CreateRankParams}
  * @returns – {@link CreateRankResult}
  * @throws Will throw an error if any provided ID is invalid
- * @throws Will throw an error if any entityId is duplicated in votes
+ * @throws Will throw an error if any `(entityId, spaceId)` pair is duplicated in votes
  */
-export const createRank = ({ id: providedId, name, description, rankType, votes, }) => {
+export const createRank = ({ id: providedId, name, description, rankType, blockId, votes, }) => {
     // Validate all input IDs
     if (providedId) {
         assertValid(providedId, '`id` in `createRank`');
     }
-    for (const vote of votes) {
-        assertValid(vote.entityId, '`entityId` in `votes` in `createRank`');
-    }
-    // Validate no duplicate entity IDs in votes
-    const seenEntityIds = new Set();
-    for (const vote of votes) {
-        const entityId = String(vote.entityId);
-        if (seenEntityIds.has(entityId)) {
-            throw new Error(`Duplicate entityId in votes: "${entityId}". Each entity can only be voted once per rank.`);
-        }
-        seenEntityIds.add(entityId);
+    if (blockId) {
+        assertValid(blockId, '`blockId` in `createRank`');
     }
+    validateVotes(votes, rankType, 'createRank');
     const id = providedId ?? generate();
     const ops = [];
-    const voteIds = [];
     // Create rank entity values
     const rankValues = [
         {
@@ -104,43 +105,19 @@ export const createRank = ({ id: providedId, name, description, rankType, votes,
         to: toGrcId(RANK_TYPE),
         relationType: toGrcId(TYPES_PROPERTY),
     }));
-    // Generate fractional indices for ordinal ranks
-    const fractionalIndices = rankType === 'ORDINAL' ? generateNJitteredKeysBetween(null, null, votes.length) : [];
-    // Create votes
-    votes.forEach((vote, i) => {
-        const voteEntityId = generate();
-        const relationId = generate();
-        voteIds.push(voteEntityId);
-        // Create relation from rank to voted entity
+    // Optionally link the rank to its Ranking Block
+    if (blockId) {
         ops.push(grcCreateRelation({
-            id: toGrcId(relationId),
-            entity: toGrcId(voteEntityId),
+            id: toGrcId(generate()),
+            entity: toGrcId(generate()),
             from: toGrcId(id),
-            to: toGrcId(vote.entityId),
-            relationType: toGrcId(RANK_VOTES_RELATION_TYPE),
+            to: toGrcId(blockId),
+            relationType: toGrcId(RANK_BLOCK_RELATION_TYPE),
         }));
-        // Create vote entity with the appropriate value property
-        const voteValue = rankType === 'ORDINAL'
-            ? {
-                property: toGrcId(VOTE_ORDINAL_VALUE_PROPERTY),
-                value: {
-                    type: 'text',
-                    value: fractionalIndices[i],
-                    language: languages.english(),
-                },
-            }
-            : {
-                property: toGrcId(VOTE_WEIGHTED_VALUE_PROPERTY),
-                value: {
-                    type: 'float',
-                    value: vote.value,
-                },
-            };
-        ops.push(grcCreateEntity({
-            id: toGrcId(voteEntityId),
-            values: [voteValue],
-        }));
-    });
+    }
+    // Create vote relations + reified vote entities
+    const { ops: voteOps, voteIds } = buildVoteOps(id, rankType, votes);
+    ops.push(...voteOps);
     return { id: Id(id), ops, voteIds };
 };
 //# sourceMappingURL=create-rank.js.map

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

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