holosphere 1.0.3 → 1.0.5

package/hexlib.js

@@ -0,0 +1,332 @@
+// Generated code -- CC0 -- No Rights Reserved -- http://www.redblobgames.com/grids/hexagons/
+export class Point {
+    constructor(x, y) {
+        this.x = x;
+        this.y = y;
+    }
+}
+export class Hex {
+    constructor(q, r, s) {
+        this.q = q;
+        this.r = r;
+        this.s = s;
+        if (Math.round(q + r + s) !== 0)
+            throw "q + r + s must be 0";
+    }
+    add(b) {
+        return new Hex(this.q + b.q, this.r + b.r, this.s + b.s);
+    }
+    subtract(b) {
+        return new Hex(this.q - b.q, this.r - b.r, this.s - b.s);
+    }
+    scale(k) {
+        return new Hex(this.q * k, this.r * k, this.s * k);
+    }
+    rotateLeft() {
+        return new Hex(-this.s, -this.q, -this.r);
+    }
+    rotateRight() {
+        return new Hex(-this.r, -this.s, -this.q);
+    }
+    static direction(direction) {
+        return Hex.directions[direction];
+    }
+    neighbor(direction) {
+        return this.add(Hex.direction(direction));
+    }
+    diagonalNeighbor(direction) {
+        return this.add(Hex.diagonals[direction]);
+    }
+    len() {
+        return (Math.abs(this.q) + Math.abs(this.r) + Math.abs(this.s)) / 2;
+    }
+    distance(b) {
+        return this.subtract(b).len();
+    }
+    round() {
+        var qi = Math.round(this.q);
+        var ri = Math.round(this.r);
+        var si = Math.round(this.s);
+        var q_diff = Math.abs(qi - this.q);
+        var r_diff = Math.abs(ri - this.r);
+        var s_diff = Math.abs(si - this.s);
+        if (q_diff > r_diff && q_diff > s_diff) {
+            qi = -ri - si;
+        }
+        else if (r_diff > s_diff) {
+            ri = -qi - si;
+        }
+        else {
+            si = -qi - ri;
+        }
+        return new Hex(qi, ri, si);
+    }
+    lerp(b, t) {
+        return new Hex(this.q * (1.0 - t) + b.q * t, this.r * (1.0 - t) + b.r * t, this.s * (1.0 - t) + b.s * t);
+    }
+    linedraw(b) {
+        var N = this.distance(b);
+        var a_nudge = new Hex(this.q + 1e-06, this.r + 1e-06, this.s - 2e-06);
+        var b_nudge = new Hex(b.q + 1e-06, b.r + 1e-06, b.s - 2e-06);
+        var results = [];
+        var step = 1.0 / Math.max(N, 1);
+        for (var i = 0; i <= N; i++) {
+            results.push(a_nudge.lerp(b_nudge, step * i).round());
+        }
+        return results;
+    }
+}
+Hex.directions = [new Hex(1, 0, -1), new Hex(1, -1, 0), new Hex(0, -1, 1), new Hex(-1, 0, 1), new Hex(-1, 1, 0), new Hex(0, 1, -1)];
+Hex.diagonals = [new Hex(2, -1, -1), new Hex(1, -2, 1), new Hex(-1, -1, 2), new Hex(-2, 1, 1), new Hex(-1, 2, -1), new Hex(1, 1, -2)];
+export class OffsetCoord {
+    constructor(col, row) {
+        this.col = col;
+        this.row = row;
+    }
+    static qoffsetFromCube(offset, h) {
+        var col = h.q;
+        var row = h.r + (h.q + offset * (h.q & 1)) / 2;
+        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
+            throw "offset must be EVEN (+1) or ODD (-1)";
+        }
+        return new OffsetCoord(col, row);
+    }
+    static qoffsetToCube(offset, h) {
+        var q = h.col;
+        var r = h.row - (h.col + offset * (h.col & 1)) / 2;
+        var s = -q - r;
+        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
+            throw "offset must be EVEN (+1) or ODD (-1)";
+        }
+        return new Hex(q, r, s);
+    }
+    static roffsetFromCube(offset, h) {
+        var col = h.q + (h.r + offset * (h.r & 1)) / 2;
+        var row = h.r;
+        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
+            throw "offset must be EVEN (+1) or ODD (-1)";
+        }
+        return new OffsetCoord(col, row);
+    }
+    static roffsetToCube(offset, h) {
+        var q = h.col - (h.row + offset * (h.row & 1)) / 2;
+        var r = h.row;
+        var s = -q - r;
+        if (offset !== OffsetCoord.EVEN && offset !== OffsetCoord.ODD) {
+            throw "offset must be EVEN (+1) or ODD (-1)";
+        }
+        return new Hex(q, r, s);
+    }
+}
+OffsetCoord.EVEN = 1;
+OffsetCoord.ODD = -1;
+export class DoubledCoord {
+    constructor(col, row) {
+        this.col = col;
+        this.row = row;
+    }
+    static qdoubledFromCube(h) {
+        var col = h.q;
+        var row = 2 * h.r + h.q;
+        return new DoubledCoord(col, row);
+    }
+    qdoubledToCube() {
+        var q = this.col;
+        var r = (this.row - this.col) / 2;
+        var s = -q - r;
+        return new Hex(q, r, s);
+    }
+    static rdoubledFromCube(h) {
+        var col = 2 * h.q + h.r;
+        var row = h.r;
+        return new DoubledCoord(col, row);
+    }
+    rdoubledToCube() {
+        var q = (this.col - this.row) / 2;
+        var r = this.row;
+        var s = -q - r;
+        return new Hex(q, r, s);
+    }
+}
+export class Orientation {
+    constructor(f0, f1, f2, f3, b0, b1, b2, b3, start_angle) {
+        this.f0 = f0;
+        this.f1 = f1;
+        this.f2 = f2;
+        this.f3 = f3;
+        this.b0 = b0;
+        this.b1 = b1;
+        this.b2 = b2;
+        this.b3 = b3;
+        this.start_angle = start_angle;
+    }
+}
+export class Layout {
+    constructor(orientation, size, origin) {
+        this.orientation = orientation;
+        this.size = size;
+        this.origin = origin;
+    }
+    hexToPixel(h) {
+        var M = this.orientation;
+        var size = this.size;
+        var origin = this.origin;
+        var x = (M.f0 * h.q + M.f1 * h.r) * size.x;
+        var y = (M.f2 * h.q + M.f3 * h.r) * size.y;
+        return new Point(x + origin.x, y + origin.y);
+    }
+    pixelToHex(p) {
+        var M = this.orientation;
+        var size = this.size;
+        var origin = this.origin;
+        var pt = new Point((p.x - origin.x) / size.x, (p.y - origin.y) / size.y);
+        var q = M.b0 * pt.x + M.b1 * pt.y;
+        var r = M.b2 * pt.x + M.b3 * pt.y;
+        return new Hex(q, r, -q - r);
+    }
+    hexCornerOffset(corner) {
+        var M = this.orientation;
+        var size = this.size;
+        var angle = 2.0 * Math.PI * (M.start_angle - corner) / 6.0;
+        return new Point(size.x * Math.cos(angle), size.y * Math.sin(angle));
+    }
+    polygonCorners(h) {
+        var corners = [];
+        var center = this.hexToPixel(h);
+        for (var i = 0; i < 6; i++) {
+            var offset = this.hexCornerOffset(i);
+            corners.push(new Point(center.x + offset.x, center.y + offset.y));
+        }
+        return corners;
+    }
+}
+Layout.pointy = new Orientation(Math.sqrt(3.0), Math.sqrt(3.0) / 2.0, 0.0, 3.0 / 2.0, Math.sqrt(3.0) / 3.0, -1.0 / 3.0, 0.0, 2.0 / 3.0, 0.5);
+Layout.flat = new Orientation(3.0 / 2.0, 0.0, Math.sqrt(3.0) / 2.0, Math.sqrt(3.0), 2.0 / 3.0, 0.0, -1.0 / 3.0, Math.sqrt(3.0) / 3.0, 0.0);
+class Tests {
+    constructor() { }
+    static equalHex(name, a, b) {
+        if (!(a.q === b.q && a.s === b.s && a.r === b.r)) {
+            complain(name);
+        }
+    }
+    static equalOffsetcoord(name, a, b) {
+        if (!(a.col === b.col && a.row === b.row)) {
+            complain(name);
+        }
+    }
+    static equalDoubledcoord(name, a, b) {
+        if (!(a.col === b.col && a.row === b.row)) {
+            complain(name);
+        }
+    }
+    static equalInt(name, a, b) {
+        if (!(a === b)) {
+            complain(name);
+        }
+    }
+    static equalHexArray(name, a, b) {
+        Tests.equalInt(name, a.length, b.length);
+        for (var i = 0; i < a.length; i++) {
+            Tests.equalHex(name, a[i], b[i]);
+        }
+    }
+    static testHexArithmetic() {
+        Tests.equalHex("hex_add", new Hex(4, -10, 6), new Hex(1, -3, 2).add(new Hex(3, -7, 4)));
+        Tests.equalHex("hex_subtract", new Hex(-2, 4, -2), new Hex(1, -3, 2).subtract(new Hex(3, -7, 4)));
+    }
+    static testHexDirection() {
+        Tests.equalHex("hex_direction", new Hex(0, -1, 1), Hex.direction(2));
+    }
+    static testHexNeighbor() {
+        Tests.equalHex("hex_neighbor", new Hex(1, -3, 2), new Hex(1, -2, 1).neighbor(2));
+    }
+    static testHexDiagonal() {
+        Tests.equalHex("hex_diagonal", new Hex(-1, -1, 2), new Hex(1, -2, 1).diagonalNeighbor(3));
+    }
+    static testHexDistance() {
+        Tests.equalInt("hex_distance", 7, new Hex(3, -7, 4).distance(new Hex(0, 0, 0)));
+    }
+    static testHexRotateRight() {
+        Tests.equalHex("hex_rotate_right", new Hex(1, -3, 2).rotateRight(), new Hex(3, -2, -1));
+    }
+    static testHexRotateLeft() {
+        Tests.equalHex("hex_rotate_left", new Hex(1, -3, 2).rotateLeft(), new Hex(-2, -1, 3));
+    }
+    static testHexRound() {
+        var a = new Hex(0.0, 0.0, 0.0);
+        var b = new Hex(1.0, -1.0, 0.0);
+        var c = new Hex(0.0, -1.0, 1.0);
+        Tests.equalHex("hex_round 1", new Hex(5, -10, 5), new Hex(0.0, 0.0, 0.0).lerp(new Hex(10.0, -20.0, 10.0), 0.5).round());
+        Tests.equalHex("hex_round 2", a.round(), a.lerp(b, 0.499).round());
+        Tests.equalHex("hex_round 3", b.round(), a.lerp(b, 0.501).round());
+        Tests.equalHex("hex_round 4", a.round(), new Hex(a.q * 0.4 + b.q * 0.3 + c.q * 0.3, a.r * 0.4 + b.r * 0.3 + c.r * 0.3, a.s * 0.4 + b.s * 0.3 + c.s * 0.3).round());
+        Tests.equalHex("hex_round 5", c.round(), new Hex(a.q * 0.3 + b.q * 0.3 + c.q * 0.4, a.r * 0.3 + b.r * 0.3 + c.r * 0.4, a.s * 0.3 + b.s * 0.3 + c.s * 0.4).round());
+    }
+    static testHexLinedraw() {
+        Tests.equalHexArray("hex_linedraw", [new Hex(0, 0, 0), new Hex(0, -1, 1), new Hex(0, -2, 2), new Hex(1, -3, 2), new Hex(1, -4, 3), new Hex(1, -5, 4)], new Hex(0, 0, 0).linedraw(new Hex(1, -5, 4)));
+    }
+    static testLayout() {
+        var h = new Hex(3, 4, -7);
+        var flat = new Layout(Layout.flat, new Point(10.0, 15.0), new Point(35.0, 71.0));
+        Tests.equalHex("layout", h, flat.pixelToHex(flat.hexToPixel(h)).round());
+        var pointy = new Layout(Layout.pointy, new Point(10.0, 15.0), new Point(35.0, 71.0));
+        Tests.equalHex("layout", h, pointy.pixelToHex(pointy.hexToPixel(h)).round());
+    }
+    static testOffsetRoundtrip() {
+        var a = new Hex(3, 4, -7);
+        var b = new OffsetCoord(1, -3);
+        Tests.equalHex("conversion_roundtrip even-q", a, OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, a)));
+        Tests.equalOffsetcoord("conversion_roundtrip even-q", b, OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, b)));
+        Tests.equalHex("conversion_roundtrip odd-q", a, OffsetCoord.qoffsetToCube(OffsetCoord.ODD, OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, a)));
+        Tests.equalOffsetcoord("conversion_roundtrip odd-q", b, OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, OffsetCoord.qoffsetToCube(OffsetCoord.ODD, b)));
+        Tests.equalHex("conversion_roundtrip even-r", a, OffsetCoord.roffsetToCube(OffsetCoord.EVEN, OffsetCoord.roffsetFromCube(OffsetCoord.EVEN, a)));
+        Tests.equalOffsetcoord("conversion_roundtrip even-r", b, OffsetCoord.roffsetFromCube(OffsetCoord.EVEN, OffsetCoord.roffsetToCube(OffsetCoord.EVEN, b)));
+        Tests.equalHex("conversion_roundtrip odd-r", a, OffsetCoord.roffsetToCube(OffsetCoord.ODD, OffsetCoord.roffsetFromCube(OffsetCoord.ODD, a)));
+        Tests.equalOffsetcoord("conversion_roundtrip odd-r", b, OffsetCoord.roffsetFromCube(OffsetCoord.ODD, OffsetCoord.roffsetToCube(OffsetCoord.ODD, b)));
+    }
+    static testOffsetFromCube() {
+        Tests.equalOffsetcoord("offset_from_cube even-q", new OffsetCoord(1, 3), OffsetCoord.qoffsetFromCube(OffsetCoord.EVEN, new Hex(1, 2, -3)));
+        Tests.equalOffsetcoord("offset_from_cube odd-q", new OffsetCoord(1, 2), OffsetCoord.qoffsetFromCube(OffsetCoord.ODD, new Hex(1, 2, -3)));
+    }
+    static testOffsetToCube() {
+        Tests.equalHex("offset_to_cube even-", new Hex(1, 2, -3), OffsetCoord.qoffsetToCube(OffsetCoord.EVEN, new OffsetCoord(1, 3)));
+        Tests.equalHex("offset_to_cube odd-q", new Hex(1, 2, -3), OffsetCoord.qoffsetToCube(OffsetCoord.ODD, new OffsetCoord(1, 2)));
+    }
+    static testDoubledRoundtrip() {
+        var a = new Hex(3, 4, -7);
+        var b = new DoubledCoord(1, -3);
+        Tests.equalHex("conversion_roundtrip doubled-q", a, DoubledCoord.qdoubledFromCube(a).qdoubledToCube());
+        Tests.equalDoubledcoord("conversion_roundtrip doubled-q", b, DoubledCoord.qdoubledFromCube(b.qdoubledToCube()));
+        Tests.equalHex("conversion_roundtrip doubled-r", a, DoubledCoord.rdoubledFromCube(a).rdoubledToCube());
+        Tests.equalDoubledcoord("conversion_roundtrip doubled-r", b, DoubledCoord.rdoubledFromCube(b.rdoubledToCube()));
+    }
+    static testDoubledFromCube() {
+        Tests.equalDoubledcoord("doubled_from_cube doubled-q", new DoubledCoord(1, 5), DoubledCoord.qdoubledFromCube(new Hex(1, 2, -3)));
+        Tests.equalDoubledcoord("doubled_from_cube doubled-r", new DoubledCoord(4, 2), DoubledCoord.rdoubledFromCube(new Hex(1, 2, -3)));
+    }
+    static testDoubledToCube() {
+        Tests.equalHex("doubled_to_cube doubled-q", new Hex(1, 2, -3), new DoubledCoord(1, 5).qdoubledToCube());
+        Tests.equalHex("doubled_to_cube doubled-r", new Hex(1, 2, -3), new DoubledCoord(4, 2).rdoubledToCube());
+    }
+    static testAll() {
+        Tests.testHexArithmetic();
+        Tests.testHexDirection();
+        Tests.testHexNeighbor();
+        Tests.testHexDiagonal();
+        Tests.testHexDistance();
+        Tests.testHexRotateRight();
+        Tests.testHexRotateLeft();
+        Tests.testHexRound();
+        Tests.testHexLinedraw();
+        Tests.testLayout();
+        Tests.testOffsetRoundtrip();
+        Tests.testOffsetFromCube();
+        Tests.testOffsetToCube();
+        Tests.testDoubledRoundtrip();
+        Tests.testDoubledFromCube();
+        Tests.testDoubledToCube();
+    }
+}
+// Tests
+function complain(name) { console.log("FAIL", name); }
+Tests.testAll();

