@geoprotocol/geo-sdk 0.16.0 → 0.18.0

package/dist/src/graph/comment-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Strips markdown syntax and returns the first 20 characters for use as the comment name.
+ */
+export declare function deriveCommentName(content: string): string;
+//# sourceMappingURL=comment-utils.d.ts.map

package/dist/src/graph/comment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-utils.d.ts","sourceRoot":"","sources":["../../../src/graph/comment-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBzD"}

package/dist/src/graph/comment-utils.js

@@ -0,0 +1,23 @@
+/**
+ * Strips markdown syntax and returns the first 20 characters for use as the comment name.
+ */
+export function deriveCommentName(content) {
+    const stripped = content
+        .replace(/^#{1,6}\s+/gm, '') // headings
+        .replace(/\*\*(.+?)\*\*/g, '$1') // bold
+        .replace(/\*(.+?)\*/g, '$1') // italic
+        .replace(/__(.+?)__/g, '$1') // bold (underscore)
+        .replace(/_(.+?)_/g, '$1') // italic (underscore)
+        .replace(/~~(.+?)~~/g, '$1') // strikethrough
+        .replace(/`(.+?)`/g, '$1') // inline code
+        .replace(/\[(.+?)\]\(.+?\)/g, '$1') // links
+        .replace(/!\[.*?\]\(.+?\)/g, '') // images
+        .replace(/^>\s+/gm, '') // blockquotes
+        .replace(/^[-*+]\s+/gm, '') // unordered lists
+        .replace(/^\d+\.\s+/gm, '') // ordered lists
+        .replace(/---/g, '') // horizontal rules
+        .replace(/\n+/g, ' ') // newlines to spaces
+        .trim();
+    return stripped.slice(0, 20);
+}
+//# sourceMappingURL=comment-utils.js.map

package/dist/src/graph/comment-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-utils.js","sourceRoot":"","sources":["../../../src/graph/comment-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW;SACvC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,OAAO;SACvC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,SAAS;SACrC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,oBAAoB;SAChD,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,sBAAsB;SAChD,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,gBAAgB;SAC5C,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,cAAc;SACxC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,QAAQ;SAC3C,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,SAAS;SACzC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,cAAc;SACrC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,kBAAkB;SAC7C,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,gBAAgB;SAC3C,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,mBAAmB;SACvC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,qBAAqB;SAC1C,IAAI,EAAE,CAAC;IAEV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/graph/create-comment.d.ts

@@ -0,0 +1,28 @@
+import type { CreateCommentParams, CreateResult } from '../types.js';
+/**
+ * Creates a comment entity. Content can be plain text or markdown.
+ *
+ * When replying to a root entity (no existing reply-to relations), creates 1 reply-to relation.
+ * When replying to a comment that has already been published on the Knowledge Graph, carries
+ * forward all of the parent's reply-to relations and adds the parent itself, accumulating the
+ * full ancestor chain at any depth. The parent comment must be published before creating a
+ * reply so that its reply-to relations can be fetched. Reply-to relations are ordered by
+ * position: the direct parent comment has the lowest position and the root entity has the
+ * highest.
+ *
+ * @example
+ * ```ts
+ * import { Graph } from '@geoprotocol/geo-sdk';
+ *
+ * const { id, ops } = await Graph.createComment({
+ *   content: 'I agree with this.',
+ *   replyTo: { entityId: someId, spaceId: spaceId },
+ *   resolved: false, // optional, defaults to false
+ * });
+ * ```
+ *
+ * @param params – {@link CreateCommentParams}
+ * @returns – {@link CreateResult}
+ */
+export declare const createComment: ({ id: providedId, content, replyTo, resolved, network, }: CreateCommentParams) => Promise<CreateResult>;
+//# sourceMappingURL=create-comment.d.ts.map

package/dist/src/graph/create-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../../src/graph/create-comment.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAW,MAAM,aAAa,CAAC;AAwE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa,GAAU,0DAMjC,mBAAmB,KAAG,OAAO,CAAC,YAAY,CAsE5C,CAAC"}

package/dist/src/graph/create-comment.js

@@ -0,0 +1,142 @@
+import { Micro } from 'effect';
+import { COMMENT_TYPE } from '../core/ids/content.js';
+import { MARKDOWN_CONTENT, REPLY_TO_PROPERTY, RESOLVED_PROPERTY } from '../core/ids/system.js';
+import { generateBetween } from '../core/position.js';
+import { Id } from '../id.js';
+import { assertValid, generate } from '../id-utils.js';
+import { deriveCommentName } from './comment-utils.js';
+import { getApiOrigin } from './constants.js';
+import { createEntity } from './create-entity.js';
+class CreateCommentError extends Error {
+    _tag = 'CreateCommentError';
+}
+async function fetchReplyToRelations(entityId, network) {
+    const query = `query entity {
+    entity(id: "${entityId}") {
+      relationsList(filter: { typeId: { in: ["${REPLY_TO_PROPERTY}"] } }) {
+        toEntity { id }
+        toSpace { id }
+        position
+      }
+    }
+  }`;
+    const fetchData = Micro.gen(function* () {
+        const result = yield* Micro.tryPromise({
+            try: () => fetch(`${getApiOrigin(network)}/graphql`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ query }),
+            }),
+            catch: error => new CreateCommentError(`Could not fetch entity data for ${entityId}: ${error}`),
+        });
+        const json = yield* Micro.tryPromise({
+            try: () => result.json(),
+            catch: error => new CreateCommentError(`Could not parse GraphQL response for entity ${entityId}: ${error}`),
+        });
+        return json;
+    });
+    const response = await Micro.runPromise(fetchData);
+    if (!response.data?.entity) {
+        return [];
+    }
+    return response.data.entity.relationsList
+        .filter((r) => r.toSpace !== null)
+        .map(r => ({
+        entityId: r.toEntity.id,
+        spaceId: r.toSpace.id,
+        position: r.position,
+    }));
+}
+/**
+ * Creates a comment entity. Content can be plain text or markdown.
+ *
+ * When replying to a root entity (no existing reply-to relations), creates 1 reply-to relation.
+ * When replying to a comment that has already been published on the Knowledge Graph, carries
+ * forward all of the parent's reply-to relations and adds the parent itself, accumulating the
+ * full ancestor chain at any depth. The parent comment must be published before creating a
+ * reply so that its reply-to relations can be fetched. Reply-to relations are ordered by
+ * position: the direct parent comment has the lowest position and the root entity has the
+ * highest.
+ *
+ * @example
+ * ```ts
+ * import { Graph } from '@geoprotocol/geo-sdk';
+ *
+ * const { id, ops } = await Graph.createComment({
+ *   content: 'I agree with this.',
+ *   replyTo: { entityId: someId, spaceId: spaceId },
+ *   resolved: false, // optional, defaults to false
+ * });
+ * ```
+ *
+ * @param params – {@link CreateCommentParams}
+ * @returns – {@link CreateResult}
+ */
+export const createComment = async ({ id: providedId, content, replyTo, resolved = false, network = 'TESTNET', }) => {
+    if (providedId)
+        assertValid(providedId, '`id` in `createComment`');
+    assertValid(replyTo.entityId, '`replyTo.entityId` in `createComment`');
+    assertValid(replyTo.spaceId, '`replyTo.spaceId` in `createComment`');
+    const id = providedId ?? generate();
+    const name = deriveCommentName(content);
+    // Fetch existing reply-to relations from the target entity.
+    // If the target has no reply-to relations, it is a root entity — use it directly.
+    // If the target has reply-to relations, it is a comment — carry forward all
+    // of the parent's reply-tos and add the parent itself. This accumulates the
+    // full ancestor chain at any depth.
+    // Order: direct parent first (lowest position), root entity last (highest position).
+    const existingReplyTos = await fetchReplyToRelations(replyTo.entityId, network);
+    const orderedTargets = [];
+    if (existingReplyTos.length > 0) {
+        // Direct parent first
+        orderedTargets.push({ toEntity: replyTo.entityId, toSpace: replyTo.spaceId });
+        // Then the parent's reply-tos sorted by position ascending
+        // (parent's direct parent first, root entity last)
+        const sorted = [...existingReplyTos].sort((a, b) => {
+            if (a.position === null && b.position === null)
+                return 0;
+            if (a.position === null)
+                return 1;
+            if (b.position === null)
+                return -1;
+            return a.position.localeCompare(b.position);
+        });
+        for (const rt of sorted) {
+            orderedTargets.push({ toEntity: rt.entityId, toSpace: rt.spaceId });
+        }
+    }
+    else {
+        orderedTargets.push({ toEntity: replyTo.entityId, toSpace: replyTo.spaceId });
+    }
+    // Assign ascending positions: first target gets lowest, last gets highest
+    let lastPosition = null;
+    const replyToRelationEntries = [];
+    for (const target of orderedTargets) {
+        const position = generateBetween(lastPosition, null);
+        replyToRelationEntries.push({ ...target, position });
+        lastPosition = position;
+    }
+    const replyToRelations = {
+        [REPLY_TO_PROPERTY]: replyToRelationEntries,
+    };
+    const { ops } = createEntity({
+        id,
+        name,
+        types: [COMMENT_TYPE],
+        values: [
+            {
+                property: MARKDOWN_CONTENT,
+                type: 'text',
+                value: content,
+            },
+            {
+                property: RESOLVED_PROPERTY,
+                type: 'boolean',
+                value: resolved,
+            },
+        ],
+        relations: replyToRelations,
+    });
+    return { id: Id(id), ops };
+};
+//# sourceMappingURL=create-comment.js.map

