@graphprotocol/grc-20 0.26.0 → 0.27.0

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":"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"}

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"}

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

@@ -0,0 +1,129 @@
+import { CHECKBOX, NUMBER, POINT, PROPERTY, RELATION, RELATION_VALUE_RELATIONSHIP_TYPE, SCHEMA_TYPE, TEXT, TIME, TYPES_PROPERTY, URL, VALUE_TYPE_PROPERTY, } from '../core/idsv2/system.js';
+import { assertValid, generate, toBase64 } from '../idv2.js';
+import { createEntity } from './create-entity.js';
+import { createRelation } from './create-relation.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 const createProperty = (params) => {
+    const { id, name, description, cover } = params;
+    if (id) {
+        assertValid(id, '`id` in `createProperty`');
+    }
+    const entityId = id ?? generate();
+    const { ops } = createEntity({
+        id: entityId,
+        name,
+        description,
+        cover,
+    });
+    // add "Property" as "Types property"
+    ops.push({
+        type: 'CREATE_RELATION',
+        relation: {
+            id: toBase64(generate()),
+            entity: toBase64(generate()),
+            fromEntity: toBase64(entityId),
+            toEntity: toBase64(PROPERTY),
+            type: toBase64(TYPES_PROPERTY),
+        },
+    });
+    // add "Type" as "Types property"
+    ops.push({
+        type: 'CREATE_RELATION',
+        relation: {
+            id: toBase64(generate()),
+            entity: toBase64(generate()),
+            fromEntity: toBase64(entityId),
+            toEntity: toBase64(SCHEMA_TYPE),
+            type: toBase64(TYPES_PROPERTY),
+        },
+    });
+    if (params.type === 'RELATION') {
+        const { ops: valueTypeRelationOps } = createRelation({
+            toEntity: RELATION,
+            fromEntity: entityId,
+            type: VALUE_TYPE_PROPERTY,
+        });
+        ops.push(...valueTypeRelationOps);
+        // add the provided properties to property "Properties"
+        if (params.properties) {
+            for (const propertyId of params.properties) {
+                assertValid(propertyId);
+                const { ops: relationOps } = createRelation({
+                    fromEntity: entityId,
+                    toEntity: propertyId,
+                    type: PROPERTY,
+                });
+                ops.push(...relationOps);
+            }
+        }
+        if (params.relationValueTypes) {
+            // add the provided relation value types to property "Relation Value Types"
+            for (const relationValueTypeId of params.relationValueTypes) {
+                assertValid(relationValueTypeId);
+                const { ops: relationOps } = createRelation({
+                    fromEntity: entityId,
+                    toEntity: relationValueTypeId,
+                    type: RELATION_VALUE_RELATIONSHIP_TYPE,
+                });
+                ops.push(...relationOps);
+            }
+        }
+    }
+    else {
+        let toId;
+        switch (params.type) {
+            case 'TEXT':
+                toId = TEXT;
+                break;
+            case 'NUMBER':
+                toId = NUMBER;
+                break;
+            case 'URL':
+                toId = URL;
+                break;
+            case 'TIME':
+                toId = TIME;
+                break;
+            case 'POINT':
+                toId = POINT;
+                break;
+            case 'CHECKBOX':
+                toId = CHECKBOX;
+                break;
+            default:
+                // @ts-expect-error
+                throw new Error(`Unsupported type: ${params.type}`);
+        }
+        // add the provided type to property "Value Types"
+        ops.push({
+            type: 'CREATE_RELATION',
+            relation: {
+                id: toBase64(generate()),
+                entity: toBase64(generate()),
+                fromEntity: toBase64(entityId),
+                toEntity: toBase64(toId),
+                type: toBase64(VALUE_TYPE_PROPERTY),
+            },
+        });
+    }
+    return { id: entityId, ops };
+};
+//# sourceMappingURL=create-property.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-property.js","sourceRoot":"","sources":["../../../src/graphv2/create-property.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,gCAAgC,EAChC,WAAW,EACX,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,GAAG,EACH,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAA4B,EAAgB,EAAE;IAC3E,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAChD,IAAI,EAAE,EAAE,CAAC;QACP,WAAW,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;IAElC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC;QAC3B,EAAE,EAAE,QAAQ;QACZ,IAAI;QACJ,WAAW;QACX,KAAK;KACN,CAAC,CAAC;IAEH,qCAAqC;IACrC,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,QAAQ,CAAC;YAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAC5B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;SAC/B;KACF,CAAC,CAAC;IAEH,iCAAiC;IACjC,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,QAAQ,CAAC;YAC9B,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC;YAC/B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;SAC/B;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,cAAc,CAAC;YACnD,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,mBAAmB;SAC1B,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAElC,uDAAuD;QACvD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC3C,WAAW,CAAC,UAAU,CAAC,CAAC;gBACxB,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC;oBAC1C,UAAU,EAAE,QAAQ;oBACpB,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,QAAQ;iBACf,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC9B,2EAA2E;YAC3E,KAAK,MAAM,mBAAmB,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC5D,WAAW,CAAC,mBAAmB,CAAC,CAAC;gBACjC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC;oBAC1C,UAAU,EAAE,QAAQ;oBACpB,QAAQ,EAAE,mBAAmB;oBAC7B,IAAI,EAAE,gCAAgC;iBACvC,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,IAAQ,CAAC;QACb,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,MAAM;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,GAAG,MAAM,CAAC;gBACd,MAAM;YACR,KAAK,KAAK;gBACR,IAAI,GAAG,GAAG,CAAC;gBACX,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,GAAG,KAAK,CAAC;gBACb,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,GAAG,QAAQ,CAAC;gBAChB,MAAM;YACR;gBACE,mBAAmB;gBACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,kDAAkD;QAClD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE;gBACR,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACxB,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC5B,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBAC9B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACxB,IAAI,EAAE,QAAQ,CAAC,mBAAmB,CAAC;aACpC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAC/B,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import { JOB_TYPE, ROLES_PROPERTY } from '../core/idsv2/content.js';
+import { Id } from '../idv2.js';
+import { createProperty } from './create-property.js';
+describe('createProperty', () => {
+    it('creates a TEXT property', async () => {
+        const property = createProperty({
+            name: 'Disclaimer',
+            description: 'This is a disclaimer',
+            type: 'TEXT',
+        });
+        expect(property).toBeDefined();
+        expect(typeof property.id).toBe('string');
+        expect(property.ops).toBeDefined();
+        expect(property.ops.length).toBe(4);
+        expect(property.ops[0]?.type).toBe('UPDATE_ENTITY');
+        expect(property.ops[1]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[2]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[3]?.type).toBe('CREATE_RELATION');
+    });
+    it('creates a NUMBER property', async () => {
+        const property = createProperty({
+            name: 'Price',
+            description: 'The price of the product',
+            type: 'NUMBER',
+        });
+        expect(property).toBeDefined();
+        expect(typeof property.id).toBe('string');
+        expect(property.ops).toBeDefined();
+        expect(property.ops.length).toBe(4);
+        expect(property.ops[0]?.type).toBe('UPDATE_ENTITY');
+        expect(property.ops[1]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[2]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[3]?.type).toBe('CREATE_RELATION');
+    });
+    it('creates a RELATION property', async () => {
+        const property = createProperty({
+            name: 'City',
+            type: 'RELATION',
+        });
+        expect(property).toBeDefined();
+        expect(typeof property.id).toBe('string');
+        expect(property.ops).toBeDefined();
+        expect(property.ops.length).toBe(4);
+        expect(property.ops[0]?.type).toBe('UPDATE_ENTITY');
+        expect(property.ops[1]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[2]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[3]?.type).toBe('CREATE_RELATION');
+    });
+    it('creates a RELATION property with properties and relation value types', async () => {
+        const property = createProperty({
+            name: 'City',
+            type: 'RELATION',
+            properties: [ROLES_PROPERTY],
+            relationValueTypes: [JOB_TYPE],
+        });
+        expect(property).toBeDefined();
+        expect(typeof property.id).toBe('string');
+        expect(property.ops).toBeDefined();
+        expect(property.ops.length).toBe(6);
+        expect(property.ops[0]?.type).toBe('UPDATE_ENTITY');
+        expect(property.ops[1]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[2]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[3]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[4]?.type).toBe('CREATE_RELATION');
+        expect(property.ops[5]?.type).toBe('CREATE_RELATION');
+    });
+    it('creates a property with a provided id', async () => {
+        const property = createProperty({
+            id: Id('b1dc6e5c-63e1-43ba-b3d4-755b251a4ea1'),
+            name: 'Price',
+            type: 'NUMBER',
+        });
+        expect(property).toBeDefined();
+        expect(property.id).toBe('b1dc6e5c-63e1-43ba-b3d4-755b251a4ea1');
+    });
+    it('throws an error if the provided id is invalid', async () => {
+        // @ts-expect-error - invalid id type
+        expect(() => createProperty({ id: 'invalid' })).toThrow('Invalid id: "invalid" for `id` in `createProperty`');
+    });
+});
+//# sourceMappingURL=create-property.test.js.map

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

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

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

