@geoprotocol/geo-sdk 0.1.1

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

@@ -0,0 +1,42 @@
+import type { CreateResult, RelationParams } from '../types.js';
+/**
+ * Creates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createRelation({
+ *   id: relationId, // optional
+ *   fromEntity: entityId1,
+ *   toEntity: entityId2,
+ *   type: relationTypeId,
+ *   fromSpace: spaceId1, // optional
+ *   toSpace: spaceId2, // optional
+ *   fromVersion: versionId1, // optional
+ *   toVersion: versionId2, // optional
+ *   position: 'position of the relation', // optional
+ *   entityId: entityId3, // optional and will be generated if not provided
+ *   entityValues: [ // optional
+ *     { property: propertyId1, value: 'value1' },
+ *     { property: propertyId2, value: 'value2' },
+ *   ],
+ *   entityRelations: { // optional
+ *     relationTypeId1: {
+ *       toEntity: entityId3,
+ *       type: relationTypeId2,
+ *       toSpace: spaceId3,
+ *       toVersion: versionId3,
+ *       position: 'position of the relation',
+ *     },
+ *   },
+ *   entityTypes: [typeId1, typeId2], // optional
+ *   entityName: 'name of the relation entity', // optional
+ *   entityDescription: 'description of the relation entity', // optional
+ *   entityCover: imageEntityId, // optional
+ * });
+ * ```
+ * @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, fromSpace, toSpace, fromVersion, toVersion, type, entityId: providedEntityId, entityName, entityDescription, entityCover, entityValues, entityRelations, entityTypes, }: RelationParams) => CreateResult;
+//# sourceMappingURL=create-relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-relation.d.ts","sourceRoot":"","sources":["../../../src/graph/create-relation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,cAAc,GAAI,2NAiB5B,cAAc,KAAG,YA8DnB,CAAC"}

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

@@ -0,0 +1,110 @@
+import { createRelation as grcCreateRelation } from '@geoprotocol/grc-20';
+import { Id } from '../id.js';
+import { assertValid, generate, toGrcId } from '../id-utils.js';
+import { createEntity } from './create-entity.js';
+/**
+ * Creates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = createRelation({
+ *   id: relationId, // optional
+ *   fromEntity: entityId1,
+ *   toEntity: entityId2,
+ *   type: relationTypeId,
+ *   fromSpace: spaceId1, // optional
+ *   toSpace: spaceId2, // optional
+ *   fromVersion: versionId1, // optional
+ *   toVersion: versionId2, // optional
+ *   position: 'position of the relation', // optional
+ *   entityId: entityId3, // optional and will be generated if not provided
+ *   entityValues: [ // optional
+ *     { property: propertyId1, value: 'value1' },
+ *     { property: propertyId2, value: 'value2' },
+ *   ],
+ *   entityRelations: { // optional
+ *     relationTypeId1: {
+ *       toEntity: entityId3,
+ *       type: relationTypeId2,
+ *       toSpace: spaceId3,
+ *       toVersion: versionId3,
+ *       position: 'position of the relation',
+ *     },
+ *   },
+ *   entityTypes: [typeId1, typeId2], // optional
+ *   entityName: 'name of the relation entity', // optional
+ *   entityDescription: 'description of the relation entity', // optional
+ *   entityCover: imageEntityId, // optional
+ * });
+ * ```
+ * @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, fromSpace, toSpace, fromVersion, toVersion, type, entityId: providedEntityId, entityName, entityDescription, entityCover, entityValues, entityRelations, entityTypes, }) => {
+    if (providedId)
+        assertValid(providedId, '`id` in `createRelation`');
+    if (fromEntity)
+        assertValid(fromEntity, '`fromEntity` in `createRelation`');
+    if (toEntity)
+        assertValid(toEntity, '`toEntity` in `createRelation`');
+    if (fromSpace)
+        assertValid(fromSpace, '`fromSpace` in `createRelation`');
+    if (toSpace)
+        assertValid(toSpace, '`toSpace` in `createRelation`');
+    if (fromVersion)
+        assertValid(fromVersion, '`fromVersion` in `createRelation`');
+    if (toVersion)
+        assertValid(toVersion, '`toVersion` in `createRelation`');
+    if (type)
+        assertValid(type, '`type` in `createRelation`');
+    if (providedEntityId)
+        assertValid(providedEntityId, '`entityId` in `createRelation`');
+    if (entityCover)
+        assertValid(entityCover, '`entityCover` in `createRelation`');
+    for (const valueEntry of entityValues ?? []) {
+        assertValid(valueEntry.property, '`entityValues` in `createRelation`');
+        // Validate IDs in typed values
+        if (valueEntry.type === 'text' && valueEntry.language) {
+            assertValid(valueEntry.language, '`language` in `entityValues` in `createRelation`');
+        }
+        if (valueEntry.type === 'float64' && valueEntry.unit) {
+            assertValid(valueEntry.unit, '`unit` in `entityValues` in `createRelation`');
+        }
+    }
+    for (const [key] of Object.entries(entityRelations ?? {})) {
+        assertValid(key, '`entityRelations` in `createRelation`');
+    }
+    for (const type of entityTypes ?? []) {
+        assertValid(type, '`entityTypes` in `createRelation`');
+    }
+    const id = providedId ?? generate();
+    const entityId = providedEntityId ?? generate();
+    const ops = [];
+    ops.push(grcCreateRelation({
+        id: toGrcId(id),
+        entity: toGrcId(entityId),
+        from: toGrcId(fromEntity),
+        to: toGrcId(toEntity),
+        relationType: toGrcId(type),
+        ...(fromSpace ? { fromSpace: toGrcId(fromSpace) } : {}),
+        ...(fromVersion ? { fromVersion: toGrcId(fromVersion) } : {}),
+        ...(toSpace ? { toSpace: toGrcId(toSpace) } : {}),
+        ...(toVersion ? { toVersion: toGrcId(toVersion) } : {}),
+        ...(position !== undefined ? { position } : {}),
+    }));
+    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: Id(id), ops };
+};
+//# sourceMappingURL=create-relation.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,358 @@
+import { describe, expect, it } from 'vitest';
+import { CLAIM_TYPE, NEWS_STORY_TYPE } from '../core/ids/content.js';
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY, TYPES_PROPERTY } from '../core/ids/system.js';
+import { Id } from '../id.js';
+import { toGrcId } from '../id-utils.js';
+import { createRelation } from './create-relation.js';
+const isCreateRelationOp = (op) => {
+    return op.type === 'createRelation';
+};
+const isCreateEntityOp = (op) => {
+    return op.type === 'createEntity';
+};
+describe('createRelation', () => {
+    const fromEntityId = Id('30145d36d5a54244be593d111d879ba5');
+    const toEntityId = Id('b1dc6e5c63e143bab3d4755b251a4ea1');
+    const coverId = Id('fa269fd3de9849cf90c44235d905a67c');
+    const testSpaceId = Id('c1dc6e5c63e143bab3d4755b251a4ea2');
+    const fromSpaceId = Id('d1dc6e5c63e143bab3d4755b251a4ea3');
+    const fromVersionId = Id('e1dc6e5c63e143bab3d4755b251a4ea4');
+    const toVersionId = Id('f1dc6e5c63e143bab3d4755b251a4ea5');
+    it('creates a basic relation without additional properties', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+        });
+        expect(relation).toBeDefined();
+        expect(typeof relation.id).toBe('string');
+        expect(relation.ops).toBeDefined();
+        expect(relation.ops).toHaveLength(1); // One createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(isCreateRelationOp(relOp)).toBe(true);
+        expect(relOp.id).toEqual(toGrcId(relation.id));
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+    });
+    it('creates a relation with position and toSpace', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            position: '1',
+            toSpace: testSpaceId,
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(1);
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+        expect(relOp.position).toBe('1');
+        expect(relOp.toSpace).toEqual(toGrcId(testSpaceId));
+    });
+    it('creates a relation with fromSpace, fromVersion, and toVersion', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            fromSpace: fromSpaceId,
+            fromVersion: fromVersionId,
+            toVersion: toVersionId,
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(1);
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+        expect(relOp.fromSpace).toEqual(toGrcId(fromSpaceId));
+        expect(relOp.fromVersion).toEqual(toGrcId(fromVersionId));
+        expect(relOp.toVersion).toEqual(toGrcId(toVersionId));
+    });
+    it('creates a relation with all optional fields', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            position: '1',
+            fromSpace: fromSpaceId,
+            toSpace: testSpaceId,
+            fromVersion: fromVersionId,
+            toVersion: toVersionId,
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(1);
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.id).toEqual(toGrcId(relation.id));
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+        expect(relOp.position).toBe('1');
+        expect(relOp.fromSpace).toEqual(toGrcId(fromSpaceId));
+        expect(relOp.toSpace).toEqual(toGrcId(testSpaceId));
+        expect(relOp.fromVersion).toEqual(toGrcId(fromVersionId));
+        expect(relOp.toVersion).toEqual(toGrcId(toVersionId));
+    });
+    it('creates a relation with a provided id', async () => {
+        const providedId = Id('c1dc6e5c63e143bab3d4755b251a4ea1');
+        const relation = createRelation({
+            id: providedId,
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+        });
+        expect(relation).toBeDefined();
+        expect(relation.id).toBe(providedId);
+        expect(relation.ops).toHaveLength(1);
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.id).toEqual(toGrcId(providedId));
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+    });
+    it('creates a relation with an entity that has name and description', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityName: 'Test Entity',
+            entityDescription: 'Test Description',
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(2); // createRelation + createEntity
+        // Check createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        expect(relOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+        // Check createEntity op
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        expect(isCreateEntityOp(entityOp)).toBe(true);
+        // 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('Test Entity');
+        }
+        // Verify description value
+        const descValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(DESCRIPTION_PROPERTY)[i]);
+        });
+        expect(descValue).toBeDefined();
+        expect(descValue?.value.type).toBe('text');
+        if (descValue?.value.type === 'text') {
+            expect(descValue.value.value).toBe('Test Description');
+        }
+    });
+    it('creates a relation with an entity that has types', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityTypes: [CLAIM_TYPE, NEWS_STORY_TYPE],
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(4); // createRelation + createEntity + two type relations
+        // Check createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        // Check createEntity op
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        // Check type relations
+        const typeRel1 = relation.ops[2];
+        expect(typeRel1.type).toBe('createRelation');
+        expect(typeRel1.to).toEqual(toGrcId(CLAIM_TYPE));
+        expect(typeRel1.relationType).toEqual(toGrcId(TYPES_PROPERTY));
+        const typeRel2 = relation.ops[3];
+        expect(typeRel2.type).toBe('createRelation');
+        expect(typeRel2.to).toEqual(toGrcId(NEWS_STORY_TYPE));
+        expect(typeRel2.relationType).toEqual(toGrcId(TYPES_PROPERTY));
+    });
+    it('creates a relation with an entity that has a cover', async () => {
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityCover: coverId,
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(3); // createRelation + createEntity + cover relation
+        // Check createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        // Check createEntity op
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        // Check cover relation
+        const coverRel = relation.ops[2];
+        expect(coverRel.type).toBe('createRelation');
+        expect(coverRel.to).toEqual(toGrcId(coverId));
+        expect(coverRel.relationType).toEqual(toGrcId(COVER_PROPERTY));
+    });
+    it('throws an error if the provided id is invalid', () => {
+        expect(() => createRelation({
+            id: 'invalid',
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+        })).toThrow('Invalid id: "invalid" for `id` in `createRelation`');
+    });
+    it('throws an error if fromSpace is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            fromSpace: 'invalid',
+        })).toThrow('Invalid id: "invalid" for `fromSpace` in `createRelation`');
+    });
+    it('throws an error if fromVersion is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            fromVersion: 'invalid',
+        })).toThrow('Invalid id: "invalid" for `fromVersion` in `createRelation`');
+    });
+    it('throws an error if toVersion is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            toVersion: 'invalid',
+        })).toThrow('Invalid id: "invalid" for `toVersion` in `createRelation`');
+    });
+    it('creates a relation with entityValues', () => {
+        const customPropertyId = Id('fa269fd3de9849cf90c44235d905a67c');
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityValues: [{ property: customPropertyId, type: 'text', value: 'custom value' }],
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(2); // createRelation + createEntity
+        // Check createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        expect(relOp.from).toEqual(toGrcId(fromEntityId));
+        expect(relOp.to).toEqual(toGrcId(toEntityId));
+        // Check createEntity op with custom value
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        const customValue = entityOp.values.find(v => {
+            const propBytes = v.property;
+            return propBytes.every((b, i) => b === toGrcId(customPropertyId)[i]);
+        });
+        expect(customValue).toBeDefined();
+        expect(customValue?.value.type).toBe('text');
+        if (customValue?.value.type === 'text') {
+            expect(customValue.value.value).toBe('custom value');
+        }
+    });
+    it('creates a relation with entityValues that have language', () => {
+        const customPropertyId = Id('fa269fd3de9849cf90c44235d905a67c');
+        const languageId = Id('0a4e9810f78f429ea4ceb1904a43251d');
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityValues: [
+                {
+                    property: customPropertyId,
+                    type: 'text',
+                    value: 'test',
+                    language: languageId,
+                },
+            ],
+        });
+        expect(relation).toBeDefined();
+        expect(relation.ops).toHaveLength(2); // createRelation + createEntity
+        // Check createRelation op
+        const relOp = relation.ops[0];
+        expect(relOp.type).toBe('createRelation');
+        // Check createEntity op
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        const textValue = entityOp.values[0];
+        expect(textValue?.value.type).toBe('text');
+        if (textValue?.value.type === 'text') {
+            expect(textValue.value.value).toBe('test');
+            expect(textValue.value.language).toEqual(toGrcId(languageId));
+        }
+    });
+    it('throws an error if entityValues property is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityValues: [{ property: 'invalid', type: 'text', value: 'test' }],
+        })).toThrow('Invalid id: "invalid" for `entityValues` in `createRelation`');
+    });
+    it('throws an error if toSpace is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            toSpace: 'invalid',
+        })).toThrow('Invalid id: "invalid" for `toSpace` in `createRelation`');
+    });
+    it('throws an error if entityCover is invalid', () => {
+        expect(() => createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityCover: 'invalid',
+        })).toThrow('Invalid id: "invalid" for `entityCover` in `createRelation`');
+    });
+    it('creates a relation with entityRelations (nested relations)', () => {
+        const outerRelationType = Id('295c8bc61ae342cbb2a65b61080906ff');
+        const innerToEntityId = Id('a1dc6e5c63e143bab3d4755b251a4ea6');
+        const relation = createRelation({
+            fromEntity: fromEntityId,
+            toEntity: toEntityId,
+            type: NAME_PROPERTY,
+            entityRelations: {
+                [outerRelationType]: {
+                    toEntity: innerToEntityId,
+                },
+            },
+        });
+        expect(relation).toBeDefined();
+        // 1 createRelation (main) + 1 createEntity (main entity) + 1 createRelation (nested)
+        expect(relation.ops).toHaveLength(3);
+        // Check main createRelation op
+        const mainRelOp = relation.ops[0];
+        expect(mainRelOp.type).toBe('createRelation');
+        expect(mainRelOp.from).toEqual(toGrcId(fromEntityId));
+        expect(mainRelOp.to).toEqual(toGrcId(toEntityId));
+        expect(mainRelOp.relationType).toEqual(toGrcId(NAME_PROPERTY));
+        // Check main createEntity op
+        const entityOp = relation.ops[1];
+        expect(entityOp.type).toBe('createEntity');
+        // Check nested createRelation op
+        const nestedRelOp = relation.ops[2];
+        expect(nestedRelOp.type).toBe('createRelation');
+        expect(nestedRelOp.to).toEqual(toGrcId(innerToEntityId));
+        expect(nestedRelOp.relationType).toEqual(toGrcId(outerRelationType));
+    });
+});
+//# sourceMappingURL=create-relation.test.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { Op } from '@geoprotocol/grc-20';
+import { Id } from '../id.js';
+import type { Network } from '../types.js';
+type CreateSpaceParams = {
+    editorAddress: string;
+    name: string;
+    network?: Network;
+    ops?: Op[];
+    spaceEntityId?: string;
+    /**
+     * Select which contracts to deploy based on the governance type.
+     * If no governance type is provided it defaults to PERSONAL
+     */
+    governanceType?: 'PUBLIC' | 'PERSONAL';
+};
+/**
+ * Creates a space with the given name and editor address.
+ *
+ * @example
+ * ```ts
+ * const { id } = await createSpace({
+ *   editorAddress: '0x1234567890123456789012345678901234567890',
+ *   name: 'My Space',
+ *   network: 'TESTNET', // optional, defaults to 'TESTNET'
+ *   spaceEntityId: '1234567890123456789012345678901234567890', // optional
+ *   governanceType: 'PUBLIC', // optional, defaults to 'PERSONAL'
+ *   ops: [], // optional
+ * });
+ * ```
+ * @param params – {@link CreateSpaceParams}
+ * @returns – {@link Id}
+ */
+export declare const createSpace: (params: CreateSpaceParams) => Promise<{
+    id: Id;
+}>;
+export {};
+//# sourceMappingURL=create-space.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-space.d.ts","sourceRoot":"","sources":["../../../src/graph/create-space.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,KAAK,iBAAiB,GAAG;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACxC,CAAC;AAkBF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAU,QAAQ,iBAAiB;;EAsD1D,CAAC"}