package/dist/src/graph/create-comment.js.map

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

package/dist/src/graph/create-comment.test.d.ts

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

package/dist/src/graph/create-comment.test.d.ts.map

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

package/dist/src/graph/create-comment.test.js

@@ -0,0 +1,262 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { COMMENT_TYPE } from '../core/ids/content.js';
+import { MARKDOWN_CONTENT, NAME_PROPERTY, REPLY_TO_PROPERTY, RESOLVED_PROPERTY, TYPES_PROPERTY, } from '../core/ids/system.js';
+import { Id } from '../id.js';
+import { toGrcId } from '../id-utils.js';
+import { TESTNET_API_ORIGIN } from './constants.js';
+import { createComment } from './create-comment.js';
+const entityId = Id('3af3e22d21694a078681516710b7ecf1');
+const spaceId = Id('d4bc2f205e2d415e971eb0b9fbf6b6fc');
+const graphqlUrl = `${TESTNET_API_ORIGIN}/graphql`;
+function mockGraphQLResponse(relationsList = []) {
+    vi.spyOn(global, 'fetch').mockImplementation(url => {
+        if (url.toString() === graphqlUrl) {
+            return Promise.resolve({
+                status: 200,
+                json: () => Promise.resolve({
+                    data: {
+                        entity: { relationsList },
+                    },
+                }),
+            });
+        }
+        return vi.fn();
+    });
+}
+function mockRelation(toEntityId, toSpaceId, position = null) {
+    return {
+        toEntity: { id: toEntityId },
+        toSpace: { id: toSpaceId },
+        position,
+    };
+}
+describe('createComment', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('creates a basic comment on an entity', async () => {
+        mockGraphQLResponse();
+        const { id, ops } = await createComment({
+            content: 'Hello world',
+            replyTo: { entityId, spaceId },
+        });
+        expect(id).toBeDefined();
+        expect(typeof id).toBe('string');
+        expect(ops.length).toBeGreaterThanOrEqual(3);
+        // createEntity op
+        const entityOp = ops[0];
+        expect(entityOp.type).toBe('createEntity');
+        expect(entityOp.id).toEqual(toGrcId(id));
+        // Verify name value
+        const nameValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(NAME_PROPERTY)[i]);
+        });
+        expect(nameValue).toBeDefined();
+        expect(nameValue?.value.type).toBe('text');
+        if (nameValue?.value.type === 'text') {
+            expect(nameValue.value.value).toBe('Hello world');
+        }
+        // Verify markdown content value
+        const markdownValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(MARKDOWN_CONTENT)[i]);
+        });
+        expect(markdownValue).toBeDefined();
+        expect(markdownValue?.value.type).toBe('text');
+        if (markdownValue?.value.type === 'text') {
+            expect(markdownValue.value.value).toBe('Hello world');
+        }
+        // Type relation to COMMENT_TYPE
+        const typeRel = ops.find(op => op.type === 'createRelation' &&
+            op.relationType.every((b, i) => b === toGrcId(TYPES_PROPERTY)[i]));
+        expect(typeRel).toBeDefined();
+        expect(typeRel.from).toEqual(toGrcId(id));
+        expect(typeRel.to).toEqual(toGrcId(COMMENT_TYPE));
+        // Reply-to relation (only 1 — the root entity)
+        const replyRels = ops.filter(op => op.type === 'createRelation' &&
+            op.relationType.every((b, i) => b === toGrcId(REPLY_TO_PROPERTY)[i]));
+        expect(replyRels).toHaveLength(1);
+        expect(replyRels[0]?.to).toEqual(toGrcId(entityId));
+        expect(replyRels[0]?.toSpace).toEqual(toGrcId(spaceId));
+    });
+    it('orders reply-tos: direct parent first, root entity last', async () => {
+        const rootEntityId = 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
+        const rootSpaceId = 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb';
+        // Target is a comment with 1 reply-to (the root entity)
+        mockGraphQLResponse([mockRelation(rootEntityId, rootSpaceId, 'a0')]);
+        const { ops } = await createComment({
+            content: 'Reply',
+            replyTo: { entityId, spaceId },
+        });
+        const replyRels = ops.filter(op => op.type === 'createRelation' &&
+            op.relationType.every((b, i) => b === toGrcId(REPLY_TO_PROPERTY)[i]));
+        expect(replyRels).toHaveLength(2);
+        const parentReply = replyRels.find(r => r.to.every((b, i) => b === toGrcId(entityId)[i]));
+        const rootReply = replyRels.find(r => r.to.every((b, i) => b === toGrcId(rootEntityId)[i]));
+        expect(parentReply).toBeDefined();
+        expect(rootReply).toBeDefined();
+        expect(parentReply?.toSpace).toEqual(toGrcId(spaceId));
+        expect(rootReply?.toSpace).toEqual(toGrcId(rootSpaceId));
+        expect(parentReply?.position).toBeDefined();
+        expect(rootReply?.position).toBeDefined();
+        // Direct parent should have lower position than root entity
+        expect(parentReply.position.localeCompare(rootReply.position)).toBeLessThan(0);
+        // Emission order must also be parent → root
+        expect(replyRels[0]?.to).toEqual(toGrcId(entityId));
+        expect(replyRels[1]?.to).toEqual(toGrcId(rootEntityId));
+    });
+    it('orders reply-tos correctly at depth 3', async () => {
+        const rootEntityId = 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
+        const rootSpaceId = 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb';
+        const commentAId = 'cccccccccccccccccccccccccccccccc';
+        const commentASpaceId = 'dddddddddddddddddddddddddddddddd';
+        // Target is Comment B with 2 reply-tos ordered: [CommentA (a0), RootEntity (a1)]
+        mockGraphQLResponse([
+            mockRelation(commentAId, commentASpaceId, 'a0'),
+            mockRelation(rootEntityId, rootSpaceId, 'a1'),
+        ]);
+        const { ops } = await createComment({
+            content: 'Deep reply',
+            replyTo: { entityId, spaceId },
+        });
+        const replyRels = ops.filter(op => op.type === 'createRelation' &&
+            op.relationType.every((b, i) => b === toGrcId(REPLY_TO_PROPERTY)[i]));
+        expect(replyRels).toHaveLength(3);
+        const parentReply = replyRels.find(r => r.to.every((b, i) => b === toGrcId(entityId)[i]));
+        const commentAReply = replyRels.find(r => r.to.every((b, i) => b === toGrcId(commentAId)[i]));
+        const rootReply = replyRels.find(r => r.to.every((b, i) => b === toGrcId(rootEntityId)[i]));
+        expect(parentReply).toBeDefined();
+        expect(commentAReply).toBeDefined();
+        expect(rootReply).toBeDefined();
+        expect(parentReply?.toSpace).toEqual(toGrcId(spaceId));
+        expect(commentAReply?.toSpace).toEqual(toGrcId(commentASpaceId));
+        expect(rootReply?.toSpace).toEqual(toGrcId(rootSpaceId));
+        expect(parentReply?.position).toBeDefined();
+        expect(commentAReply?.position).toBeDefined();
+        expect(rootReply?.position).toBeDefined();
+        // Order: direct parent < commentA < root entity
+        expect(parentReply.position.localeCompare(commentAReply.position)).toBeLessThan(0);
+        expect(commentAReply.position.localeCompare(rootReply.position)).toBeLessThan(0);
+        // Emission order must also be parent → commentA → root
+        expect(replyRels[0]?.to).toEqual(toGrcId(entityId));
+        expect(replyRels[1]?.to).toEqual(toGrcId(commentAId));
+        expect(replyRels[2]?.to).toEqual(toGrcId(rootEntityId));
+    });
+    it('sets resolved to false by default', async () => {
+        mockGraphQLResponse();
+        const { ops } = await createComment({
+            content: 'Test',
+            replyTo: { entityId, spaceId },
+        });
+        const entityOp = ops[0];
+        const resolvedValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(RESOLVED_PROPERTY)[i]);
+        });
+        expect(resolvedValue).toBeDefined();
+        expect(resolvedValue?.value.type).toBe('boolean');
+        if (resolvedValue?.value.type === 'boolean') {
+            expect(resolvedValue.value.value).toBe(false);
+        }
+    });
+    it('sets resolved to true when specified', async () => {
+        mockGraphQLResponse();
+        const { ops } = await createComment({
+            content: 'Test',
+            replyTo: { entityId, spaceId },
+            resolved: true,
+        });
+        const entityOp = ops[0];
+        const resolvedValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(RESOLVED_PROPERTY)[i]);
+        });
+        expect(resolvedValue).toBeDefined();
+        expect(resolvedValue?.value.type).toBe('boolean');
+        if (resolvedValue?.value.type === 'boolean') {
+            expect(resolvedValue.value.value).toBe(true);
+        }
+    });
+    it('strips markdown from name and truncates to 20 chars', async () => {
+        mockGraphQLResponse();
+        const { ops } = await createComment({
+            content: '## Lorem ipsum dolor sit amet, consectetur adipiscing',
+            replyTo: { entityId, spaceId },
+        });
+        const entityOp = ops[0];
+        const nameValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(NAME_PROPERTY)[i]);
+        });
+        expect(nameValue).toBeDefined();
+        expect(nameValue?.value.type).toBe('text');
+        if (nameValue?.value.type === 'text') {
+            expect(nameValue.value.value).toBe('Lorem ipsum dolor si');
+        }
+    });
+    it('strips heading markdown from name', async () => {
+        mockGraphQLResponse();
+        const { ops } = await createComment({
+            content: '## Hello World',
+            replyTo: { entityId, spaceId },
+        });
+        const entityOp = ops[0];
+        const nameValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(NAME_PROPERTY)[i]);
+        });
+        expect(nameValue).toBeDefined();
+        if (nameValue?.value.type === 'text') {
+            expect(nameValue.value.value).toBe('Hello World');
+        }
+    });
+    it('handles entity not found in API', async () => {
+        vi.spyOn(global, 'fetch').mockImplementation(url => {
+            if (url.toString() === graphqlUrl) {
+                return Promise.resolve({
+                    status: 200,
+                    json: () => Promise.resolve({ data: { entity: null } }),
+                });
+            }
+            return vi.fn();
+        });
+        const { ops } = await createComment({
+            content: 'Comment on missing entity',
+            replyTo: { entityId, spaceId },
+        });
+        const replyRels = ops.filter(op => op.type === 'createRelation' &&
+            op.relationType.every((b, i) => b === toGrcId(REPLY_TO_PROPERTY)[i]));
+        expect(replyRels).toHaveLength(1);
+    });
+    it('uses provided id when given', async () => {
+        mockGraphQLResponse();
+        const customId = Id('aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa');
+        const { id } = await createComment({
+            id: customId,
+            content: 'Test',
+            replyTo: { entityId, spaceId },
+        });
+        expect(id).toBe(customId);
+    });
+    it('throws for invalid replyTo entityId', async () => {
+        await expect(createComment({
+            content: 'Test',
+            replyTo: { entityId: 'invalid', spaceId },
+        })).rejects.toThrow('Invalid id: "invalid" for `replyTo.entityId` in `createComment`');
+    });
+    it('throws for invalid replyTo spaceId', async () => {
+        await expect(createComment({
+            content: 'Test',
+            replyTo: { entityId, spaceId: 'invalid' },
+        })).rejects.toThrow('Invalid id: "invalid" for `replyTo.spaceId` in `createComment`');
+    });
+    it('throws for invalid provided id', async () => {
+        await expect(createComment({
+            id: 'invalid',
+            content: 'Test',
+            replyTo: { entityId, spaceId },
+        })).rejects.toThrow('Invalid id: "invalid" for `id` in `createComment`');
+    });
+});
+//# sourceMappingURL=create-comment.test.js.map

