@geoprotocol/grc-20 0.1.0

package/dist/genesis/index.js

@@ -0,0 +1,183 @@
+import { derivedUuidFromString } from "../util/id.js";
+/**
+ * Derives a genesis ID from a name.
+ *
+ * ```
+ * id = derived_uuid("grc20:genesis:" + name)
+ * ```
+ */
+export function genesisId(name) {
+    return derivedUuidFromString(`grc20:genesis:${name}`);
+}
+/**
+ * Derives a language ID from a BCP 47 language code.
+ *
+ * ```
+ * id = derived_uuid("grc20:genesis:language:" + code)
+ * ```
+ */
+export function languageId(code) {
+    return derivedUuidFromString(`grc20:genesis:language:${code.toLowerCase()}`);
+}
+// =============================================================================
+// CORE PROPERTIES (Section 7.1)
+// =============================================================================
+/**
+ * Well-known property IDs from the Genesis Space.
+ */
+export const properties = {
+    /** Name property - primary label (TEXT) */
+    get NAME() {
+        return genesisId("Name");
+    },
+    /** Description property - summary text (TEXT) */
+    get DESCRIPTION() {
+        return genesisId("Description");
+    },
+    /** Avatar property - image URL (TEXT) */
+    get AVATAR() {
+        return genesisId("Avatar");
+    },
+    /** URL property - external link (TEXT) */
+    get URL() {
+        return genesisId("URL");
+    },
+    /** Created property - creation time (TIMESTAMP) */
+    get CREATED() {
+        return genesisId("Created");
+    },
+    /** Modified property - last modification (TIMESTAMP) */
+    get MODIFIED() {
+        return genesisId("Modified");
+    },
+    // Helper functions
+    name: () => genesisId("Name"),
+    description: () => genesisId("Description"),
+    avatar: () => genesisId("Avatar"),
+    url: () => genesisId("URL"),
+    created: () => genesisId("Created"),
+    modified: () => genesisId("Modified"),
+};
+// =============================================================================
+// CORE TYPES (Section 7.2)
+// =============================================================================
+/**
+ * Well-known type entity IDs from the Genesis Space.
+ */
+export const types = {
+    /** Person type - human individual */
+    get PERSON() {
+        return genesisId("Person");
+    },
+    /** Organization type - company, DAO, institution */
+    get ORGANIZATION() {
+        return genesisId("Organization");
+    },
+    /** Place type - geographic location */
+    get PLACE() {
+        return genesisId("Place");
+    },
+    /** Topic type - subject or concept */
+    get TOPIC() {
+        return genesisId("Topic");
+    },
+    // Helper functions
+    person: () => genesisId("Person"),
+    organization: () => genesisId("Organization"),
+    place: () => genesisId("Place"),
+    topic: () => genesisId("Topic"),
+};
+// =============================================================================
+// CORE RELATION TYPES (Section 7.3)
+// =============================================================================
+/**
+ * Well-known relation type IDs from the Genesis Space.
+ */
+export const relationTypes = {
+    /** Types relation - type membership */
+    get TYPES() {
+        return genesisId("Types");
+    },
+    /** PartOf relation - composition/containment */
+    get PART_OF() {
+        return genesisId("PartOf");
+    },
+    /** RelatedTo relation - generic association */
+    get RELATED_TO() {
+        return genesisId("RelatedTo");
+    },
+    // Helper functions
+    types: () => genesisId("Types"),
+    partOf: () => genesisId("PartOf"),
+    relatedTo: () => genesisId("RelatedTo"),
+};
+// =============================================================================
+// LANGUAGES (Section 7.4)
+// =============================================================================
+/**
+ * Well-known language IDs from the Genesis Space.
+ */
+export const languages = {
+    get ENGLISH() {
+        return languageId("en");
+    },
+    get SPANISH() {
+        return languageId("es");
+    },
+    get FRENCH() {
+        return languageId("fr");
+    },
+    get GERMAN() {
+        return languageId("de");
+    },
+    get CHINESE() {
+        return languageId("zh");
+    },
+    get CHINESE_HANS() {
+        return languageId("zh-hans");
+    },
+    get CHINESE_HANT() {
+        return languageId("zh-hant");
+    },
+    get JAPANESE() {
+        return languageId("ja");
+    },
+    get KOREAN() {
+        return languageId("ko");
+    },
+    get PORTUGUESE() {
+        return languageId("pt");
+    },
+    get ITALIAN() {
+        return languageId("it");
+    },
+    get RUSSIAN() {
+        return languageId("ru");
+    },
+    get ARABIC() {
+        return languageId("ar");
+    },
+    get HINDI() {
+        return languageId("hi");
+    },
+    // Helper functions
+    english: () => languageId("en"),
+    spanish: () => languageId("es"),
+    french: () => languageId("fr"),
+    german: () => languageId("de"),
+    chinese: () => languageId("zh"),
+    chineseHans: () => languageId("zh-hans"),
+    chineseHant: () => languageId("zh-hant"),
+    japanese: () => languageId("ja"),
+    korean: () => languageId("ko"),
+    portuguese: () => languageId("pt"),
+    italian: () => languageId("it"),
+    russian: () => languageId("ru"),
+    arabic: () => languageId("ar"),
+    hindi: () => languageId("hi"),
+    /**
+     * Returns the language ID for the given BCP 47 code.
+     */
+    fromCode: (code) => languageId(code),
+};
+//# sourceMappingURL=index.js.map