package/holosphere.d.ts

@@ -0,0 +1,22 @@
+declare module 'holosphere' {
+    export default class HoloSphere {
+        constructor(name: string, openaikey?: string | null);
+        subscribe(hex: string, lense: string, callback: (item: any, key: string) => void): void;
+        put(hex: string, lense: string, content: any): Promise<void>;
+        delete(id: string, tag: string): Promise<void>;
+        get(hex: string, lense: string): Promise<any[]>;
+        getKey(hex: string, lense: string, key: string): Promise<any | null>;
+        getNode(hex: string, lense: string, key: string): Promise<any | null>;
+        compute(hex: string, lense: string, operation: string): Promise<void>;
+        clearlense(hex: string, lense: string): Promise<void>;
+        summarize(history: string): Promise<string>;
+        upcast(hex: string, lense: string, content: any): Promise<any>;
+        updateParent(id: string, report: string): Promise<any>;
+        getHex(lat: number, lng: number, resolution: number): Promise<string>;
+        getScalespace(lat: number, lng: number): string[];
+        getHexScalespace(hex: string): string[];
+        aggregateVotes(hexId: string, topic: string): object;
+        delegateVote(userId: string, topic: string, delegateTo: string): Promise<void>;
+        vote(userId: string, hexId: string, topic: string, vote: string): Promise<void>;
+    }
+}

