@graphprotocol/grc-20 0.25.1 → 0.25.3

package/dist/src/graphv2/create-entity.js

@@ -0,0 +1,140 @@
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY, TYPES_PROPERTY } from '../core/idsv2/system.js';
+import { Id, assertValid, generate, toBase64 } from '../idv2.js';
+import { createRelation } from './create-relation.js';
+/**
+ * Creates an entity with the given name, description, cover, properties, and types.
+ * All IDs passed to this function (cover, types, property IDs, relation IDs, etc.) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createEntity({
+ *   id: entityId, // optional and will be generated if not provided
+ *   name: 'name of the entity',
+ *   description: 'description of the entity',
+ *   cover: imageEntityId,
+ *   types: [typeEntityId1, typeEntityId2],
+ *   values: {
+ *     // value property like text, number, url, time, point, checkbox
+ *     [propertyId]: {
+ *       value: 'value of the property',
+ *     }
+ *   },
+ *   relations: {
+ *     [relationId]: {
+ *       to: 'id of the entity',
+ *       id: 'id of the relation', // optional
+ *       toSpace: 'id of the to space', // optional
+ *       position: positionString, // optional
+ *       entityId: 'id of the relation entity', // optional and will be generated if not provided
+ *       entityName: 'name of the relation entity', // optional
+ *       entityDescription: 'description of the relation entity', // optional
+ *       entityCover: 'id of the cover', // optional
+ *       entityValues: { // optional values for the relation entity
+ *         [propertyId]: {
+ *           value: 'value of the property',
+ *         },
+ *       },
+ *       entityRelations: {
+ *         [relationId]: {
+ *           to: 'id of the entity',
+ *           id: 'id of the relation', // optional
+ *           position: positionString, // optional
+ *         },
+ *       },
+ *     },
+ *   },
+ * });
+ * ```
+ * @param params – {@link EntityParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export const createEntity = ({ id: providedId, name, description, cover, values, relations, types, }) => {
+    if (providedId) {
+        assertValid(providedId, '`id` in `createEntity`');
+    }
+    const id = providedId ?? generate();
+    let ops = [];
+    const newValues = [];
+    if (name) {
+        newValues.push({
+            propertyId: toBase64(NAME_PROPERTY),
+            value: name,
+        });
+    }
+    if (description) {
+        newValues.push({
+            propertyId: toBase64(DESCRIPTION_PROPERTY),
+            value: description,
+        });
+    }
+    for (const [key, value] of Object.entries(values ?? {})) {
+        newValues.push({
+            propertyId: toBase64(Id(key)),
+            value: value.value,
+        });
+    }
+    const op = {
+        type: 'UPDATE_ENTITY',
+        entity: {
+            id: toBase64(id),
+            values: newValues,
+        },
+    };
+    ops.push(op);
+    if (cover) {
+        assertValid(cover);
+        ops.push({
+            type: 'CREATE_RELATION',
+            relation: {
+                id: toBase64(generate()),
+                entity: toBase64(generate()),
+                fromEntity: toBase64(id),
+                toEntity: toBase64(cover),
+                type: toBase64(COVER_PROPERTY),
+            },
+        });
+    }
+    if (types) {
+        for (const typeId of types) {
+            assertValid(typeId);
+            ops.push({
+                type: 'CREATE_RELATION',
+                relation: {
+                    id: toBase64(generate()),
+                    entity: toBase64(generate()),
+                    fromEntity: toBase64(id),
+                    toEntity: toBase64(typeId),
+                    type: toBase64(TYPES_PROPERTY),
+                },
+            });
+        }
+    }
+    for (const [typeId, value] of Object.entries(relations ?? {})) {
+        const relationsEntries = Array.isArray(value) ? value : [value];
+        for (const relation of relationsEntries) {
+            const relationId = relation.relationId ?? generate();
+            assertValid(relationId);
+            const relationEntityId = relation.id ?? generate();
+            assertValid(relationEntityId);
+            const { ops: relationOps } = createRelation({
+                fromEntity: id,
+                toEntity: relation.toEntity,
+                type: Id(typeId),
+                position: relation.position,
+                toSpace: relation.toSpace,
+                entityId: relationEntityId,
+                entityName: relation.entityName,
+                entityDescription: relation.entityDescription,
+                entityCover: relation.entityCover,
+                entityValues: relation.entityValues,
+                entityRelations: relation.entityRelations,
+                entityTypes: relation.entityTypes,
+            });
+            ops = ops.concat(relationOps);
+        }
+    }
+    return { id, ops };
+};
+//# sourceMappingURL=create-entity.js.map

package/dist/src/graphv2/create-entity.js.map

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

package/dist/src/graphv2/create-entity.test.d.ts

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

package/dist/src/graphv2/create-entity.test.d.ts.map

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

package/dist/src/graphv2/create-entity.test.js

@@ -0,0 +1,158 @@
+import { describe, expect, it } from 'vitest';
+import { CLAIM_TYPE, NEWS_STORY_TYPE } from '../core/idsv2/content.js';
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY, TYPES_PROPERTY } from '../core/idsv2/system.js';
+import { Id, toBase64 } from '../idv2.js';
+import { createEntity } from './create-entity.js';
+describe('createEntity', () => {
+    const coverId = Id('30145d36-d5a5-4244-be59-3d111d879ba5');
+    it('creates a basic entity without properties', async () => {
+        const entity = createEntity({});
+        expect(entity).toBeDefined();
+        expect(typeof entity.id).toBe('string');
+        expect(entity.ops).toBeDefined();
+        expect(entity.ops).toHaveLength(1); // One UPDATE_ENTITY op
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entity.id),
+                values: [],
+            },
+        });
+    });
+    it('creates an entity with types', async () => {
+        const entity = createEntity({
+            types: [CLAIM_TYPE, NEWS_STORY_TYPE],
+        });
+        expect(entity).toBeDefined();
+        expect(typeof entity.id).toBe('string');
+        expect(entity.ops).toHaveLength(3); // One UPDATE_ENTITY + two CREATE_RELATION ops
+        // Check UPDATE_ENTITY op
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entity.id),
+                values: [],
+            },
+        });
+        // Check first type relation
+        expect(entity.ops[1]).toMatchObject({
+            type: 'CREATE_RELATION',
+            relation: {
+                fromEntity: toBase64(entity.id),
+                toEntity: toBase64(CLAIM_TYPE),
+                type: toBase64(TYPES_PROPERTY),
+            },
+        });
+        // Check second type relation
+        expect(entity.ops[2]).toMatchObject({
+            type: 'CREATE_RELATION',
+            relation: {
+                fromEntity: toBase64(entity.id),
+                toEntity: toBase64(NEWS_STORY_TYPE),
+                type: toBase64(TYPES_PROPERTY),
+            },
+        });
+    });
+    it('creates an entity with name and description', async () => {
+        const entity = createEntity({
+            name: 'Test Entity',
+            description: 'Test Description',
+        });
+        expect(entity).toBeDefined();
+        expect(typeof entity.id).toBe('string');
+        expect(entity.ops).toHaveLength(1);
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entity.id),
+                values: [
+                    {
+                        propertyId: toBase64(NAME_PROPERTY),
+                        value: 'Test Entity',
+                    },
+                    {
+                        propertyId: toBase64(DESCRIPTION_PROPERTY),
+                        value: 'Test Description',
+                    },
+                ],
+            },
+        });
+    });
+    it('creates an entity with cover', async () => {
+        const entity = createEntity({
+            cover: coverId,
+        });
+        expect(entity).toBeDefined();
+        expect(typeof entity.id).toBe('string');
+        expect(entity.ops).toHaveLength(2);
+        // Check UPDATE_ENTITY op
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entity.id),
+                values: [],
+            },
+        });
+        // Check cover relation
+        expect(entity.ops[1]).toMatchObject({
+            type: 'CREATE_RELATION',
+            relation: {
+                fromEntity: toBase64(entity.id),
+                toEntity: toBase64(coverId),
+                type: toBase64(COVER_PROPERTY),
+            },
+        });
+    });
+    it('creates an entity with custom values', async () => {
+        const customPropertyId = Id('fa269fd3-de98-49cf-90c4-4235d905a67c');
+        const entity = createEntity({
+            values: {
+                [customPropertyId]: {
+                    value: 'custom value',
+                },
+            },
+        });
+        expect(entity).toBeDefined();
+        expect(typeof entity.id).toBe('string');
+        expect(entity.ops).toHaveLength(1);
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entity.id),
+                values: [
+                    {
+                        propertyId: toBase64(customPropertyId),
+                        value: 'custom value',
+                    },
+                ],
+            },
+        });
+    });
+    it('creates an entity with a provided id', async () => {
+        const providedId = Id('b1dc6e5c-63e1-43ba-b3d4-755b251a4ea1');
+        const entity = createEntity({
+            id: providedId,
+            name: 'Test Entity',
+        });
+        expect(entity).toBeDefined();
+        expect(entity.id).toBe(providedId);
+        expect(entity.ops).toHaveLength(1);
+        expect(entity.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(providedId),
+                values: [
+                    {
+                        propertyId: toBase64(NAME_PROPERTY),
+                        value: 'Test Entity',
+                    },
+                ],
+            },
+        });
+    });
+    it('throws an error if the provided id is invalid', () => {
+        // @ts-expect-error - invalid id type
+        expect(() => createEntity({ id: 'invalid' })).toThrow('Invalid id: "invalid" for `id` in `createEntity`');
+    });
+});
+//# sourceMappingURL=create-entity.test.js.map

package/dist/src/graphv2/create-entity.test.js.map

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

package/dist/src/graphv2/create-image.d.ts

@@ -0,0 +1,28 @@
+import type { CreateImageParams, CreateResult } from '../typesv2.js';
+/**
+ * Creates an entity with the given name, description, cover, properties, and types.
+ * All IDs passed to this function (cover, types, property IDs, relation IDs, etc.) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createImage({
+ *   url: 'https://example.com/image.png',
+ *   name: 'name of the image', // optional
+ *   description: 'description of the image', // optional
+ *   id: imageId, // optional and will be generated if not provided
+ * });
+ *
+ * const { id, ops } = createImage({
+ *   blob: new Blob(…),
+ *   name: 'name of the image', // optional
+ *   description: 'description of the image', // optional
+ *   id: imageId, // optional and will be generated if not provided
+ * });
+ * ```
+ * @param params – {@link CreateImageParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an IpfsUploadError if the image cannot be uploaded to IPFS
+ */
+export declare const createImage: ({ name, description, id: providedId, ...params }: CreateImageParams) => Promise<CreateResult>;
+//# sourceMappingURL=create-image.d.ts.map