package/dist/genesis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/genesis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAW,MAAM,eAAe,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,qBAAqB,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,qBAAqB,CAAC,0BAA0B,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2CAA2C;IAC3C,IAAI,IAAI;QACN,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACjD,IAAI,WAAW;QACb,OAAO,SAAS,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM;QACR,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,0CAA0C;IAC1C,IAAI,GAAG;QACL,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,mDAAmD;IACnD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,wDAAwD;IACxD,IAAI,QAAQ;QACV,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,mBAAmB;IACnB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC;IAC7B,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC;IAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;IAC3B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC;IACnC,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;CACtC,CAAC;AAEF,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,qCAAqC;IACrC,IAAI,MAAM;QACR,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,oDAAoD;IACpD,IAAI,YAAY;QACd,OAAO,SAAS,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,uCAAuC;IACvC,IAAI,KAAK;QACP,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK;QACP,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC;IAC7C,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;CAChC,CAAC;AAEF,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,uCAAuC;IACvC,IAAI,KAAK;QACP,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,gDAAgD;IAChD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,+CAA+C;IAC/C,IAAI,UAAU;QACZ,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED,mBAAmB;IACnB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;CACxC,CAAC;AAEF,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,OAAO;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,YAAY;QACd,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,YAAY;QACd,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,UAAU;QACZ,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK;QACP,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,mBAAmB;IACnB,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/B,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;IACxC,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;IACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAChC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAClC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;CAC7C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GRC-20 v2 TypeScript SDK
+ *
+ * Binary property graph format for decentralized knowledge networks.
+ *
+ * @packageDocumentation
+ */
+export * from "./types/index.js";
+export * from "./builder/index.js";
+export * from "./util/index.js";
+export { genesisId, languageId, properties, types, relationTypes, languages, } from "./genesis/index.js";
+export { encodeEdit, decodeEdit, type EncodeOptions, Writer, Reader, DecodeError, } from "./codec/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,EACL,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,aAAa,EAClB,MAAM,EACN,MAAM,EACN,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * GRC-20 v2 TypeScript SDK
+ *
+ * Binary property graph format for decentralized knowledge networks.
+ *
+ * @packageDocumentation
+ */
+// Types
+export * from "./types/index.js";
+// Builders
+export * from "./builder/index.js";
+// Utilities
+export * from "./util/index.js";
+// Genesis (well-known IDs)
+export { genesisId, languageId, properties, types, relationTypes, languages, } from "./genesis/index.js";
+// Codec
+export { encodeEdit, decodeEdit, Writer, Reader, DecodeError, } from "./codec/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,WAAW;AACX,cAAc,oBAAoB,CAAC;AAEnC,YAAY;AACZ,cAAc,iBAAiB,CAAC;AAEhC,2BAA2B;AAC3B,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,EACL,aAAa,EACb,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,OAAO,EACL,UAAU,EACV,UAAU,EAEV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/test/basic.test.d.ts

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