package/dist/src/graph/create-comment.test.js.map

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

package/dist/src/graph/create-proposal-review.d.ts

@@ -0,0 +1,32 @@
+import type { CreateProposalReviewParams, CreateResult } from '../types.js';
+/**
+ * Creates a proposal review entity with a pass/fail status and optional star ratings.
+ * For low-difficulty bounties, only `pass` is required. For medium/hard bounties,
+ * `completeness`, `accuracy`, `skill`, and `effort` ratings must also be provided.
+ *
+ * @example
+ * ```ts
+ * import { Graph } from '@geoprotocol/geo-sdk';
+ *
+ * // Low-difficulty bounty review (pass only)
+ * const { id, ops } = Graph.createProposalReview({
+ *   proposal: { id: proposalId, name: 'Proposal name' },
+ *   pass: true,
+ * });
+ *
+ * // Medium/hard bounty review (with ratings)
+ * const { id, ops } = Graph.createProposalReview({
+ *   proposal: { id: proposalId, name: 'Proposal name' },
+ *   pass: true,
+ *   completeness: 0.8,
+ *   accuracy: 1,
+ *   skill: 0.6,
+ *   effort: 0.8,
+ * });
+ * ```
+ *
+ * @param params – {@link CreateProposalReviewParams}
+ * @returns – {@link CreateResult}
+ */
+export declare const createProposalReview: (params: CreateProposalReviewParams) => CreateResult;
+//# sourceMappingURL=create-proposal-review.d.ts.map