package/dist/src/graphv2/create-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image.d.ts","sourceRoot":"","sources":["../../../src/graphv2/create-image.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAGtF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,GAAU,kDAK/B,iBAAiB,KAAG,OAAO,CAAC,YAAY,CA4C1C,CAAC"}

package/dist/src/graphv2/create-image.js

@@ -0,0 +1,71 @@
+import { IMAGE_HEIGHT_PROPERTY, IMAGE_TYPE, IMAGE_URL_PROPERTY, IMAGE_WIDTH_PROPERTY, TYPES_PROPERTY, } from '../core/idsv2/system.js';
+import { assertValid, generate, toBase64 } from '../idv2.js';
+import { uploadImage } from '../ipfsv2.js';
+import { createEntity } from './create-entity.js';
+/**
+ * Creates an entity with the given name, description, cover, properties, and types.
+ * All IDs passed to this function (cover, types, property IDs, relation IDs, etc.) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createImage({
+ *   url: 'https://example.com/image.png',
+ *   name: 'name of the image', // optional
+ *   description: 'description of the image', // optional
+ *   id: imageId, // optional and will be generated if not provided
+ * });
+ *
+ * const { id, ops } = createImage({
+ *   blob: new Blob(…),
+ *   name: 'name of the image', // optional
+ *   description: 'description of the image', // optional
+ *   id: imageId, // optional and will be generated if not provided
+ * });
+ * ```
+ * @param params – {@link CreateImageParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an IpfsUploadError if the image cannot be uploaded to IPFS
+ */
+export const createImage = async ({ name, description, id: providedId, ...params }) => {
+    if (providedId) {
+        assertValid(providedId, '`id` in `createImage`');
+    }
+    const id = providedId ?? generate();
+    const { cid, dimensions } = await uploadImage(params);
+    const values = {};
+    values[IMAGE_URL_PROPERTY] = {
+        value: cid,
+    };
+    if (dimensions?.height) {
+        values[IMAGE_HEIGHT_PROPERTY] = {
+            value: dimensions.height.toString(),
+        };
+    }
+    if (dimensions?.width) {
+        values[IMAGE_WIDTH_PROPERTY] = {
+            value: dimensions.width.toString(),
+        };
+    }
+    const { ops } = createEntity({
+        id,
+        name,
+        description,
+        values,
+    });
+    ops.push({
+        type: 'CREATE_RELATION',
+        relation: {
+            id: toBase64(generate()),
+            entity: toBase64(generate()),
+            fromEntity: toBase64(id),
+            toEntity: toBase64(IMAGE_TYPE),
+            type: toBase64(TYPES_PROPERTY),
+        },
+    });
+    return {
+        id,
+        ops,
+    };
+};
+//# sourceMappingURL=create-image.js.map