package/dist/test/basic.test.d.ts.map

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

package/dist/test/basic.test.js

@@ -0,0 +1,270 @@
+import { describe, it, expect } from "vitest";
+import { EditBuilder, encodeEdit, decodeEdit, parseId, formatId, randomId, derivedUuid, derivedUuidFromString, uniqueRelationId, relationEntityId, properties, relationTypes, languages, DataType, idsEqual, } from "../index.js";
+describe("ID utilities", () => {
+    it("formatId produces 32 hex chars", () => {
+        const id = randomId();
+        const hex = formatId(id);
+        expect(hex.length).toBe(32);
+        expect(/^[0-9a-f]{32}$/.test(hex)).toBe(true);
+    });
+    it("parseId roundtrips with formatId", () => {
+        const id = randomId();
+        const hex = formatId(id);
+        const parsed = parseId(hex);
+        expect(parsed).toBeDefined();
+        expect(idsEqual(id, parsed)).toBe(true);
+    });
+    it("parseId accepts hyphens", () => {
+        const withHyphens = "550e8400-e29b-41d4-a716-446655440000";
+        const withoutHyphens = "550e8400e29b41d4a716446655440000";
+        const id1 = parseId(withHyphens);
+        const id2 = parseId(withoutHyphens);
+        expect(id1).toBeDefined();
+        expect(id2).toBeDefined();
+        expect(idsEqual(id1, id2)).toBe(true);
+    });
+    it("derivedUuid is deterministic", () => {
+        const input = new TextEncoder().encode("test");
+        const id1 = derivedUuid(input);
+        const id2 = derivedUuid(input);
+        expect(idsEqual(id1, id2)).toBe(true);
+    });
+    it("derivedUuid produces valid UUIDv8", () => {
+        const id = derivedUuidFromString("test");
+        // Version 8 in byte 6
+        expect((id[6] & 0xf0)).toBe(0x80);
+        // Variant in byte 8
+        expect((id[8] & 0xc0)).toBe(0x80);
+    });
+    it("uniqueRelationId is deterministic", () => {
+        const from = parseId("11111111111111111111111111111111");
+        const to = parseId("22222222222222222222222222222222");
+        const type = parseId("33333333333333333333333333333333");
+        const id1 = uniqueRelationId(from, to, type);
+        const id2 = uniqueRelationId(from, to, type);
+        expect(idsEqual(id1, id2)).toBe(true);
+        // Different from -> different id
+        const id3 = uniqueRelationId(to, from, type);
+        expect(idsEqual(id1, id3)).toBe(false);
+    });
+    it("relationEntityId differs from relation id", () => {
+        const relationId = randomId();
+        const entityId = relationEntityId(relationId);
+        expect(idsEqual(relationId, entityId)).toBe(false);
+    });
+});
+describe("Genesis IDs", () => {
+    it("properties.NAME is deterministic", () => {
+        const id1 = properties.NAME;
+        const id2 = properties.name();
+        expect(idsEqual(id1, id2)).toBe(true);
+    });
+    it("relationTypes.TYPES is deterministic", () => {
+        const id1 = relationTypes.TYPES;
+        const id2 = relationTypes.types();
+        expect(idsEqual(id1, id2)).toBe(true);
+    });
+    it("languages.ENGLISH is deterministic", () => {
+        const id1 = languages.ENGLISH;
+        const id2 = languages.english();
+        const id3 = languages.fromCode("en");
+        expect(idsEqual(id1, id2)).toBe(true);
+        expect(idsEqual(id1, id3)).toBe(true);
+    });
+});
+describe("EditBuilder", () => {
+    it("creates a simple edit with entity", () => {
+        const editId = randomId();
+        const entityId = randomId();
+        const authorId = randomId();
+        const edit = new EditBuilder(editId)
+            .setName("Test Edit")
+            .addAuthor(authorId)
+            .setCreatedAt(1234567890n)
+            .createEntity(entityId, (e) => e.text(properties.name(), "Alice", undefined)
+            .int64(parseId("aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"), 42n, undefined))
+            .build();
+        expect(idsEqual(edit.id, editId)).toBe(true);
+        expect(edit.name).toBe("Test Edit");
+        expect(edit.authors.length).toBe(1);
+        expect(edit.createdAt).toBe(1234567890n);
+        expect(edit.ops.length).toBe(1);
+        expect(edit.ops[0].type).toBe("createEntity");
+    });
+    it("creates relations in unique and many mode", () => {
+        const editId = randomId();
+        const from = randomId();
+        const to = randomId();
+        const relId = randomId();
+        const edit = new EditBuilder(editId)
+            .createEmptyEntity(from)
+            .createEmptyEntity(to)
+            .createRelationUnique(from, to, relationTypes.types())
+            .createRelationMany(relId, from, to, relationTypes.partOf())
+            .build();
+        expect(edit.ops.length).toBe(4);
+        expect(edit.ops[2].type).toBe("createRelation");
+        expect(edit.ops[3].type).toBe("createRelation");
+        const rel1 = edit.ops[2];
+        const rel2 = edit.ops[3];
+        if (rel1.type === "createRelation" && rel2.type === "createRelation") {
+            expect(rel1.idMode.type).toBe("unique");
+            expect(rel2.idMode.type).toBe("many");
+        }
+    });
+    it("creates update entity operations", () => {
+        const editId = randomId();
+        const entityId = randomId();
+        const propId = randomId();
+        const edit = new EditBuilder(editId)
+            .updateEntity(entityId, (u) => u.setText(propId, "New value", undefined)
+            .unsetAll(properties.description()))
+            .build();
+        expect(edit.ops.length).toBe(1);
+        expect(edit.ops[0].type).toBe("updateEntity");
+        const op = edit.ops[0];
+        if (op.type === "updateEntity") {
+            expect(op.setProperties.length).toBe(1);
+            expect(op.unsetProperties.length).toBe(1);
+        }
+    });
+});
+describe("Codec", () => {
+    it("encodes and decodes a simple edit", () => {
+        const editId = randomId();
+        const entityId = randomId();
+        const edit = new EditBuilder(editId)
+            .setName("Test Edit")
+            .setCreatedAt(1234567890000000n)
+            .createEntity(entityId, (e) => e.text(properties.name(), "Alice", undefined)
+            .bool(parseId("bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"), true))
+            .build();
+        const encoded = encodeEdit(edit);
+        expect(encoded.length).toBeGreaterThan(0);
+        // Check magic bytes
+        expect(String.fromCharCode(...encoded.slice(0, 4))).toBe("GRC2");
+        const decoded = decodeEdit(encoded);
+        expect(idsEqual(decoded.id, edit.id)).toBe(true);
+        expect(decoded.name).toBe(edit.name);
+        expect(decoded.createdAt).toBe(edit.createdAt);
+        expect(decoded.ops.length).toBe(edit.ops.length);
+    });
+    it("encodes and decodes all value types", () => {
+        const editId = randomId();
+        const entityId = randomId();
+        const edit = new EditBuilder(editId)
+            .setName("All Types Test")
+            .createEntity(entityId, (e) => e.bool(parseId("11111111111111111111111111111111"), true)
+            .int64(parseId("22222222222222222222222222222222"), -42n, undefined)
+            .float64(parseId("33333333333333333333333333333333"), 3.14159, undefined)
+            .text(parseId("44444444444444444444444444444444"), "Hello World", undefined)
+            .bytes(parseId("55555555555555555555555555555555"), new Uint8Array([1, 2, 3, 4]))
+            .timestamp(parseId("66666666666666666666666666666666"), 1704067200000000n)
+            .date(parseId("77777777777777777777777777777777"), "2024-01-15")
+            .point(parseId("88888888888888888888888888888888"), 40.7128, -74.006))
+            .build();
+        const encoded = encodeEdit(edit);
+        const decoded = decodeEdit(encoded);
+        expect(decoded.ops.length).toBe(1);
+        const op = decoded.ops[0];
+        expect(op.type).toBe("createEntity");
+        if (op.type === "createEntity") {
+            expect(op.values.length).toBe(8);
+            // Check each value type
+            const boolVal = op.values.find(v => v.value.type === "bool");
+            expect(boolVal?.value).toEqual({ type: "bool", value: true });
+            const intVal = op.values.find(v => v.value.type === "int64");
+            expect(intVal?.value).toEqual({ type: "int64", value: -42n, unit: undefined });
+            const floatVal = op.values.find(v => v.value.type === "float64");
+            if (floatVal?.value.type === "float64") {
+                expect(floatVal.value.value).toBeCloseTo(3.14159, 5);
+            }
+            const textVal = op.values.find(v => v.value.type === "text");
+            expect(textVal?.value).toEqual({ type: "text", value: "Hello World", language: undefined });
+            const pointVal = op.values.find(v => v.value.type === "point");
+            if (pointVal?.value.type === "point") {
+                expect(pointVal.value.lat).toBeCloseTo(40.7128, 4);
+                expect(pointVal.value.lon).toBeCloseTo(-74.006, 3);
+            }
+        }
+    });
+    it("encodes and decodes relations", () => {
+        const editId = randomId();
+        const from = randomId();
+        const to = randomId();
+        const edit = new EditBuilder(editId)
+            .createEmptyEntity(from)
+            .createEmptyEntity(to)
+            .createRelationUnique(from, to, relationTypes.types())
+            .build();
+        const encoded = encodeEdit(edit);
+        const decoded = decodeEdit(encoded);
+        expect(decoded.ops.length).toBe(3);
+        const rel = decoded.ops[2];
+        expect(rel.type).toBe("createRelation");
+        if (rel.type === "createRelation") {
+            expect(rel.idMode.type).toBe("unique");
+            expect(idsEqual(rel.from, from)).toBe(true);
+            expect(idsEqual(rel.to, to)).toBe(true);
+        }
+    });
+    it("encodes and decodes update/delete/restore operations", () => {
+        const editId = randomId();
+        const entityId = randomId();
+        const relationId = randomId();
+        const propId = randomId();
+        const edit = new EditBuilder(editId)
+            .updateEntity(entityId, (u) => u.setText(propId, "Updated", undefined))
+            .deleteEntity(entityId)
+            .restoreEntity(entityId)
+            .updateRelation(relationId, "abc")
+            .deleteRelation(relationId)
+            .restoreRelation(relationId)
+            .build();
+        const encoded = encodeEdit(edit);
+        const decoded = decodeEdit(encoded);
+        expect(decoded.ops.length).toBe(6);
+        expect(decoded.ops[0].type).toBe("updateEntity");
+        expect(decoded.ops[1].type).toBe("deleteEntity");
+        expect(decoded.ops[2].type).toBe("restoreEntity");
+        expect(decoded.ops[3].type).toBe("updateRelation");
+        expect(decoded.ops[4].type).toBe("deleteRelation");
+        expect(decoded.ops[5].type).toBe("restoreRelation");
+        const updateRel = decoded.ops[3];
+        if (updateRel.type === "updateRelation") {
+            expect(updateRel.position).toBe("abc");
+        }
+    });
+    it("encodes and decodes createProperty", () => {
+        const editId = randomId();
+        const propId = randomId();
+        const edit = new EditBuilder(editId)
+            .createProperty(propId, DataType.Text)
+            .build();
+        const encoded = encodeEdit(edit);
+        const decoded = decodeEdit(encoded);
+        expect(decoded.ops.length).toBe(1);
+        expect(decoded.ops[0].type).toBe("createProperty");
+        const op = decoded.ops[0];
+        if (op.type === "createProperty") {
+            expect(idsEqual(op.id, propId)).toBe(true);
+            expect(op.dataType).toBe(DataType.Text);
+        }
+    });
+    it("canonical encoding is deterministic", () => {
+        const editId = parseId("aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa");
+        const entityId = parseId("bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb");
+        const edit = new EditBuilder(editId)
+            .setName("Canonical Test")
+            .setCreatedAt(1000000n)
+            .createEntity(entityId, (e) => e.text(properties.name(), "Test", undefined))
+            .build();
+        const encoded1 = encodeEdit(edit, { canonical: true });
+        const encoded2 = encodeEdit(edit, { canonical: true });
+        expect(encoded1.length).toBe(encoded2.length);
+        for (let i = 0; i < encoded1.length; i++) {
+            expect(encoded1[i]).toBe(encoded2[i]);
+        }
+    });
+});
+//# sourceMappingURL=basic.test.js.map

