@graphprotocol/grc-20 0.28.0 → 0.29.0

package/dist/src/encodings/get-register-space-calldata.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { getRegisterSpaceCalldata } from './get-register-space-calldata.js';
+describe('getRegisterSpaceCalldata', () => {
+    it('should generate valid calldata', () => {
+        const calldata = getRegisterSpaceCalldata();
+        expect(calldata).toBeTypeOf('string');
+        expect(calldata.startsWith('0x')).toBe(true);
+    });
+    it('should return consistent calldata', () => {
+        const calldata1 = getRegisterSpaceCalldata();
+        const calldata2 = getRegisterSpaceCalldata();
+        expect(calldata1).toBe(calldata2);
+    });
+});
+//# sourceMappingURL=get-register-space-calldata.test.js.map

package/dist/src/encodings/get-register-space-calldata.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-register-space-calldata.test.js","sourceRoot":"","sources":["../../../src/encodings/get-register-space-calldata.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,wBAAwB,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,wBAAwB,EAAE,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/graph/delete-entity.d.ts

@@ -0,0 +1,14 @@
+import type { CreateResult, DeleteEntityParams } from '../types.js';
+/**
+ * Deletes an entity from a space.
+ *
+ * @example
+ * ```ts
+ * const { ops } = await deleteEntity({ id: entityId });
+ * ```
+ *
+ * @param params – {@link DeleteEntityParams}
+ * @returns The operations to delete the entity.
+ */
+export declare const deleteEntity: ({ id }: DeleteEntityParams) => CreateResult;
+//# sourceMappingURL=delete-entity.d.ts.map

package/dist/src/graph/delete-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity.d.ts","sourceRoot":"","sources":["../../../src/graph/delete-entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAkB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,kBAAkB,KAAG,YAQzD,CAAC"}

package/dist/src/graph/delete-entity.js

@@ -0,0 +1,21 @@
+import { Id, assertValid } from '../id.js';
+/**
+ * Deletes an entity from a space.
+ *
+ * @example
+ * ```ts
+ * const { ops } = await deleteEntity({ id: entityId });
+ * ```
+ *
+ * @param params – {@link DeleteEntityParams}
+ * @returns The operations to delete the entity.
+ */
+export const deleteEntity = ({ id }) => {
+    assertValid(id, '`id` in `deleteEntity`');
+    const op = {
+        type: 'DELETE_ENTITY',
+        id: Id(id),
+    };
+    return { id: Id(id), ops: [op] };
+};
+//# sourceMappingURL=delete-entity.js.map

package/dist/src/graph/delete-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity.js","sourceRoot":"","sources":["../../../src/graph/delete-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,EAAsB,EAAgB,EAAE;IACvE,WAAW,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAmB;QACzB,IAAI,EAAE,eAAe;QACrB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;KACX,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC,CAAC"}

package/dist/src/graph/delete-entity.test.d.ts

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

package/dist/src/graph/delete-entity.test.d.ts.map

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

package/dist/src/graph/delete-entity.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { Id } from '../id.js';
+import { deleteEntity } from './delete-entity.js';
+describe('deleteEntity', () => {
+    it('should create a delete entity operation with valid ID', () => {
+        const id = Id('5cade575-7ecd-41ae-8348-1b22ffc2f94e');
+        const result = deleteEntity({ id });
+        expect(result).toEqual({
+            id,
+            ops: [
+                {
+                    type: 'DELETE_ENTITY',
+                    id: id,
+                },
+            ],
+        });
+    });
+    it('should throw an error when ID validation fails', () => {
+        const id = 'invalid-id';
+        expect(() => deleteEntity({ id })).toThrow('Invalid id: "invalid-id"');
+    });
+});
+//# sourceMappingURL=delete-entity.test.js.map

package/dist/src/graph/delete-entity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity.test.js","sourceRoot":"","sources":["../../../src/graph/delete-entity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAEpC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE;YACF,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,eAAe;oBACrB,EAAE,EAAE,EAAE;iBACP;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,GAAG,YAAY,CAAC;QAExB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/graph/graph.test.d.ts

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

package/dist/src/graph/graph.test.d.ts.map

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

package/dist/src/graph/graph.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from 'vitest';
+import { createEntity } from './create-entity.js';
+import { createProperty } from './create-property.js';
+import { createType } from './create-type.js';
+describe('Graph', () => {
+    it('creates types, entities and relations', async () => {
+        const ops = [];
+        // create age property
+        const { id: agePropertyId, ops: createAgePropertyOps } = createProperty({
+            type: 'NUMBER',
+            name: 'Age',
+        });
+        ops.push(...createAgePropertyOps);
+        // create likes property
+        const { id: likesPropertyId, ops: createLikesPropertyOps } = createProperty({
+            type: 'RELATION',
+            name: 'Likes',
+        });
+        ops.push(...createLikesPropertyOps);
+        // create person type
+        const { id: personTypeId, ops: createPersonTypeOps } = createType({
+            name: 'Person',
+            properties: [agePropertyId],
+        });
+        ops.push(...createPersonTypeOps);
+        // create restaurant entity
+        const { id: restaurantId, ops: createRestaurantOps } = createEntity({
+            name: 'Restaurant',
+            types: [personTypeId],
+        });
+        ops.push(...createRestaurantOps);
+        // create person entity
+        const { id: personId, ops: createPersonOps } = createEntity({
+            name: 'Jane Doe',
+            types: [personTypeId],
+            properties: {
+                [likesPropertyId]: {
+                    to: restaurantId,
+                },
+            },
+        });
+        ops.push(...createPersonOps);
+        expect(ops.length).toBe(16);
+    });
+});
+//# sourceMappingURL=graph.test.js.map

