@geoprotocol/grc-20 0.1.0

package/dist/util/id.js

@@ -0,0 +1,215 @@
+import { createId } from "../types/id.js";
+/**
+ * Formats a UUID as non-hyphenated lowercase hex (recommended display format).
+ */
+export function formatId(id) {
+    let s = "";
+    for (let i = 0; i < 16; i++) {
+        s += id[i].toString(16).padStart(2, "0");
+    }
+    return s;
+}
+/**
+ * Parses a UUID from hex string (with or without hyphens).
+ * Returns undefined if the string is invalid.
+ */
+export function parseId(s) {
+    // Remove hyphens if present
+    const hex = s.replace(/-/g, "").toLowerCase();
+    if (hex.length !== 32) {
+        return undefined;
+    }
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i++) {
+        const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+        if (Number.isNaN(byte)) {
+            return undefined;
+        }
+        bytes[i] = byte;
+    }
+    return createId(bytes);
+}
+/**
+ * Generates a random UUIDv4.
+ */
+export function randomId() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    // Set version 4 (0100 in bits 4-7 of byte 6)
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    // Set RFC 4122 variant (10 in bits 6-7 of byte 8)
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    return createId(bytes);
+}
+/**
+ * SHA-256 hash function using Web Crypto API.
+ * Works in both Node.js and browsers.
+ */
+async function sha256(data) {
+    const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+    return new Uint8Array(hashBuffer);
+}
+/**
+ * Synchronous SHA-256 implementation for environments where async is not ideal.
+ * Uses a pure JavaScript implementation.
+ */
+function sha256Sync(data) {
+    // SHA-256 constants
+    const K = new Uint32Array([
+        0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1,
+        0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3,
+        0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786,
+        0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+        0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147,
+        0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
+        0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b,
+        0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+        0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a,
+        0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
+        0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+    ]);
+    // Initial hash values
+    let h0 = 0x6a09e667;
+    let h1 = 0xbb67ae85;
+    let h2 = 0x3c6ef372;
+    let h3 = 0xa54ff53a;
+    let h4 = 0x510e527f;
+    let h5 = 0x9b05688c;
+    let h6 = 0x1f83d9ab;
+    let h7 = 0x5be0cd19;
+    // Pre-processing: adding padding bits
+    const bitLen = data.length * 8;
+    const paddedLen = Math.ceil((data.length + 9) / 64) * 64;
+    const padded = new Uint8Array(paddedLen);
+    padded.set(data);
+    padded[data.length] = 0x80;
+    // Append original length in bits as 64-bit big-endian
+    const view = new DataView(padded.buffer);
+    view.setUint32(paddedLen - 4, bitLen, false);
+    // Process each 64-byte chunk
+    const W = new Uint32Array(64);
+    for (let offset = 0; offset < paddedLen; offset += 64) {
+        // Copy chunk into first 16 words
+        for (let i = 0; i < 16; i++) {
+            W[i] = view.getUint32(offset + i * 4, false);
+        }
+        // Extend the first 16 words into the remaining 48 words
+        for (let i = 16; i < 64; i++) {
+            const s0 = ((W[i - 15] >>> 7) | (W[i - 15] << 25)) ^
+                ((W[i - 15] >>> 18) | (W[i - 15] << 14)) ^
+                (W[i - 15] >>> 3);
+            const s1 = ((W[i - 2] >>> 17) | (W[i - 2] << 15)) ^
+                ((W[i - 2] >>> 19) | (W[i - 2] << 13)) ^
+                (W[i - 2] >>> 10);
+            W[i] = (W[i - 16] + s0 + W[i - 7] + s1) >>> 0;
+        }
+        // Initialize working variables
+        let a = h0, b = h1, c = h2, d = h3, e = h4, f = h5, g = h6, h = h7;
+        // Compression function main loop
+        for (let i = 0; i < 64; i++) {
+            const S1 = ((e >>> 6) | (e << 26)) ^ ((e >>> 11) | (e << 21)) ^ ((e >>> 25) | (e << 7));
+            const ch = (e & f) ^ (~e & g);
+            const temp1 = (h + S1 + ch + K[i] + W[i]) >>> 0;
+            const S0 = ((a >>> 2) | (a << 30)) ^ ((a >>> 13) | (a << 19)) ^ ((a >>> 22) | (a << 10));
+            const maj = (a & b) ^ (a & c) ^ (b & c);
+            const temp2 = (S0 + maj) >>> 0;
+            h = g;
+            g = f;
+            f = e;
+            e = (d + temp1) >>> 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (temp1 + temp2) >>> 0;
+        }
+        // Add the compressed chunk to the current hash value
+        h0 = (h0 + a) >>> 0;
+        h1 = (h1 + b) >>> 0;
+        h2 = (h2 + c) >>> 0;
+        h3 = (h3 + d) >>> 0;
+        h4 = (h4 + e) >>> 0;
+        h5 = (h5 + f) >>> 0;
+        h6 = (h6 + g) >>> 0;
+        h7 = (h7 + h) >>> 0;
+    }
+    // Produce the final hash value (big-endian)
+    const result = new Uint8Array(32);
+    const resultView = new DataView(result.buffer);
+    resultView.setUint32(0, h0, false);
+    resultView.setUint32(4, h1, false);
+    resultView.setUint32(8, h2, false);
+    resultView.setUint32(12, h3, false);
+    resultView.setUint32(16, h4, false);
+    resultView.setUint32(20, h5, false);
+    resultView.setUint32(24, h6, false);
+    resultView.setUint32(28, h7, false);
+    return result;
+}
+/**
+ * Derives a UUIDv8 from input bytes using SHA-256.
+ *
+ * This implements the `derived_uuid` function from spec Section 2.1:
+ * ```
+ * hash = SHA-256(input_bytes)[0:16]
+ * hash[6] = (hash[6] & 0x0F) | 0x80  // version 8
+ * hash[8] = (hash[8] & 0x3F) | 0x80  // RFC 4122 variant
+ * ```
+ */
+export function derivedUuid(input) {
+    const hash = sha256Sync(input);
+    const id = new Uint8Array(16);
+    id.set(hash.subarray(0, 16));
+    // Set version 8 (1000 in bits 4-7 of byte 6)
+    id[6] = (id[6] & 0x0f) | 0x80;
+    // Set RFC 4122 variant (10 in bits 6-7 of byte 8)
+    id[8] = (id[8] & 0x3f) | 0x80;
+    return createId(id);
+}
+/**
+ * Async version of derivedUuid using Web Crypto API.
+ */
+export async function derivedUuidAsync(input) {
+    const hash = await sha256(input);
+    const id = new Uint8Array(16);
+    id.set(hash.subarray(0, 16));
+    // Set version 8 (1000 in bits 4-7 of byte 6)
+    id[6] = (id[6] & 0x0f) | 0x80;
+    // Set RFC 4122 variant (10 in bits 6-7 of byte 8)
+    id[8] = (id[8] & 0x3f) | 0x80;
+    return createId(id);
+}
+/**
+ * Derives a UUIDv8 from a string using SHA-256.
+ */
+export function derivedUuidFromString(input) {
+    return derivedUuid(new TextEncoder().encode(input));
+}
+/**
+ * Derives a unique-mode relation ID.
+ *
+ * ```
+ * id = derived_uuid(from_id || to_id || type_id)
+ * ```
+ */
+export function uniqueRelationId(fromId, toId, typeId) {
+    const input = new Uint8Array(48);
+    input.set(fromId, 0);
+    input.set(toId, 16);
+    input.set(typeId, 32);
+    return derivedUuid(input);
+}
+const RELATION_ENTITY_PREFIX = new TextEncoder().encode("grc20:relation-entity:");
+/**
+ * Derives the reified entity ID from a relation ID.
+ *
+ * ```
+ * entity_id = derived_uuid("grc20:relation-entity:" || relation_id)
+ * ```
+ */
+export function relationEntityId(relationId) {
+    const input = new Uint8Array(RELATION_ENTITY_PREFIX.length + 16);
+    input.set(RELATION_ENTITY_PREFIX, 0);
+    input.set(relationId, RELATION_ENTITY_PREFIX.length);
+    return derivedUuid(input);
+}
+//# sourceMappingURL=id.js.map

