@geoprotocol/geo-sdk 0.1.1

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

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

package/dist/src/graphv2/unset-relation-fields.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest';
+import { Id, toBase64 } from '../idv2.js';
+import { unsetRelationFields } from './unset-relation-fields.js';
+describe('unsetRelationFields', () => {
+    it('should create an unset relation operation with valid parameters', () => {
+        const id = Id('5cade575-7ecd-41ae-8348-1b22ffc2f94e');
+        const fromVersion = true;
+        const toSpace = true;
+        const toVersion = true;
+        const position = true;
+        const verified = true;
+        const result = unsetRelationFields({
+            id,
+            fromVersion,
+            toSpace,
+            toVersion,
+            position,
+            verified,
+        });
+        expect(result).toEqual({
+            id,
+            ops: [
+                {
+                    type: 'UNSET_RELATION_FIELDS',
+                    unsetRelationFields: {
+                        id: toBase64(id),
+                        fromVersion,
+                        toSpace,
+                        toVersion,
+                        position,
+                        verified,
+                    },
+                },
+            ],
+        });
+    });
+    it('should handle optional parameters', () => {
+        const id = Id('5cade575-7ecd-41ae-8348-1b22ffc2f94e');
+        const toSpace = true;
+        const position = true;
+        const verified = true;
+        const result = unsetRelationFields({
+            id,
+            toSpace,
+            position,
+            verified,
+        });
+        expect(result).toEqual({
+            id,
+            ops: [
+                {
+                    type: 'UNSET_RELATION_FIELDS',
+                    unsetRelationFields: {
+                        id: toBase64(id),
+                        toSpace,
+                        position,
+                        verified,
+                    },
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=unset-relation-fields.test.js.map

package/dist/src/graphv2/unset-relation-fields.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset-relation-fields.test.js","sourceRoot":"","sources":["../../../src/graphv2/unset-relation-fields.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,EAAE,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;QAEtB,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,EAAE;YACF,WAAW;YACX,OAAO;YACP,SAAS;YACT,QAAQ;YACR,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE;YACF,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,uBAAuB;oBAC7B,mBAAmB,EAAE;wBACnB,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;wBAChB,WAAW;wBACX,OAAO;wBACP,SAAS;wBACT,QAAQ;wBACR,QAAQ;qBACT;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;QAEtB,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,EAAE;YACF,OAAO;YACP,QAAQ;YACR,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE;YACF,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,uBAAuB;oBAC7B,mBAAmB,EAAE;wBACnB,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;wBAChB,OAAO;wBACP,QAAQ;wBACR,QAAQ;qBACT;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { CreateResult, UpdateEntityParams } from '../typesv2.js';
+/**
+ * Updates an entity with the given name, description, cover and properties.
+ * All IDs passed to this function (cover, property IDs) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = updateEntity({
+ *   id: entityId,
+ *   name: 'name of the entity',
+ *   description: 'description of the entity',
+ *   cover: imageEntityId,
+ *   values: {
+ *     // value property like text, number, url, time, point, checkbox
+ *     [propertyId]: {
+ *       type: 'TEXT', // TEXT | NUMBER | URL | TIME | POINT | CHECKBOX,
+ *       value: 'value of the property',
+ *     }
+ *   },
+ * });
+ * ```
+ * @param params – {@link UpdateEntityParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export declare const updateEntity: ({ id, name, description, cover, values }: UpdateEntityParams) => CreateResult;
+//# sourceMappingURL=update-entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.d.ts","sourceRoot":"","sources":["../../../src/graphv2/update-entity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAsB,kBAAkB,EAAS,MAAM,eAAe,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,YAAY,GAAI,0CAA0C,kBAAkB,KAAG,YAgD3F,CAAC"}

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

@@ -0,0 +1,73 @@
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY } from '../core/idsv2/system.js';
+import { Id, assertValid, generate, toBase64 } from '../idv2.js';
+/**
+ * Updates an entity with the given name, description, cover and properties.
+ * All IDs passed to this function (cover, property IDs) are validated.
+ * If any invalid ID is provided, the function will throw an error.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = updateEntity({
+ *   id: entityId,
+ *   name: 'name of the entity',
+ *   description: 'description of the entity',
+ *   cover: imageEntityId,
+ *   values: {
+ *     // value property like text, number, url, time, point, checkbox
+ *     [propertyId]: {
+ *       type: 'TEXT', // TEXT | NUMBER | URL | TIME | POINT | CHECKBOX,
+ *       value: 'value of the property',
+ *     }
+ *   },
+ * });
+ * ```
+ * @param params – {@link UpdateEntityParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export const updateEntity = ({ id, name, description, cover, values }) => {
+    assertValid(id, '`id` in `updateEntity`');
+    const 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(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(id)),
+                toEntity: toBase64(Id(cover)),
+                type: toBase64(COVER_PROPERTY),
+            },
+        });
+    }
+    return { id, ops };
+};
+//# sourceMappingURL=update-entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-entity.js","sourceRoot":"","sources":["../../../src/graphv2/update-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAsB,EAAgB,EAAE;IACzG,WAAW,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAc,EAAE,CAAC;IAE1B,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,EAAE,CAAC,CAAC;YACpB,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,EAAE,CAAC,CAAC;gBAC5B,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC;aAC/B;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,116 @@
+import { describe, expect, it } from 'vitest';
+import { COVER_PROPERTY, DESCRIPTION_PROPERTY, NAME_PROPERTY } from '../core/idsv2/system.js';
+import { Id, toBase64 } from '../idv2.js';
+import { updateEntity } from './update-entity.js';
+describe('updateEntity', () => {
+    const entityId = Id('b1dc6e5c-63e1-43ba-b3d4-755b251a4ea1');
+    const coverId = Id('30145d36-d5a5-4244-be59-3d111d879ba5');
+    it('updates an entity with name and description', async () => {
+        const result = updateEntity({
+            id: entityId,
+            name: 'Updated Entity',
+            description: 'Updated Description',
+        });
+        expect(result).toBeDefined();
+        expect(result.id).toBe(entityId);
+        expect(result.ops).toHaveLength(1);
+        expect(result.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entityId),
+                values: [
+                    {
+                        propertyId: toBase64(NAME_PROPERTY),
+                        value: 'Updated Entity',
+                    },
+                    {
+                        propertyId: toBase64(DESCRIPTION_PROPERTY),
+                        value: 'Updated Description',
+                    },
+                ],
+            },
+        });
+    });
+    it('updates an entity with only name', async () => {
+        const result = updateEntity({
+            id: entityId,
+            name: 'Updated Entity',
+        });
+        expect(result).toBeDefined();
+        expect(result.id).toBe(entityId);
+        expect(result.ops).toHaveLength(1);
+        expect(result.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entityId),
+                values: [
+                    {
+                        propertyId: toBase64(NAME_PROPERTY),
+                        value: 'Updated Entity',
+                    },
+                ],
+            },
+        });
+    });
+    it('updates an entity with cover', async () => {
+        const result = updateEntity({
+            id: entityId,
+            cover: coverId,
+        });
+        expect(result).toBeDefined();
+        expect(result.id).toBe(entityId);
+        expect(result.ops).toHaveLength(2);
+        // Check UPDATE_ENTITY op
+        expect(result.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entityId),
+                values: [],
+            },
+        });
+        // Check cover relation
+        expect(result.ops[1]).toMatchObject({
+            type: 'CREATE_RELATION',
+            relation: {
+                fromEntity: toBase64(entityId),
+                toEntity: toBase64(coverId),
+                type: toBase64(COVER_PROPERTY),
+            },
+        });
+    });
+    it('updates an entity with custom values', async () => {
+        const customPropertyId = Id('fa269fd3-de98-49cf-90c4-4235d905a67c');
+        const result = updateEntity({
+            id: entityId,
+            values: {
+                [customPropertyId]: {
+                    value: 'updated custom value',
+                },
+            },
+        });
+        expect(result).toBeDefined();
+        expect(result.id).toBe(entityId);
+        expect(result.ops).toHaveLength(1);
+        expect(result.ops[0]).toMatchObject({
+            type: 'UPDATE_ENTITY',
+            entity: {
+                id: toBase64(entityId),
+                values: [
+                    {
+                        propertyId: toBase64(customPropertyId),
+                        value: 'updated custom value',
+                    },
+                ],
+            },
+        });
+    });
+    it('throws an error if the provided id is invalid', () => {
+        // @ts-expect-error - invalid id type
+        expect(() => updateEntity({ id: 'invalid' })).toThrow('Invalid id: "invalid" for `id` in `updateEntity`');
+    });
+    it('throws an error if the provided cover id is invalid', () => {
+        // @ts-expect-error - invalid cover id type
+        expect(() => updateEntity({ id: entityId, cover: 'invalid' })).toThrow('Invalid id: "invalid"');
+    });
+});
+//# sourceMappingURL=update-entity.test.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { CreateResult, UpdateRelationParams } from '../typesv2.js';
+/**
+ * Updates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = updateRelation({
+ *   id: relationId,
+ *   position: 'position of the relation',
+ *   toSpace: 'id of the to space',
+ *   fromVersion: 'id of the from version',
+ *   toVersion: 'id of the to version',
+ *   verified: true,
+ * });
+ * ```
+ * @param params – {@link UpdateRelationParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export declare const updateRelation: ({ id, position, fromSpace, toSpace, fromVersion, toVersion, verified, }: UpdateRelationParams) => CreateResult;
+//# sourceMappingURL=update-relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-relation.d.ts","sourceRoot":"","sources":["../../../src/graphv2/update-relation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAM,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,GAAI,yEAQ5B,oBAAoB,KAAG,YAmBzB,CAAC"}

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

@@ -0,0 +1,37 @@
+import { assertValid, toBase64 } from '../idv2.js';
+/**
+ * Updates a relation.
+ *
+ * @example
+ * ```ts
+ * const { id, ops } = updateRelation({
+ *   id: relationId,
+ *   position: 'position of the relation',
+ *   toSpace: 'id of the to space',
+ *   fromVersion: 'id of the from version',
+ *   toVersion: 'id of the to version',
+ *   verified: true,
+ * });
+ * ```
+ * @param params – {@link UpdateRelationParams}
+ * @returns – {@link CreateResult}
+ * @throws Will throw an error if any provided ID is invalid
+ */
+export const updateRelation = ({ id, position, fromSpace, toSpace, fromVersion, toVersion, verified, }) => {
+    assertValid(id, '`id` in `updateRelation`');
+    const ops = [];
+    ops.push({
+        type: 'UPDATE_RELATION',
+        relation: {
+            id: toBase64(id),
+            position,
+            fromSpace: fromSpace ? toBase64(fromSpace) : undefined,
+            toSpace: toSpace ? toBase64(toSpace) : undefined,
+            fromVersion: fromVersion ? toBase64(fromVersion) : undefined,
+            toVersion: toVersion ? toBase64(toVersion) : undefined,
+            verified,
+        },
+    });
+    return { id, ops };
+};
+//# sourceMappingURL=update-relation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-relation.js","sourceRoot":"","sources":["../../../src/graphv2/update-relation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,EAAE,EACF,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,GACa,EAAgB,EAAE;IACvC,WAAW,CAAC,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAE5C,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,QAAQ;YACR,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACtD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAChD,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YACtD,QAAQ;SACT;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC,CAAC"}

package/dist/src/id-utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This module provides utility functions for working knowledge graph
+ * identifiers in TypeScript.
+ */
+import { type Id as GrcId } from '@geoprotocol/grc-20';
+import { Brand } from 'effect';
+import { Id, isValid } from './id.js';
+export { isValid };
+export type { GrcId };
+export type IdBase64 = string & Brand.Brand<'IdBase64'>;
+export declare const IdBase64: Brand.Brand.Constructor<IdBase64>;
+/**
+ * Generates a globally unique knowledge graph identifier.
+ *
+ * @example
+ * ```
+ * import { Id } from '@geoprotocol/geo-sdk'
+ *
+ * const id = Id.generate();
+ * console.log(id)
+ * ```
+ *
+ * @returns dashless v4 UUID (32 hex characters without dashes)
+ */
+export declare function generate(): Id;
+export declare function isValidBase64(id: string): boolean;
+export declare function assertValid(id: string, sourceHint?: string): void;
+export declare function toBytes(id: Id | string): Uint8Array;
+export declare function fromBytes(bytes: Uint8Array): Id;
+/**
+ * Converts a local string Id to a GRC-20 Id (Uint8Array).
+ */
+export declare function toGrcId(id: Id | string): GrcId;
+export declare function toBase64(id: Id): IdBase64;
+export declare function fromBase64(id: IdBase64): Id;
+//# sourceMappingURL=id-utils.d.ts.map

package/dist/src/id-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-utils.d.ts","sourceRoot":"","sources":["../../src/id-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,EAAW,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EAAE,KAAK,EAAE,CAAC;AACtB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ,mCAGpB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,IAAI,EAAE,CAG7B;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQjD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,QAI1D;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,GAAG,UAAU,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,GAAG,KAAK,CAQ9C;AAID,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,CAoBzC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,EAAE,CAqB3C"}

package/dist/src/id-utils.js

@@ -0,0 +1,100 @@
+/**
+ * This module provides utility functions for working knowledge graph
+ * identifiers in TypeScript.
+ */
+import { parseId } from '@geoprotocol/grc-20';
+import { Brand } from 'effect';
+import { parse as uuidParse, stringify as uuidStringify, v4 as uuidv4 } from 'uuid';
+import { Id, isValid } from './id.js';
+import { normalizeUuidForParse } from './internal/uuid.js';
+export { isValid };
+export const IdBase64 = Brand.refined(id => isValidBase64(id), id => Brand.error(`Expected ${id} to be a valid IdBase64`));
+/**
+ * Generates a globally unique knowledge graph identifier.
+ *
+ * @example
+ * ```
+ * import { Id } from '@geoprotocol/geo-sdk'
+ *
+ * const id = Id.generate();
+ * console.log(id)
+ * ```
+ *
+ * @returns dashless v4 UUID (32 hex characters without dashes)
+ */
+export function generate() {
+    const uuid = uuidv4().replaceAll('-', '');
+    return Id(uuid);
+}
+export function isValidBase64(id) {
+    try {
+        // @ts-expect-error
+        const uuid = fromBase64(id);
+        return isValid(uuid);
+    }
+    catch (_error) {
+        return false;
+    }
+}
+export function assertValid(id, sourceHint) {
+    if (!isValid(id)) {
+        throw new Error(`Invalid id: "${id}"${sourceHint ? ` for ${sourceHint}` : ''}`);
+    }
+}
+export function toBytes(id) {
+    return uuidParse(normalizeUuidForParse(id));
+}
+export function fromBytes(bytes) {
+    return Id(uuidStringify(bytes).replaceAll('-', ''));
+}
+/**
+ * Converts a local string Id to a GRC-20 Id (Uint8Array).
+ */
+export function toGrcId(id) {
+    // Try to parse as a UUID string first
+    const parsed = parseId(id);
+    if (parsed) {
+        return parsed;
+    }
+    // Fallback: use the toBytes helper
+    return toBytes(id);
+}
+const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+export function toBase64(id) {
+    const bytes = toBytes(id);
+    let result = '';
+    let i;
+    for (i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i];
+        const b = bytes[i + 1] ?? 0;
+        const c = bytes[i + 2] ?? 0;
+        // @ts-expect-error
+        const triple = (a << 16) | (b << 8) | c;
+        result += base64Chars[(triple >> 18) & 0x3f];
+        result += base64Chars[(triple >> 12) & 0x3f];
+        result += i + 1 < bytes.length ? base64Chars[(triple >> 6) & 0x3f] : '=';
+        result += i + 2 < bytes.length ? base64Chars[triple & 0x3f] : '=';
+    }
+    return IdBase64(result);
+}
+export function fromBase64(id) {
+    const bytes = [];
+    for (let i = 0; i < id.length; i += 4) {
+        // @ts-expect-error
+        const c1 = base64Chars.indexOf(id[i]);
+        // @ts-expect-error
+        const c2 = base64Chars.indexOf(id[i + 1]);
+        // @ts-expect-error
+        const c3 = base64Chars.indexOf(id[i + 2]);
+        // @ts-expect-error
+        const c4 = base64Chars.indexOf(id[i + 3]);
+        const triple = (c1 << 18) | (c2 << 12) | ((c3 & 63) << 6) | (c4 & 63);
+        bytes.push((triple >> 16) & 0xff);
+        if (c3 !== -1 && c3 !== 64)
+            bytes.push((triple >> 8) & 0xff);
+        if (c4 !== -1 && c4 !== 64)
+            bytes.push(triple & 0xff);
+    }
+    return fromBytes(new Uint8Array(bytes));
+}
+//# sourceMappingURL=id-utils.js.map

package/dist/src/id-utils.js.map

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

package/dist/src/id-utils.test.d.ts

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

package/dist/src/id-utils.test.d.ts.map

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

package/dist/src/id-utils.test.js

@@ -0,0 +1,33 @@
+import { expect, it } from 'vitest';
+import { Id } from './id.js';
+import { fromBase64, fromBytes, generate, IdBase64, toBase64, toBytes } from './id-utils.js';
+it('should generate valid uuid', () => {
+    const id = generate();
+    expect(id).toBeTypeOf('string');
+    expect(id.length).toBe(32);
+    expect(id).toMatch(/^[0-9a-fA-F]{32}$/);
+});
+it('should convert id to base64', () => {
+    const id = Id('3af3e22d-2169-4a07-8681-516710b7ecf1');
+    const base64 = toBase64(id);
+    expect(base64).toBeTypeOf('string');
+    expect(base64).toBe('OvPiLSFpSgeGgVFnELfs8Q==');
+    expect(toBase64(Id('1d501a3a-d6ce-4693-bc90-d25286f21c7e'))).toBe('HVAaOtbORpO8kNJShvIcfg==');
+});
+it('should accept dashless UUID for toBytes and return dashless UUID from fromBytes', () => {
+    const dashed = '3af3e22d-2169-4a07-8681-516710b7ecf1';
+    const dashless = '3af3e22d21694a078681516710b7ecf1';
+    expect(fromBytes(toBytes(dashed))).toBe(dashless);
+    expect(fromBytes(toBytes(dashless))).toBe(dashless);
+});
+it('should decode base64 to dashless UUID and keep base64 stable for dashless UUID input', () => {
+    // Same UUID, two input formats.
+    const dashed = Id('3af3e22d-2169-4a07-8681-516710b7ecf1');
+    const dashless = Id('3af3e22d21694a078681516710b7ecf1');
+    // toBase64 should not depend on whether the UUID contains dashes.
+    expect(toBase64(dashed)).toBe('OvPiLSFpSgeGgVFnELfs8Q==');
+    expect(toBase64(dashless)).toBe('OvPiLSFpSgeGgVFnELfs8Q==');
+    // fromBase64 should decode to an Id (canonical form is dashless).
+    expect(fromBase64(IdBase64('OvPiLSFpSgeGgVFnELfs8Q=='))).toBe('3af3e22d21694a078681516710b7ecf1');
+});
+//# sourceMappingURL=id-utils.test.js.map

package/dist/src/id-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-utils.test.js","sourceRoot":"","sources":["../../src/id-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7F,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACpC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACrC,MAAM,EAAE,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAChD,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,sCAAsC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAChG,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;IACzF,MAAM,MAAM,GAAG,sCAAsC,CAAC;IACtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC;IAEpD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;IAC9F,gCAAgC;IAChC,MAAM,MAAM,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,EAAE,CAAC,kCAAkC,CAAC,CAAC;IAExD,kEAAkE;IAClE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1D,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAE5D,kEAAkE;IAClE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;AACpG,CAAC,CAAC,CAAC"}

package/dist/src/id.d.ts

@@ -0,0 +1,11 @@
+import { Brand } from 'effect';
+/**
+ * A globally unique knowledge graph identifier.
+ *
+ * Canonical form is a UUID v4 **without dashes** (32 hex chars).
+ * For compatibility, UUIDs **with dashes** are also accepted anywhere an `Id` is validated.
+ */
+export type Id = string & Brand.Brand<'Id'>;
+export declare const Id: Brand.Brand.Constructor<Id>;
+export declare function isValid(id: string): boolean;
+//# sourceMappingURL=id.d.ts.map

package/dist/src/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAE5C,eAAO,MAAM,EAAE,6BAGd,CAAC;AAEF,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAO3C"}

package/dist/src/id.js

@@ -0,0 +1,13 @@
+import { Brand } from 'effect';
+import { validate as uuidValidate } from 'uuid';
+import { dashlessUuidToDashed } from './internal/uuid.js';
+export const Id = Brand.refined(id => isValid(id), id => Brand.error(`Expected ${id} to be a valid Id`));
+export function isValid(id) {
+    if (uuidValidate(id))
+        return true;
+    const dashed = dashlessUuidToDashed(id);
+    if (!dashed)
+        return false;
+    return uuidValidate(dashed);
+}
+//# sourceMappingURL=id.js.map

package/dist/src/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAU1D,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAC7B,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EACjB,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,mBAAmB,CAAC,CACrD,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,IAAI,YAAY,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

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

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

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

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

package/dist/src/id.test.js

@@ -0,0 +1,14 @@
+import { expect, it } from 'vitest';
+import { generate, isValid } from './id-utils.js';
+it('should validate uuid', () => {
+    expect(isValid(generate())).toBe(true);
+    expect(isValid(generate())).toBe(true);
+    expect(isValid(generate())).toBe(true);
+    expect(isValid('3af3e22d-2169-4a07-8681-516710b7ecf1')).toBe(true);
+    expect(isValid('3af3e22d21694a078681516710b7ecf1')).toBe(true);
+});
+it('should not validate invalid id', () => {
+    expect(isValid('invalid-id')).toBe(false);
+    expect(isValid('0123456789012345678901')).toBe(false);
+});
+//# sourceMappingURL=id.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.test.js","sourceRoot":"","sources":["../../src/id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAElD,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAC9B,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;IACxC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC"}