package/dist/src/graph/graph.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.test.js","sourceRoot":"","sources":["../../../src/graph/graph.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,GAAG,GAAc,EAAE,CAAC;QAE1B,sBAAsB;QACtB,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,cAAc,CAAC;YACtE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAElC,wBAAwB;QACxB,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,cAAc,CAAC;YAC1E,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC;QAEpC,qBAAqB;QACrB,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,UAAU,CAAC;YAChE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,CAAC,aAAa,CAAC;SAC5B,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;QAEjC,2BAA2B;QAC3B,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,YAAY,CAAC;YAClE,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,CAAC,YAAY,CAAC;SACtB,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;QAEjC,uBAAuB;QACvB,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC;YAC1D,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,CAAC,YAAY,CAAC;YACrB,UAAU,EAAE;gBACV,CAAC,eAAe,CAAC,EAAE;oBACjB,EAAE,EAAE,YAAY;iBACjB;aACF;SACF,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QAE7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/graph/helpers/create-default-properties.d.ts

@@ -0,0 +1,5 @@
+import type { DefaultProperties, Op } from '../../types.js';
+export declare const createDefaultProperties: (params: DefaultProperties & {
+    entityId: string;
+}) => Op[];
+//# sourceMappingURL=create-default-properties.d.ts.map

package/dist/src/graph/helpers/create-default-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-default-properties.d.ts","sourceRoot":"","sources":["../../../../src/graph/helpers/create-default-properties.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,GAAI,QAAQ,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,SA0CvF,CAAC"}

package/dist/src/graph/helpers/create-default-properties.js

@@ -0,0 +1,44 @@
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY } from '../../core/ids/system.js';
+import { assertValid } from '../../id.js';
+import { Relation } from '../../relation.js';
+import { Triple } from '../../triple.js';
+export const createDefaultProperties = (params) => {
+    const { entityId, name, description, cover } = params;
+    const ops = [];
+    if (name) {
+        // set property "Name" to the provided name
+        const nameTripleOp = Triple.make({
+            entityId,
+            attributeId: NAME_PROPERTY,
+            value: {
+                type: 'TEXT',
+                value: name,
+            },
+        });
+        ops.push(nameTripleOp);
+    }
+    if (description) {
+        // set property "Description" to the provided description
+        const descriptionTripleOp = Triple.make({
+            entityId,
+            attributeId: DESCRIPTION_PROPERTY,
+            value: {
+                type: 'TEXT',
+                value: description,
+            },
+        });
+        ops.push(descriptionTripleOp);
+    }
+    if (cover) {
+        // add ID of cover "Image" to property "Cover"
+        assertValid(cover);
+        const relationOp = Relation.make({
+            fromId: entityId,
+            relationTypeId: COVER_PROPERTY,
+            toId: cover,
+        });
+        ops.push(relationOp);
+    }
+    return ops;
+};
+//# sourceMappingURL=create-default-properties.js.map

package/dist/src/graph/helpers/create-default-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-default-properties.js","sourceRoot":"","sources":["../../../../src/graph/helpers/create-default-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAgD,EAAE,EAAE;IAC1F,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,GAAG,GAAS,EAAE,CAAC;IAErB,IAAI,IAAI,EAAE,CAAC;QACT,2CAA2C;QAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;YAC/B,QAAQ;YACR,WAAW,EAAE,aAAa;YAC1B,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,IAAI;aACZ;SACF,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,yDAAyD;QACzD,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC;YACtC,QAAQ;YACR,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,WAAW;aACnB;SACF,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,8CAA8C;QAC9C,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,EAAE,QAAQ;YAChB,cAAc,EAAE,cAAc;YAC9B,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/src/graph/helpers/create-properties.d.ts

@@ -0,0 +1,8 @@
+import type { Op, PropertiesParam } from '../../types.js';
+type CreatePropertiesParams = {
+    entityId: string;
+    properties: PropertiesParam;
+};
+export declare const createProperties: (params: CreatePropertiesParams) => Op[];
+export {};
+//# sourceMappingURL=create-properties.d.ts.map

package/dist/src/graph/helpers/create-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-properties.d.ts","sourceRoot":"","sources":["../../../../src/graph/helpers/create-properties.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE1D,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,sBAAsB,SAgD9D,CAAC"}