package/dist/util/id.js.map

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

package/dist/util/index.d.ts

@@ -0,0 +1,2 @@
+export { formatId, parseId, randomId, derivedUuid, derivedUuidAsync, derivedUuidFromString, uniqueRelationId, relationEntityId, } from "./id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,2 @@
+export { formatId, parseId, randomId, derivedUuid, derivedUuidAsync, derivedUuidFromString, uniqueRelationId, relationEntityId, } from "./id.js";
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@geoprotocol/grc-20",
+  "version": "0.1.0",
+  "description": "GRC-20 TypeScript library for binary property graph encoding/decoding",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./builder": {
+      "import": "./dist/builder/index.js",
+      "types": "./dist/builder/index.d.ts"
+    },
+    "./codec": {
+      "import": "./dist/codec/index.js",
+      "types": "./dist/codec/index.d.ts"
+    },
+    "./genesis": {
+      "import": "./dist/genesis/index.js",
+      "types": "./dist/genesis/index.d.ts"
+    },
+    "./util": {
+      "import": "./dist/util/index.js",
+      "types": "./dist/util/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "test:all": "npm run test && npm run test:browser",
+    "bundle:analyze": "node scripts/bundle-analyze.js",
+    "demo": "npx serve .",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "grc-20",
+    "graph",
+    "knowledge-graph",
+    "binary-format",
+    "encoding"
+  ],
+  "author": "Geo Browser",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/browser": "^1.2.0",
+    "esbuild": "^0.20.0",
+    "playwright": "^1.41.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/readme.md