package/dist/test/basic.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.test.js","sourceRoot":"","sources":["../../src/test/basic.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,WAAW,GAAG,sCAAsC,CAAC;QAC3D,MAAM,cAAc,GAAG,kCAAkC,CAAC;QAE1D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,GAAI,EAAE,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACzC,sBAAsB;QACtB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,oBAAoB;QACpB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,kCAAkC,CAAE,CAAC;QAC1D,MAAM,EAAE,GAAG,OAAO,CAAC,kCAAkC,CAAE,CAAC;QACxD,MAAM,IAAI,GAAG,OAAO,CAAC,kCAAkC,CAAE,CAAC;QAE1D,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtC,iCAAiC;QACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC;QAChC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;QAC9B,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAE5B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,OAAO,CAAC,WAAW,CAAC;aACpB,SAAS,CAAC,QAAQ,CAAC;aACnB,YAAY,CAAC,WAAW,CAAC;aACzB,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC;aAC3C,KAAK,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CACtE;aACA,KAAK,EAAE,CAAC;QAEX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,iBAAiB,CAAC,IAAI,CAAC;aACvB,iBAAiB,CAAC,EAAE,CAAC;aACrB,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC;aACrD,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC;aAC3D,KAAK,EAAE,CAAC;QAEX,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC;aACvC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CACrC;aACA,KAAK,EAAE,CAAC;QAEX,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE9C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/B,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAE5B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,OAAO,CAAC,WAAW,CAAC;aACpB,YAAY,CAAC,iBAAiB,CAAC;aAC/B,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC;aAC3C,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,IAAI,CAAC,CAC3D;aACA,KAAK,EAAE,CAAC;QAEX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAE1C,oBAAoB;QACpB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAE5B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,OAAO,CAAC,gBAAgB,CAAC;aACzB,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,IAAI,CAAC;aACxD,KAAK,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC;aACpE,OAAO,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,OAAO,EAAE,SAAS,CAAC;aACzE,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,aAAa,EAAE,SAAS,CAAC;aAC5E,KAAK,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aACjF,SAAS,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,iBAAiB,CAAC;aAC1E,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,YAAY,CAAC;aAChE,KAAK,CAAC,OAAO,CAAC,kCAAkC,CAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CACxE;aACA,KAAK,EAAE,CAAC;QAEX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAErC,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEjC,wBAAwB;YACxB,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YAC7D,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YAE/E,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YACjE,IAAI,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YAC7D,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAE5F,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC/D,IAAI,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACnD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QAEtB,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,iBAAiB,CAAC,IAAI,CAAC;aACvB,iBAAiB,CAAC,EAAE,CAAC;aACrB,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC;aACrD,KAAK,EAAE,CAAC;QAEX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAExC,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CACxC;aACA,YAAY,CAAC,QAAQ,CAAC;aACtB,aAAa,CAAC,QAAQ,CAAC;aACvB,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC;aACjC,cAAc,CAAC,UAAU,CAAC;aAC1B,eAAe,CAAC,UAAU,CAAC;aAC3B,KAAK,EAAE,CAAC;QAEX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEpD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;aACrC,KAAK,EAAE,CAAC;QAEX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEnD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACjC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,kCAAkC,CAAE,CAAC;QAE9D,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;aACjC,OAAO,CAAC,gBAAgB,CAAC;aACzB,YAAY,CAAC,QAAQ,CAAC;aACtB,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAC7C;aACA,KAAK,EAAE,CAAC;QAEX,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/edit.d.ts