package/dist/src/graph/helpers/create-properties.js

@@ -0,0 +1,53 @@
+import { assertValid, generate } from '../../id.js';
+import { Relation } from '../../relation.js';
+import { Triple } from '../../triple.js';
+export const createProperties = (params) => {
+    const { entityId, properties } = params;
+    const ops = [];
+    for (const [attributeId, property] of Object.entries(properties)) {
+        assertValid(attributeId);
+        if ('type' in property) {
+            const propertyTripleOp = Triple.make({
+                entityId,
+                attributeId,
+                value: property,
+            });
+            ops.push(propertyTripleOp);
+        }
+        else if ('to' in property) {
+            const relationId = property.relationId ?? generate();
+            assertValid(relationId);
+            assertValid(property.to);
+            const propertyRelationOp = Relation.make({
+                relationId,
+                fromId: entityId,
+                relationTypeId: attributeId,
+                toId: property.to,
+                position: property.position,
+            });
+            ops.push(propertyRelationOp);
+            if (property.properties) {
+                ops.push(...createProperties({ entityId, properties: property.properties }));
+            }
+        }
+        else if (Array.isArray(property)) {
+            for (const relation of property) {
+                const relationId = relation.relationId ?? generate();
+                assertValid(relationId);
+                assertValid(relation.to);
+                const propertyRelationOp = Relation.make({
+                    relationId,
+                    fromId: entityId,
+                    relationTypeId: attributeId,
+                    toId: relation.to,
+                });
+                ops.push(propertyRelationOp);
+                if (relation.properties) {
+                    ops.push(...createProperties({ entityId, properties: relation.properties }));
+                }
+            }
+        }
+    }
+    return ops;
+};
+//# sourceMappingURL=create-properties.js.map

package/dist/src/graph/helpers/create-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-properties.js","sourceRoot":"","sources":["../../../../src/graph/helpers/create-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAQzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAA8B,EAAE,EAAE;IACjE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IACxC,MAAM,GAAG,GAAS,EAAE,CAAC;IAErB,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;YACvB,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC;gBACnC,QAAQ;gBACR,WAAW;gBACX,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;YACrD,WAAW,CAAC,UAAU,CAAC,CAAC;YACxB,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC;gBACvC,UAAU;gBACV,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,WAAW;gBAC3B,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC7B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;gBACrD,WAAW,CAAC,UAAU,CAAC,CAAC;gBACxB,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACzB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC;oBACvC,UAAU;oBACV,MAAM,EAAE,QAAQ;oBAChB,cAAc,EAAE,WAAW;oBAC3B,IAAI,EAAE,QAAQ,CAAC,EAAE;iBAClB,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAC7B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC/E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/src/graphv2/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_API_HOST = "https://api-testnet.grc-20.thegraph.com";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/graphv2/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/graphv2/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,4CAA4C,CAAC"}

package/dist/src/graphv2/constants.js

@@ -0,0 +1,2 @@
+export const DEFAULT_API_HOST = 'https://api-testnet.grc-20.thegraph.com';
+//# sourceMappingURL=constants.js.map

package/dist/src/graphv2/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/graphv2/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,yCAAyC,CAAC"}

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

@@ -0,0 +1,52 @@
+import type { CreateResult, EntityParams } 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 } = 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 declare const createEntity: ({ id: providedId, name, description, cover, values, relations, types, }: EntityParams) => CreateResult;
+//# sourceMappingURL=create-entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity.d.ts","sourceRoot":"","sources":["../../../src/graphv2/create-entity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAA6B,MAAM,eAAe,CAAC;AAG3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,YAAY,GAAI,yEAQ1B,YAAY,KAAG,YA4FjB,CAAC"}

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":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAC3B,EAAE,EAAE,UAAU,EACd,IAAI,EACJ,WAAW,EACX,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,GACQ,EAAgB,EAAE;IAC/B,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACpC,IAAI,GAAG,GAAc,EAAE,CAAC;IAExB,MAAM,SAAS,GAAiB,EAAE,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC;YACnC,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC;YAC1C,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,SAAS,CAAC,IAAI,CAAC;YACb,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,GAAmB;QACzB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE;YACN,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;YAChB,MAAM,EAAE,SAAS;SAClB;KACF,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,IAAI,KAAK,EAAE,CAAC;QACV,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,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,EAAE,CAAC;gBACxB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;gBACzB,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;aAC/B;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC3B,WAAW,CAAC,MAAM,CAAC,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE;oBACR,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBACxB,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAC5B,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACxB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;iBAC/B;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;YACrD,WAAW,CAAC,UAAU,CAAC,CAAC;YACxB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;YACnD,WAAW,CAAC,gBAAgB,CAAC,CAAC;YAC9B,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC;gBAC1C,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC;gBAChB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,gBAAgB;gBAC1B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,eAAe,EAAE,QAAQ,CAAC,eAAe;gBACzC,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC,CAAC;YACH,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC,CAAC"}

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