@@ -0,0 +1,232 @@
+# @geoprotocol/grc-20
+
+TypeScript library for encoding and decoding GRC-20 binary property graph data.
+
+## Installation
+
+```bash
+npm install @geoprotocol/grc-20
+```
+
+## Quick Start
+
+```typescript
+import {
+  EditBuilder,
+  encodeEdit,
+  decodeEdit,
+  randomId,
+  properties,
+} from "@geoprotocol/grc-20";
+
+// Create an edit with an entity
+const edit = new EditBuilder(randomId())
+  .setName("Create Alice")
+  .addAuthor(randomId())
+  .setCreatedNow()
+  .createEntity(randomId(), (e) =>
+    e
+      .text(properties.name(), "Alice", undefined)
+      .text(properties.description(), "A person", undefined)
+  )
+  .build();
+
+// Encode to binary
+const bytes = encodeEdit(edit);
+
+// Decode back
+const decoded = decodeEdit(bytes);
+```
+
+## Features
+
+- **Type-safe API** - Full TypeScript definitions
+- **Builder pattern** - Fluent API for constructing edits
+- **Binary codec** - Pure TypeScript encoder/decoder (no WASM)
+- **Tree-shakeable** - Separate entry points for minimal bundles
+- **Cross-platform** - Works in Node.js and browsers
+
+## Bundle Sizes
+
+| Entry Point | Gzipped |
+|-------------|---------|
+| Full library | ~8.7 KB |
+| Types only | ~1.4 KB |
+| Builder only | ~1.2 KB |
+| Codec only | ~4.8 KB |
+| Genesis IDs | ~1.9 KB |
+| Utilities | ~1.6 KB |
+
+### Lazy Loading
+
+For optimal initial load, import the codec separately:
+
+```typescript
+// Initial load (~4.6 KB gzipped)
+import { EditBuilder, randomId, properties } from "@geoprotocol/grc-20/builder";
+import { properties } from "@geoprotocol/grc-20/genesis";
+
+// Lazy load codec when needed (~4.8 KB gzipped)
+const { encodeEdit } = await import("@geoprotocol/grc-20/codec");
+```
+
+## API Reference
+
+### Types
+
+```typescript
+import {
+  Id,              // 16-byte UUID (Uint8Array branded type)
+  Edit,            // Batch of operations with metadata
+  Op,              // Union of all operation types
+  Value,           // Union of all value types
+  DataType,        // Enum: Bool, Int64, Float64, Text, etc.
+  PropertyValue,   // Property ID + Value pair
+} from "@geoprotocol/grc-20";
+```
+
+### Builders
+
+```typescript
+import {
+  EditBuilder,          // Build Edit objects
+  EntityBuilder,        // Build entity values
+  UpdateEntityBuilder,  // Build update operations
+  RelationBuilder,      // Build relation operations
+} from "@geoprotocol/grc-20";
+```
+
+#### EditBuilder
+
+```typescript
+const edit = new EditBuilder(editId)
+  .setName("My Edit")
+  .addAuthor(authorId)
+  .setCreatedAt(BigInt(Date.now()) * 1000n)  // microseconds
+  .createEntity(entityId, e => e
+    .text(propId, "value", languageId)
+    .int64(propId, 42n, unitId)
+    .float64(propId, 3.14, undefined)
+    .bool(propId, true)
+    .bytes(propId, new Uint8Array([1, 2, 3]))
+    .point(propId, 40.7128, -74.006)
+    .date(propId, "2024-01-15")
+    .timestamp(propId, 1704067200000000n)
+  )
+  .updateEntity(entityId, u => u
+    .setText(propId, "new value", undefined)
+    .unsetAll(propId)
+  )
+  .deleteEntity(entityId)
+  .restoreEntity(entityId)
+  .createRelationUnique(fromId, toId, relationTypeId)
+  .createRelationMany(relationId, fromId, toId, relationTypeId)
+  .deleteRelation(relationId)
+  .createProperty(propId, DataType.Text)
+  .build();
+```
+
+### Codec
+
+```typescript
+import { encodeEdit, decodeEdit } from "@geoprotocol/grc-20";
+
+// Encode
+const bytes = encodeEdit(edit);
+const bytesCanonical = encodeEdit(edit, { canonical: true });
+
+// Decode
+const edit = decodeEdit(bytes);
+```
+
+### ID Utilities
+
+```typescript
+import {
+  randomId,           // Generate random UUIDv4
+  parseId,            // Parse hex string to Id
+  formatId,           // Format Id as hex string
+  derivedUuid,        // Derive UUIDv8 from bytes (SHA-256)
+  derivedUuidFromString,
+  uniqueRelationId,   // Derive relation ID from endpoints
+  relationEntityId,   // Derive entity ID from relation ID
+  idsEqual,           // Compare two Ids
+  NIL_ID,             // Zero UUID
+} from "@geoprotocol/grc-20";
+```
+
+### Genesis IDs
+
+Well-known IDs from the Genesis Space:
+
+```typescript
+import { properties, types, relationTypes, languages } from "@geoprotocol/grc-20";
+
+// Properties
+properties.name()        // Name (TEXT)
+properties.description() // Description (TEXT)
+properties.avatar()      // Avatar URL (TEXT)
+properties.url()         // External URL (TEXT)
+properties.created()     // Creation time (TIMESTAMP)
+properties.modified()    // Last modified (TIMESTAMP)
+
+// Types
+types.person()
+types.organization()
+types.place()
+types.topic()
+
+// Relation Types
+relationTypes.types()     // Type membership
+relationTypes.partOf()    // Composition
+relationTypes.relatedTo() // Generic association
+
+// Languages
+languages.english()       // or languages.fromCode("en")
+languages.spanish()
+languages.french()
+// ... etc
+```
+
+## Entry Points
+
+For tree-shaking, use specific entry points:
+
+```typescript
+import { ... } from "@geoprotocol/grc-20";          // Full library
+import { ... } from "@geoprotocol/grc-20/types";    // Types only
+import { ... } from "@geoprotocol/grc-20/builder";  // Builders only
+import { ... } from "@geoprotocol/grc-20/codec";    // Codec only
+import { ... } from "@geoprotocol/grc-20/genesis";  // Genesis IDs only
+import { ... } from "@geoprotocol/grc-20/util";     // Utilities only
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test (Node.js)
+npm test
+
+# Test (Browser via Playwright)
+npm run test:browser
+
+# Test both
+npm run test:all
+
+# Analyze bundle sizes
+npm run bundle:analyze
+
+# Run browser demo
+npm run demo
+# Then open http://localhost:3000/examples/browser-demo.html
+```
+
+## License
+
+MIT