@@ -0,0 +1,33 @@
+import type { CreateResult, RelationParams } from '../typesv2.js';
+/**
+ * Creates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createRelation({
+ *   id: relationId,
+ *   fromEntity: entityId1,
+ *   toEntity: entityId2,
+ *   type: relationTypeId,
+ *   toSpace: spaceId,
+ *   position: 'position of the relation',
+ *   entityId: entityId3, // optional and will be generated if not provided
+ *   entityValues: {
+ *     propertyId1: { value: 'value1' },
+ *     propertyId2: { value: 'value2' },
+ *   },
+ *   entityRelations: {
+ *     relationTypeId1: { to: entityId3, type: relationTypeId2 },
+ *   },
+ *   entityTypes: [typeId1, typeId2],
+ *   entityName: 'name of the relation entity',
+ *   entityDescription: 'description of the relation entity',
+ *   entityCover: imageEntityId,
+ * });
+ * ```
+ * @param params – {@link RelationParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export declare const createRelation: ({ id: providedId, fromEntity, toEntity, position, toSpace, type, entityId: providedEntityId, entityName, entityDescription, entityCover, entityValues, entityRelations, entityTypes, }: RelationParams) => CreateResult;
+//# sourceMappingURL=create-relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-relation.d.ts","sourceRoot":"","sources":["../../../src/graphv2/create-relation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAM,cAAc,EAAE,MAAM,eAAe,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,cAAc,GAAI,wLAc5B,cAAc,KAAG,YAoCnB,CAAC"}

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

@@ -0,0 +1,66 @@
+import { assertValid, generate, toBase64 } from '../idv2.js';
+import { createEntity } from './create-entity.js';
+/**
+ * Creates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createRelation({
+ *   id: relationId,
+ *   fromEntity: entityId1,
+ *   toEntity: entityId2,
+ *   type: relationTypeId,
+ *   toSpace: spaceId,
+ *   position: 'position of the relation',
+ *   entityId: entityId3, // optional and will be generated if not provided
+ *   entityValues: {
+ *     propertyId1: { value: 'value1' },
+ *     propertyId2: { value: 'value2' },
+ *   },
+ *   entityRelations: {
+ *     relationTypeId1: { to: entityId3, type: relationTypeId2 },
+ *   },
+ *   entityTypes: [typeId1, typeId2],
+ *   entityName: 'name of the relation entity',
+ *   entityDescription: 'description of the relation entity',
+ *   entityCover: imageEntityId,
+ * });
+ * ```
+ * @param params – {@link RelationParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export const createRelation = ({ id: providedId, fromEntity, toEntity, position, toSpace, type, entityId: providedEntityId, entityName, entityDescription, entityCover, entityValues, entityRelations, entityTypes, }) => {
+    if (providedId) {
+        assertValid(providedId, '`id` in `createType`');
+    }
+    const id = providedId ?? generate();
+    const entityId = providedEntityId ?? generate();
+    const ops = [];
+    ops.push({
+        type: 'CREATE_RELATION',
+        relation: {
+            id: toBase64(id),
+            entity: toBase64(entityId),
+            fromEntity: toBase64(fromEntity),
+            position,
+            toEntity: toBase64(toEntity),
+            toSpace: toSpace ? toBase64(toSpace) : undefined,
+            type: toBase64(type),
+        },
+    });
+    if (entityName || entityDescription || entityCover || entityValues || entityRelations || entityTypes) {
+        const { ops: entityOps } = createEntity({
+            id: entityId,
+            name: entityName,
+            description: entityDescription,
+            cover: entityCover,
+            values: entityValues,
+            relations: entityRelations,
+            types: entityTypes,
+        });
+        ops.push(...entityOps);
+    }
+    return { id, ops };
+};
+//# sourceMappingURL=create-relation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-relation.js","sourceRoot":"","sources":["../../../src/graphv2/create-relation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,EAAE,EAAE,UAAU,EACd,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,GACI,EAAgB,EAAE;IACjC,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,gBAAgB,IAAI,QAAQ,EAAE,CAAC;IAEhD,MAAM,GAAG,GAAc,EAAE,CAAC;IAE1B,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE;YACR,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;YAChB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAC1B,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;YAChC,QAAQ;YACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAChD,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;SACrB;KACF,CAAC,CAAC;IAEH,IAAI,UAAU,IAAI,iBAAiB,IAAI,WAAW,IAAI,YAAY,IAAI,eAAe,IAAI,WAAW,EAAE,CAAC;QACrG,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC;YACtC,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,iBAAiB;YAC9B,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC,CAAC"}

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

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

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

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