@@ -0,0 +1,46 @@
+import type { Id } from "./id.js";
+import type { Op } from "./op.js";
+import type { DataType } from "./value.js";
+/**
+ * A batch of operations with metadata (spec Section 4.1).
+ *
+ * Edits are standalone patches. They contain no parent references;
+ * ordering is provided by on-chain governance.
+ */
+export interface Edit {
+    /** The edit's unique identifier. */
+    id: Id;
+    /** Optional human-readable name (may be empty string). */
+    name: string;
+    /** Author entity IDs. */
+    authors: Id[];
+    /** Creation timestamp in microseconds since Unix epoch (metadata only). */
+    createdAt: bigint;
+    /** Operations in this edit. */
+    ops: Op[];
+}
+/**
+ * Wire-format dictionaries for encoding/decoding.
+ *
+ * These dictionaries map between full IDs and compact indices within an edit.
+ */
+export interface WireDictionaries {
+    /** Properties dictionary: (ID, DataType) pairs. */
+    properties: Array<{
+        id: Id;
+        dataType: DataType;
+    }>;
+    /** Relation type IDs. */
+    relationTypes: Id[];
+    /** Language entity IDs for localized TEXT values. */
+    languages: Id[];
+    /** Unit entity IDs for numerical values. */
+    units: Id[];
+    /** Object IDs (entities and relations). */
+    objects: Id[];
+}
+/**
+ * Creates empty wire dictionaries.
+ */
+export declare function createWireDictionaries(): WireDictionaries;
+//# sourceMappingURL=edit.d.ts.map