package/dist/src/graph/create-proposal-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-proposal-review.d.ts","sourceRoot":"","sources":["../../../src/graph/create-proposal-review.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,0BAA0B,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAG7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,0BAA0B,KAAG,YAoCzE,CAAC"}

package/dist/src/graph/create-proposal-review.js

@@ -0,0 +1,62 @@
+import { ACCURACY_RATING_PROPERTY, BOUNTY_REVIEW_TYPE, COMPLETENESS_RATING_PROPERTY, EFFORT_RATING_PROPERTY, PASS_PROPERTY, PROPOSALS_PROPERTY, SKILL_RATING_PROPERTY, } from '../core/ids/system.js';
+import { Id } from '../id.js';
+import { assertValid, generate } from '../id-utils.js';
+import { createEntity } from './create-entity.js';
+/**
+ * Creates a proposal review entity with a pass/fail status and optional star ratings.
+ * For low-difficulty bounties, only `pass` is required. For medium/hard bounties,
+ * `completeness`, `accuracy`, `skill`, and `effort` ratings must also be provided.
+ *
+ * @example
+ * ```ts
+ * import { Graph } from '@geoprotocol/geo-sdk';
+ *
+ * // Low-difficulty bounty review (pass only)
+ * const { id, ops } = Graph.createProposalReview({
+ *   proposal: { id: proposalId, name: 'Proposal name' },
+ *   pass: true,
+ * });
+ *
+ * // Medium/hard bounty review (with ratings)
+ * const { id, ops } = Graph.createProposalReview({
+ *   proposal: { id: proposalId, name: 'Proposal name' },
+ *   pass: true,
+ *   completeness: 0.8,
+ *   accuracy: 1,
+ *   skill: 0.6,
+ *   effort: 0.8,
+ * });
+ * ```
+ *
+ * @param params – {@link CreateProposalReviewParams}
+ * @returns – {@link CreateResult}
+ */
+export const createProposalReview = (params) => {
+    if (params.id)
+        assertValid(params.id, '`id` in `createProposalReview`');
+    assertValid(params.proposal.id, '`proposal.id` in `createProposalReview`');
+    const id = params.id ?? generate();
+    const values = [
+        {
+            property: PASS_PROPERTY,
+            type: 'boolean',
+            value: params.pass,
+        },
+    ];
+    if ('completeness' in params) {
+        values.push({ property: COMPLETENESS_RATING_PROPERTY, type: 'float', value: params.completeness }, { property: ACCURACY_RATING_PROPERTY, type: 'float', value: params.accuracy }, { property: SKILL_RATING_PROPERTY, type: 'float', value: params.skill }, { property: EFFORT_RATING_PROPERTY, type: 'float', value: params.effort });
+    }
+    const { ops } = createEntity({
+        id,
+        name: params.proposal.name,
+        types: [BOUNTY_REVIEW_TYPE],
+        values,
+        relations: {
+            [PROPOSALS_PROPERTY]: {
+                toEntity: params.proposal.id,
+            },
+        },
+    });
+    return { id: Id(id), ops };
+};
+//# sourceMappingURL=create-proposal-review.js.map

package/dist/src/graph/create-proposal-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-proposal-review.js","sourceRoot":"","sources":["../../../src/graph/create-proposal-review.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAkC,EAAgB,EAAE;IACvF,IAAI,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,gCAAgC,CAAC,CAAC;IACxE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,yCAAyC,CAAC,CAAC;IAE3E,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAoB;QAC9B;YACE,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM,CAAC,IAAI;SACnB;KACF,CAAC;IAEF,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,EAAE,QAAQ,EAAE,4BAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,EACrF,EAAE,QAAQ,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,EAC7E,EAAE,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EACvE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC;QAC3B,EAAE;QACF,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QAC1B,KAAK,EAAE,CAAC,kBAAkB,CAAC;QAC3B,MAAM;QACN,SAAS,EAAE;YACT,CAAC,kBAAkB,CAAC,EAAE;gBACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;aAC7B;SACF;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AAC7B,CAAC,CAAC"}

package/dist/src/graph/create-proposal-review.test.d.ts

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

package/dist/src/graph/create-proposal-review.test.d.ts.map

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