package/dist/src/graphv2/create-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image.js","sourceRoot":"","sources":["../../../src/graphv2/create-image.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,EAChC,IAAI,EACJ,WAAW,EACX,EAAE,EAAE,UAAU,EACd,GAAG,MAAM,EACS,EAAyB,EAAE;IAC7C,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,CAAC,kBAAkB,CAAC,GAAG;QAC3B,KAAK,EAAE,GAAG;KACX,CAAC;IACF,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,qBAAqB,CAAC,GAAG;YAC9B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;SACpC,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,oBAAoB,CAAC,GAAG;YAC7B,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC;QAC3B,EAAE;QACF,IAAI;QACJ,WAAW;QACX,MAAM;KACP,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE;YACR,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxB,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5B,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;YACxB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;YAC9B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;SAC/B;KACF,CAAC,CAAC;IAEH,OAAO;QACL,EAAE;QACF,GAAG;KACJ,CAAC;AACJ,CAAC,CAAC"}

package/dist/src/graphv2/create-image.test.d.ts

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

package/dist/src/graphv2/create-image.test.d.ts.map

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

package/dist/src/graphv2/create-image.test.js

@@ -0,0 +1,142 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { Id, toBase64 } from '../idv2.js';
+import { SystemIds } from '../system-ids-v2.js';
+import { createImage } from './create-image.js';
+// serialized like this:
+// const buffer = Buffer.from(await blob.arrayBuffer());
+// const base64 = buffer.toString('base64');
+// console.log('base64', base64);
+const testImageContent = 'iVBORw0KGgoAAAANSUhEUgAAAAoAAAAHCAMAAAAGcixRAAAAY1BMVEXvvubYz97i2Ojm3Oz4vu3gv+f2yfTqxvDj1v/hxe/u0Pvn1v3Oxc7wx/LHs87r2uzYs7np3++lnaPq1OrZxtjx3PL8xPLG0OXjyuHizeS3qsDfz+nMu8PZtc3TvNjdyO77z/t7oOngAAAACnRSTlP+////y/7e/tbEPoYQ1AAAAAlwSFlzAAALEwAACxMBAJqcGAAAAEhJREFUeNoFwQkCQDAMBMBNgtJL77r5/yvNYPqc1toYM+Pt1VPcgjDGvj4ke2BGS3Y9SSQRUDh7kkKM+5J82OptxNAA55TSyw+IpgNhAhO+gAAAAABJRU5ErkJggg==';
+const testImageBlob = new Blob([Buffer.from(testImageContent, 'base64')], { type: 'image/png' });
+const ipfsUploadUrl = 'https://api-testnet.grc-20.thegraph.com/ipfs/upload-file';
+describe('createImage', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.spyOn(global, 'fetch').mockImplementation(url => {
+            if (url.toString() === 'http://localhost:3000/image') {
+                return Promise.resolve({
+                    status: 200,
+                    blob: () => Promise.resolve(testImageBlob),
+                });
+            }
+            if (url.toString() === ipfsUploadUrl) {
+                return Promise.resolve({
+                    status: 200,
+                    json: () => Promise.resolve({ cid: 'ipfs://bafkreidgcqofpstvkzylgxbcn4xan6camlgf564sasepyt45sjgvnojxp4' }),
+                });
+            }
+            return vi.fn();
+        });
+    });
+    it('creates an image from a url', async () => {
+        const image = await createImage({
+            url: 'http://localhost:3000/image',
+        });
+        expect(image).toBeDefined();
+        expect(typeof image.id).toBe('string');
+        expect(image.ops).toBeDefined();
+        expect(image.ops).toHaveLength(2);
+        if (image.ops[0]) {
+            expect(image.ops[0].type).toBe('UPDATE_ENTITY');
+            if (image.ops[0].type === 'UPDATE_ENTITY') {
+                expect(image.ops[0].entity.values).toContainEqual({
+                    propertyId: toBase64(SystemIds.IMAGE_URL_PROPERTY),
+                    value: 'ipfs://bafkreidgcqofpstvkzylgxbcn4xan6camlgf564sasepyt45sjgvnojxp4',
+                });
+            }
+        }
+        if (image.ops[1]) {
+            expect(image.ops[1].type).toBe('CREATE_RELATION');
+        }
+    });
+    it('creates an image from a blob', async () => {
+        const image = await createImage({
+            blob: testImageBlob,
+        });
+        expect(image).toBeDefined();
+        expect(typeof image.id).toBe('string');
+        expect(image.ops).toBeDefined();
+        expect(image.ops).toHaveLength(2);
+        if (image.ops[0]) {
+            expect(image.ops[0].type).toBe('UPDATE_ENTITY');
+            if (image.ops[0].type === 'UPDATE_ENTITY') {
+                expect(image.ops[0].entity.values).toContainEqual({
+                    propertyId: toBase64(SystemIds.IMAGE_URL_PROPERTY),
+                    value: 'ipfs://bafkreidgcqofpstvkzylgxbcn4xan6camlgf564sasepyt45sjgvnojxp4',
+                });
+            }
+        }
+        if (image.ops[1]) {
+            expect(image.ops[1].type).toBe('CREATE_RELATION');
+        }
+    });
+    it('creates an image with a name and description', async () => {
+        const image = await createImage({
+            url: 'http://localhost:3000/image',
+            name: 'test image',
+            description: 'test description',
+        });
+        expect(image).toBeDefined();
+        expect(typeof image.id).toBe('string');
+        expect(image.ops).toBeDefined();
+        expect(image.ops).toHaveLength(2);
+        if (image.ops[0]) {
+            expect(image.ops[0].type).toBe('UPDATE_ENTITY');
+            if (image.ops[0].type === 'UPDATE_ENTITY') {
+                expect(image.ops[0].entity.values).toContainEqual({
+                    propertyId: toBase64(SystemIds.NAME_PROPERTY),
+                    value: 'test image',
+                });
+            }
+            if (image.ops[0].type === 'UPDATE_ENTITY') {
+                expect(image.ops[0].entity.values).toContainEqual({
+                    propertyId: toBase64(SystemIds.DESCRIPTION_PROPERTY),
+                    value: 'test description',
+                });
+            }
+        }
+    });
+    it('creates and image without dimensions in case they cannot be determined', async () => {
+        const testImageBlob = new Blob([new Uint8Array([0, 0, 0, 0])], { type: 'image/png' });
+        const image = await createImage({ blob: testImageBlob });
+        expect(image).toBeDefined();
+        expect(image.ops).toBeDefined();
+        expect(image.ops).toHaveLength(2);
+        if (image.ops[0]) {
+            expect(image.ops[0].type).toBe('UPDATE_ENTITY');
+        }
+        if (image.ops[1]) {
+            expect(image.ops[1].type).toBe('CREATE_RELATION');
+        }
+    });
+    it('creates an image with a provided id', async () => {
+        const image = await createImage({
+            url: 'http://localhost:3000/image',
+            id: Id('8698adc1-6661-45a3-bea0-482ef419797f'),
+        });
+        expect(image).toBeDefined();
+        expect(image.id).toBe('8698adc1-6661-45a3-bea0-482ef419797f');
+    });
+    it('throws an error if the provided id is invalid', async () => {
+        // @ts-expect-error - invalid id type
+        await expect(async () => await createImage({ id: 'invalid', url: 'http://localhost:3000/image' })).rejects.toThrow('Invalid id: "invalid" for `id` in `createImage`');
+    });
+    it('throws an error if the image cannot be uploaded to IPFS', async () => {
+        vi.spyOn(global, 'fetch').mockImplementation(url => {
+            if (url.toString() === 'http://localhost:3000/image') {
+                return Promise.resolve({
+                    status: 200,
+                    blob: () => Promise.resolve(testImageBlob),
+                });
+            }
+            if (url.toString() === ipfsUploadUrl) {
+                return Promise.reject(new Error('Failed to upload image to IPFS'));
+            }
+            return vi.fn();
+        });
+        await expect(createImage({
+            url: 'http://localhost:3000/image',
+        })).rejects.toThrow('Could not upload file to IPFS');
+    });
+});
+//# sourceMappingURL=create-image.test.js.map