package/{index.js → holosphere.js}

@@ -2,13 +2,17 @@ import * as h3 from 'h3-js';
 import OpenAI from 'openai';
 import Gun from 'gun'
 import Ajv2019 from 'ajv/dist/2019.js'
-import { createHash } from "crypto";
 
 class HoloSphere {
+    /**
+     * Initializes a new instance of the HoloSphere class.
+     * @param {string} appname - The name of the application.
+     * @param {string|null} openaikey - The OpenAI API key.
+     */
     constructor(appname, openaikey = null) {
         this.validator = new Ajv2019({ allErrors: false, strict: false });
         this.gun = Gun({
-            peers: [ 'http://localhost:8765','http://gun.holons.io', 'https://gun-eu.herokuapp.com/gun','https://59.src.eco/gun'],
+            peers: ['https://59.src.eco/gun'],
             axe: false,
             // uuid: (content) => { // generate a unique id for each node
             //     console.log('uuid', content);
@@ -16,119 +20,22 @@ class HoloSphere {
         });
 
         this.gun = this.gun.get(appname)
+        this.users = {}; // Initialize users
+        this.hexagonVotes = {}; // Initialize hexagonVotes
 
         if (openaikey != null) {
             this.openai = new OpenAI({
                 apiKey: openaikey,
             });
         }
-
-        //this.bot.command('sethex', async (ctx) => { this.setHex(ctx) }) TODO: MOVE HERE FROM SETTINGS
-
-        // this.bot.command('resethex', async (ctx) => {
-        //     let chatID = ctx.message.chat.id;
-        //     let hex = (await this.db.get('settings', chatID)).hex
-        //     this.delete(hex, ctx.message.text.split(' ')[1])
-        // })
-
-        // this.bot.command('get', async (ctx) => {
-        //     const chatID = ctx.message.chat.id;
-        //     const lense = ctx.message.text.split(' ')[1];
-        //     if (!lense) {
-        //         return ctx.reply('Please specify a tag.');
-        //     }
-        //     let hex = (await this.db.get('settings', chatID)).hex
-        //     //let hex = settings.hex
-        //     console.log('hex', hex)
-
-        //     let data = await this.get(ctx, hex, lense)
-
-        // })
-
-        // this.bot.command('gethex', async (ctx) => {
-        //     let settings = await this.db.get('settings', chatID)
-        //     let id = settings.hex ? settings.hex : 'Hex not set, use /sethex'
-        //     ctx.reply(id)
-        // })
-
-        // this.bot.command('compute', async (ctx) => {
-        //     const chatID = ctx.message.chat.id;
-        //     let operation = ctx.message.text.split(' ')[1];
-        //     if (operation != 'sum') {
-        //         ctx.reply('Operation not implemented')
-        //         return
-        //     }
-        //     let lense = ctx.message.text.split(' ')[2]
-        //     if (!lense) {
-        //         ctx.reply('Please specify a lense where to perform the operation ')
-        //         return
-        //     }
-        //     let hex = (await this.db.get('settings', chatID)).hex
-        //     await this.compute(hex, lense, operation)
-
-        //     // let parentInfo = await this.getCellInfo(parent)
-        //     // parentInfo.wisdom[id] = report
-        //     // //update summary
-        //     // let summary = await this.summarize(Object.values(parentInfo.wisdom).join('\n'))
-        //     // parentInfo.summary = summary
-
-        //     // await this.db.put('cell', parentInfo)
-        //     // return parentInfo
-
-        //     // let content = await this.db.getAll(hex+'/tags')
-        // })
-
-
-
-
-        // this.bot.command('cast', async (ctx) => {
-        //     if (!ctx.message.reply_to_message) {
-        //         return ctx.reply('Please reply to a message you want to tag.');
-        //     }
-        //     const tags = ctx.message.text.split(' ').slice(1);
-        //     if (tags.length === 0) {
-        //         return ctx.reply('Please provide at least one tag.');
-        //     }
-
-        //     const messageID = ctx.message.reply_to_message.message_id;
-        //     const chatID = ctx.message.chat.id;
-        //     const messageContent = ctx.message.reply_to_message.text;
-        //     let settings = await this.db.get('settings', chatID)
-        //     let id = settings.hex ? settings.hex : 'Hex not set, use /sethex'
-        //     //create root node for the item
-        //     let node = await this.gun.get(chatID + '/' + messageID).put({ id: chatID + '/' + messageID, content: messageContent })
-        //     for (let tag of tags) {
-        //         await this.gun.get(id).get(tag).set(node)
-        //         this.upcast(id, tag, node)
-        //     }
-        // })
-
-        // this.bot.command('publish', async (ctx) => {
-        //     console.log(ctx.message)
-        //     if (!ctx.message.reply_to_message) {
-        //         return ctx.reply('Please reply to a message you want to tag.');
-        //     }
-        //     const tags = ctx.message.text.split(' ').slice(1);
-        //     if (tags.length === 0) {
-        //         return ctx.reply('Please provide at least one tag.');
-        //     }
-
-        //     const messageID = ctx.message.reply_to_message.message_id;
-        //     const chatID = ctx.message.chat.id;
-        //     const messageContent = ctx.message.reply_to_message.text;
-        //     let settings = await this.db.get('settings', chatID)
-        //     let hex = settings.hex
-
-        //     for (let tag of tags) {
-        //         let node = await this.gun.get(chatID + '/' + messageID).put({ id: chatID + '/' + messageID, content: messageContent })
-        //         await this.put(hex, tag, node)
-        //     }
-
-        //     ctx.reply('Tag published.');
-        // });
-
     }
 
+    /**
+     * Sets the JSON schema for a specific lense.
+     * @param {string} lense - The lense identifier.
+     * @param {object} schema - The JSON schema to set.
+     * @returns {Promise} - Resolves when the schema is set.
+     */
     async setSchema(lense, schema) {
         return new Promise((resolve, reject) => {
             this.gun.get(lense).get('schema').put(JSON.stringify(schema), ack => {
@@ -142,6 +49,11 @@ class HoloSphere {
         })
     }
 
+    /**
+     * Retrieves the JSON schema for a specific lense.
+     * @param {string} lense - The lense identifier.
+     * @returns {Promise<object|null>} - The retrieved schema or null if not found.
+     */
     async getSchema(lense) {
         return new Promise((resolve) => {
             this.gun.get(lense).get('schema').once(data => {
@@ -160,28 +72,21 @@ class HoloSphere {
             })
         })
     }
-
-    async setHex(ctx) {
-        const chatID = ctx.message.chat.id;
-        const hex = ctx.message.text.split(' ')[1];
-        this.db.gun.get(hex).set('chats').put(chatID)
-        this.db.gun.get('settings').get(chatID).put(hex)
-        return hex
-    }
-
-    async getHexContent(ctx) {
-        const chatID = ctx.message.chat.id;
-        let settings = await this.getSettings(chatID)
-        let hex = settings.hex
-        let content = await this.db.getAll(hex + '/tags')
-        //console.log(content)
-        return content ? content[0].id : 'not found'
-    }
-
+    /**
+     * Deletes a specific tag from a given ID.
+     * @param {string} id - The identifier from which to delete the tag.
+     * @param {string} tag - The tag to delete.
+     */
     async delete(id, tag) {
         await this.gun.get(id).get(tag).put(null)
     }
 
+    /**
+     * Stores content in the specified hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense under which to store the content.
+     * @param {object} content - The content to store.
+     */
     async put(hex, lense, content) {
         // Retrieve the schema for the lense
         let schema = await this.getSchema(lense)
@@ -203,24 +108,25 @@ class HoloSphere {
             noderef = this.gun.get(lense).get(content.id).put(payload)
             this.gun.get(hex.toString()).get(lense).get(content.id).put(payload)
         } else { // create a content-addressable reference like IPFS. Note: no updates possible using put
-            const hash = createHash("sha256").update(payload).digest("hex");
-            noderef = this.gun.get(lense).get(hash).put(payload)
-            this.gun.get(hex.toString()).get(lense).get(hash).put(payload)
+            const hashBuffer = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(payload));
+            const hashArray = Array.from(new Uint8Array(hashBuffer));
+            const hashHex = hashArray.map(byte => byte.toString(16).padStart(2, "0")).join("");
+            noderef = this.gun.get(lense).get(hashHex).put(payload)
+            this.gun.get(hex.toString()).get(lense).get(hashHex).put(payload)
         }
 
-        // return new Promise((resolve, reject) => {
-        //     this.gun.get(hex.toString()).get(lense).set(noderef, ack => {
-        //         if (ack.err) {
-        //             reject(new Error('Failed to add content: ' + ack.err));
-        //         } else {
-        //             console.log('Content added successfully under tag:', lense);
-        //             resolve(ack);
-        //         }
-        //     });
-        // });
+    }
 
+    async putNode(hex, lense, node) {
+        this.gun.get(hex).get(lense).set(node)
     }
 
+    /**
+     * Retrieves content from the specified hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense from which to retrieve content.
+     * @returns {Promise<Array<object>>} - The retrieved content.
+     */
     async get(hex, lense) {
         // Wrap the GunDB operation in a promise
         //retrieve lense schema
@@ -241,11 +147,16 @@ class HoloSphere {
                     this.gun.get(hex.toString()).get(lense).map().once(async (itemdata, key) => {
                         counter += 1
                         if (itemdata) {
-                            // if (itemdata._["#"]) {
-                            //     // If the data is a reference, fetch the actual content
-                            //     itemdata = await this.gun.get(itemdata._['#']).then();
-                            //     console.log("Data :",itemdata)
-                            // }
+                            if (itemdata._["#"]) {
+                                
+                                // If the data is a reference, fetch the actual content
+                                let query  = itemdata._['#'].split('/')
+                                let hex = query[1]
+                                let lense = query[2]
+                                let key = query[3]
+                                itemdata = await this.getNode(hex, lense, key)
+
+                            }
                             var parsed = {}
                             try {
                                 parsed = JSON.parse(itemdata);
@@ -280,8 +191,47 @@ class HoloSphere {
         );
     }
 
-    // Operations
+       /**
+     * Retrieves a specific key from the specified hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense from which to retrieve the key.
+     * @param {string} key - The specific key to retrieve.
+     * @returns {Promise<object|null>} - The retrieved content or null if not found.
+     */
+       async getKey(hex, lense, key) {
+        return new Promise((resolve) => {
+            // Use Gun to get the data
+            this.gun.get(hex).get(lense).get(key).once((data, key) => {
+                if (data) {
+                    resolve(JSON.parse(data)); // Resolve the promise with the data if data is found
+                } else {
+                    resolve(null); // Reject the promise if no data is found
+                }
+            });
+        });
+
+    }
+
+    /**
+   * Retrieves a specific gundb node from the specified hex and lense.
+   * @param {string} hex - The hex identifier.
+   * @param {string} lense - The lense from which to retrieve the key.
+   * @param {string} key - The specific key to retrieve.
+   * @returns {Promise<object|null>} - The retrieved content or null if not found.
+   */
+     getNode(hex, lense, key) {
+        // Use Gun to get the data
+        return this.gun.get(hex).get(lense).get(key)
+    }
+
+
 
+    /**
+     * Computes summaries based on the content within a hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense to compute.
+     * @param {string} operation - The operation to perform.
+     */
     async compute(hex, lense, operation) {
 
         let res = h3.getResolution(hex);
@@ -301,7 +251,7 @@ class HoloSphere {
                     resolve(); // Resolve the promise to prevent it from hanging
                 }, 1000); // Timeout of 5 seconds
 
-                this.db.gun.get(siblings[i]).get(lense).map().once((data, key) => {
+                this.gun.get(siblings[i]).get(lense).map().once((data, key) => {
                     clearTimeout(timeout); // Clear the timeout if data is received
                     if (data) {
                         content.push(data.content);
@@ -321,6 +271,11 @@ class HoloSphere {
         this.compute(parent, lense, operation)
     }
 
+    /**
+     * Clears all entities under a specific hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense to clear.
+     */
     async clearlense(hex, lense) {
         let entities = {};
 
@@ -333,6 +288,11 @@ class HoloSphere {
     }
 
 
+    /**
+     * Summarizes provided history text using OpenAI.
+     * @param {string} history - The history text to summarize.
+     * @returns {Promise<string>} - The summarized text.
+     */
     async summarize(history) {
         if (!this.openai) {
             return 'OpenAI not initialized, please specify the API key in the constructor.'
@@ -365,21 +325,34 @@ class HoloSphere {
         return summary
     }
 
+    /**
+     * Upcasts content to parent hexagons recursively.
+     * @param {string} hex - The current hex identifier.
+     * @param {string} lense - The lense under which to upcast.
+     * @param {object} content - The content to upcast.
+     * @returns {Promise<object>} - The upcasted content.
+     */
     async upcast(hex, lense, content) {
         let res = h3.getResolution(hex)
-
-
-        console.log('Upcasting ', hex, lense, content)
-        let parent = h3.cellToParent(hex, res - 1)
-        await this.put(parent, lense, content)
-        if (res == 0)
+        if (res == 0) {
+            await this.putNode(hex, lense, content)
             return content
-        else
+        }
+        else {
+            console.log('Upcasting ', hex, lense, content, res)
+            await this.putNode(hex, lense, content)
+            let parent = h3.cellToParent(hex, res - 1)
             return this.upcast(parent, lense, content)
+        }
     }
 
 
-    // send information upwards, triggers the parent to update its summary
+    /**
+     * Updates the parent hexagon with a new report.
+     * @param {string} id - The child hex identifier.
+     * @param {string} report - The report to update.
+     * @returns {Promise<object>} - The updated parent information.
+     */
     async updateParent(id, report) {
         let cellinfo = await this.getCellInfo(id)
         let res = h3.getResolution(id)
@@ -395,11 +368,23 @@ class HoloSphere {
     }
 
 
+    /**
+     * Converts latitude and longitude to a hex identifier.
+     * @param {number} lat - The latitude.
+     * @param {number} lng - The longitude.
+     * @param {number} resolution - The resolution level.
+     * @returns {Promise<string>} - The resulting hex identifier.
+     */
     async getHex(lat, lng, resolution) {
         return h3.latLngToCell(lat, lng, resolution);
     }
 
-    // returns the list of all the containing hexagons at xall scales
+    /**
+     * Retrieves all containing hexagons at all scales for given coordinates.
+     * @param {number} lat - The latitude.
+     * @param {number} lng - The longitude.
+     * @returns {Array<string>} - List of hex identifiers.
+     */
     getScalespace(lat, lng) {
         let list = []
         let cell = h3.latLngToCell(lat, lng, 14);
@@ -410,7 +395,11 @@ class HoloSphere {
         return list
     }
 
-    // returns the list of all the containing hexagons at xall scales
+    /**
+     * Retrieves all containing hexagons at all scales for a given hex.
+     * @param {string} hex - The hex identifier.
+     * @returns {Array<string>} - List of hex identifiers.
+     */
     getHexScalespace(hex) {
         let list = []
         let res = h3.getResolution(hex)
@@ -420,43 +409,73 @@ class HoloSphere {
         return list
     }
 
+    /**
+     * Subscribes to changes in a specific hex and lense.
+     * @param {string} hex - The hex identifier.
+     * @param {string} lense - The lense to subscribe to.
+     * @param {function} callback - The callback to execute on changes.
+     */
     subscribe(hex, lense, callback) {
         this.gun.get(hex).get(lense).map().on((data, key) => {
             callback(data, key)
         })
     }
 
-    // VOTING SYSTEM
+    /**
+     * Retrieves the final vote for a user, considering delegations.
+     * @param {string} userId - The user's identifier.
+     * @param {string} topic - The voting topic.
+     * @param {object} votes - The current votes.
+     * @param {Set<string>} [visited=new Set()] - Set of visited users to prevent cycles.
+     * @returns {string|null} - The final vote or null if not found.
+     */
+    getFinalVote(userId, topic, votes, visited = new Set()) {
+        if (this.users[userId]) { // Added this.users
+            if (visited.has(userId)) {
+                return null; // Avoid circular delegations
+            }
+            visited.add(userId);
 
-     getFinalVote(userId, topic, votes, visited = new Set()) {
-  if (visited.has(userId)) {
-    return null; // Avoid circular delegations
-  }
-  visited.add(userId);
+            const delegation = this.users[userId].delegations[topic];
+            if (delegation && votes[delegation] === undefined) {
+                return this.getFinalVote(delegation, topic, votes, visited); // Prefixed with this
+            }
 
-  const delegation = users[userId].delegations[topic];
-  if (delegation && votes[delegation] === undefined) {
-    return getFinalVote(delegation, topic, votes, visited); // Follow delegation
-  }
+            return votes[userId] !== undefined ? votes[userId] : null;
+        }
+        return null;
+    }
 
-  return votes[userId] !== undefined ? votes[userId] : null; // Return direct vote or null
-}
+    /**
+     * Aggregates votes for a specific hex and topic.
+     * @param {string} hexId - The hex identifier.
+     * @param {string} topic - The voting topic.
+     * @returns {object} - Aggregated vote counts.
+     */
+    aggregateVotes(hexId, topic) {
+        if (!this.hexagonVotes[hexId] || !this.hexagonVotes[hexId][topic]) {
+            return {}; // Handle undefined votes
+        }
+        const votes = this.hexagonVotes[hexId][topic];
+        const aggregatedVotes = {};
 
- aggregateVotes(hexId, topic) {
-  const votes = hexagonVotes[hexId][topic];
-  const aggregatedVotes = {};
+        Object.keys(votes).forEach(userId => {
+            const finalVote = this.getFinalVote(userId, topic, votes); // Prefixed with this
+            if (finalVote !== null) {
+                aggregatedVotes[finalVote] = (aggregatedVotes[finalVote] || 0) + 1;
+            }
+        });
 
-  Object.keys(votes).forEach(userId => {
-    const finalVote = getFinalVote(userId, topic, votes);
-    if (finalVote !== null) {
-      aggregatedVotes[finalVote] = (aggregatedVotes[finalVote] || 0) + 1;
+        return aggregatedVotes;
     }
-  });
 
-  return aggregatedVotes;
-}
-
-async delegateVote(userId, topic, delegateTo) {
+    /**
+     * Delegates a user's vote to another user.
+     * @param {string} userId - The user's identifier.
+     * @param {string} topic - The voting topic.
+     * @param {string} delegateTo - The user to delegate the vote to.
+     */
+    async delegateVote(userId, topic, delegateTo) {
         const response = await fetch('/delegate', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
@@ -465,6 +484,13 @@ async delegateVote(userId, topic, delegateTo) {
         alert(await response.text());
     }
 
+    /**
+     * Casts a vote for a user on a specific topic and hex.
+     * @param {string} userId - The user's identifier.
+     * @param {string} hexId - The hex identifier.
+     * @param {string} topic - The voting topic.
+     * @param {string} vote - The vote choice.
+     */
     async vote(userId, hexId, topic, vote) {
         const response = await fetch('/vote', {
             method: 'POST',
@@ -475,6 +501,8 @@ async delegateVote(userId, topic, delegateTo) {
     }
 
 
+
+
 }
 
 export default HoloSphere;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "holosphere",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Holonic Geospatial Communication Infrastructure based on h3.js and gun.js",
-  "main": "index.js",
+  "main": "holosphere.js",
   "type": "module",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -11,7 +11,7 @@
   "license": "GPL-3.0-or-later",
   "dependencies": {
     "ajv": "^8.12.0",
-    "gun": "^0.2020.1239",
+    "gun": "^0.2020.1240",
     "h3-js": "^4.1.0",
     "openai": "^4.29.2"
   }