@whi/entity-architect NPM

Entity Architect (for Holochain)

A Javascript library for deconstructing DNA responses according to the Entity specification.

Overview

This module is intended to help transform DNA responses and reduce data clutter. It is designed to integrate directly after a zome call and seamlessly restructure the contents to more GUI friendly formats.

This is achieved by using Object.definePropterty to hide tracking values such as Entry/Action hashes. It keeps the contextual information available, but out of the way.

Features

Modular architecture definitions for supporting multi-DNA GUIs
Automatically wrap an Entity's HoloHash properties using @whi/holo-hash
Detailed error classes for unexpected input

Install

npm i @whi/entity-architect

Basic usage

const { Architecture, EntityType } = require('@whi/entity-architect');

const SomeType = new EntityType("some_type", content => {
    content.published_at = new Date( content.published_at );
    content.last_updated = new Date( content.last_updated );
});


const schema = new Architecture([ SomeType ]);

schema.deconstruct( "entity", {
    "id": Uint8Array [
        132,  41,  36,  18, 241, 108, 143,  79,
         16, 118, 216,  34,  80,  48, 101,  18,
         28,  37, 113, 110, 101, 177, 250, 131,
        226, 242, 145, 113, 161, 136, 138, 180,
        129, 199,  69, 165, 236, 197,  95
    ],
    "action": Uint8Array [
        132,  41,  36, 159, 249,   8, 161, 177,
        222, 245, 155, 120, 125, 232, 123, 231,
         92,  30, 242,  96, 198, 200, 155, 129,
         93,  30, 116,  95, 146, 193, 170, 215,
         18, 184,  98, 218, 148, 128,  90
    ],
    "address": Uint8Array [
        132,  33,  36,  83, 188, 220,  51, 147,
         69,  25, 114,  37, 141,  33, 227,  37,
         45, 230, 147, 173, 133, 125,  84, 105,
        158,  38,  80, 150,  14, 159, 247, 108,
        214,  30,  67, 153, 165, 189, 179
    ],
    "type": "some_type",
    "content": {
        "published_at": 1624661323383,
        "last_updated": 1624661325451,
        "author": Uint8Array [
            132,  32,  36, 161, 194,  74, 117,  57,  82,
            145,   1,  85, 154,  51, 214, 254,  80,  63,
              3, 153,  46, 176, 211, 142,  68, 250, 197,
             96, 154, 147, 243,  93, 248,  61, 168,  56,
            229,  88, 223
        ],
    }
});
// {
//     [$id]: ActionHash("uhCkkEvFsj08QdtgiUDBlEhwlcW5lsfqD4vKRcaGIirSBx0Wl7MVf"),
//     [$action]: ActionHash("uhCkkn_kIobHe9Zt4feh751we8mDGyJuBXR50X5LBqtcSuGLalIBa"),
//     [$address]: EntryHash("uhCEkU7zcM5NFGXIljSHjJS3mk62FfVRpniZQlg6f92zWHkOZpb2z"),
//     [$type]: "some_type",
//
//     "published_at": Date(1624661325451),
//     "last_updated": Date(1624661325451),
//     "author": AgentPubKey("uhCAkocJKdTlSkQFVmjPW_lA_A5kusNOORPrFYJqT8134Pag45Vjf"),
// }