package/dist/src/graphv2/create-image.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image.test.js","sourceRoot":"","sources":["../../../src/graphv2/create-image.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,wBAAwB;AACxB,wDAAwD;AACxD,4CAA4C;AAC5C,iCAAiC;AACjC,MAAM,gBAAgB,GACpB,8XAA8X,CAAC;AAEjY,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACjG,MAAM,aAAa,GAAG,0DAA0D,CAAC;AAEjF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE;YACjD,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,6BAA6B,EAAE,CAAC;gBACrD,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;iBAC/B,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,aAAa,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,oEAAoE,EAAE,CAAC;iBAC/F,CAAC,CAAC;YACjB,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,EAAW,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,GAAG,EAAE,6BAA6B;SACnC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC;oBAChD,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC;oBAClD,KAAK,EAAE,oEAAoE;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC;oBAChD,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC;oBAClD,KAAK,EAAE,oEAAoE;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,GAAG,EAAE,6BAA6B;YAClC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kBAAkB;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC;oBAChD,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC;oBAC7C,KAAK,EAAE,YAAY;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC;oBAChD,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,oBAAoB,CAAC;oBACpD,KAAK,EAAE,kBAAkB;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,GAAG,EAAE,6BAA6B;YAClC,EAAE,EAAE,EAAE,CAAC,sCAAsC,CAAC;SAC/C,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,qCAAqC;QACrC,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,6BAA6B,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAChH,iDAAiD,CAClD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE;YACjD,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,6BAA6B,EAAE,CAAC;gBACrD,OAAO,OAAO,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;iBAC/B,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,aAAa,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,EAAW,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CACV,WAAW,CAAC;YACV,GAAG,EAAE,6BAA6B;SACnC,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/graphv2/create-property.d.ts

@@ -0,0 +1,22 @@
+import type { CreatePropertyParams, CreateResult } from '../typesv2.js';
+/**
+ * Creates a property with the given name, description, cover, and type.
+ * All IDs passed to this function (cover, relation value types) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createProperty({
+ *   name: 'name of the property',
+ *   type: 'TEXT'
+ *   description: 'description of the property',
+ *   cover: imageEntityId,
+ *   id: propertyId, // optional and will be generated if not provided
+ * });
+ * ```
+ * @param params – {@link CreatePropertyParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export declare const createProperty: (params: CreatePropertyParams) => CreateResult;
+//# sourceMappingURL=create-property.d.ts.map

package/dist/src/graphv2/create-property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-property.d.ts","sourceRoot":"","sources":["../../../src/graphv2/create-property.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,oBAAoB,KAAG,YA8G7D,CAAC"}