package/dist/types/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/types/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,oCAAoC;IACpC,EAAE,EAAE,EAAE,CAAC;IACP,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,EAAE,EAAE,CAAC;IACd,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,GAAG,EAAE,EAAE,EAAE,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAClD,yBAAyB;IACzB,aAAa,EAAE,EAAE,EAAE,CAAC;IACpB,qDAAqD;IACrD,SAAS,EAAE,EAAE,EAAE,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,EAAE,EAAE,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,EAAE,EAAE,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAQzD"}

package/dist/types/edit.js

@@ -0,0 +1,13 @@
+/**
+ * Creates empty wire dictionaries.
+ */
+export function createWireDictionaries() {
+    return {
+        properties: [],
+        relationTypes: [],
+        languages: [],
+        units: [],
+        objects: [],
+    };
+}
+//# sourceMappingURL=edit.js.map

package/dist/types/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/types/edit.ts"],"names":[],"mappings":"AAyCA;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,UAAU,EAAE,EAAE;QACd,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

package/dist/types/id.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A 16-byte UUID identifier.
+ *
+ * This is the universal identifier type for entities, relations, properties,
+ * types, spaces, authors, and all other objects in GRC-20.
+ */
+export type Id = Uint8Array & {
+    readonly __brand: unique symbol;
+};
+/**
+ * Creates an Id from a Uint8Array.
+ * @throws Error if the array is not exactly 16 bytes.
+ */
+export declare function createId(bytes: Uint8Array): Id;
+/**
+ * Creates a copy of an Id.
+ */
+export declare function copyId(id: Id): Id;
+/**
+ * The nil/zero UUID.
+ */
+export declare const NIL_ID: Id;
+/**
+ * Compares two Ids for equality.
+ */
+export declare function idsEqual(a: Id, b: Id): boolean;
+/**
+ * Compares two Ids lexicographically.
+ * Returns negative if a < b, 0 if a === b, positive if a > b.
+ */
+export declare function compareIds(a: Id, b: Id): number;
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/types/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,EAAE,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAElE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,EAAE,CAK9C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAIjC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,EAAiC,CAAC;AAEvD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAK9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,CAO/C"}