cojson 0.2.2 → 0.3.0-alpha.0

package/dist/coValues/coMap.js

@@ -1,27 +1,18 @@
-import { accountOrAgentIDfromSessionID } from '../coValueCore.js';
-import { isAccountID } from '../account.js';
-import { parseJSON } from '../jsonStringify.js';
-/** A collaborative map with precise shape `M` and optional static metadata `Meta` */
-export class CoMap {
+import { isCoValue } from "../coValue.js";
+import { accountOrAgentIDfromSessionID } from "../coValueCore.js";
+import { parseJSON } from "../jsonStringify.js";
+export class CoMapView {
     /** @internal */
     constructor(core) {
+        /** @category 6. Meta */
         this.type = "comap";
+        /** @internal */
+        this.atTimeFilter = undefined;
         this.id = core.id;
         this.core = core;
         this.ops = {};
-        this.fillOpsFromCoValue();
-    }
-    get meta() {
-        return this.core.header.meta;
-    }
-    get group() {
-        return this.core.getGroup();
-    }
-    /** @internal */
-    fillOpsFromCoValue() {
-        this.ops = {};
-        for (const { txID, changes, madeAt } of this.core.getValidSortedTransactions()) {
-            for (const [changeIdx, changeUntyped] of (parseJSON(changes)).entries()) {
+        for (const { txID, changes, madeAt, } of core.getValidSortedTransactions()) {
+            for (const [changeIdx, changeUntyped] of parseJSON(changes).entries()) {
                 const change = changeUntyped;
                 let entries = this.ops[change.key];
                 if (!entries) {
@@ -37,144 +28,205 @@ export class CoMap {
             }
         }
     }
-    keys() {
-        return Object.keys(this.ops);
+    /** @category 6. Meta */
+    get meta() {
+        return this.core.header.meta;
     }
-    /** Returns the current value for the given key. */
-    get(key) {
-        const ops = this.ops[key];
-        if (!ops) {
-            return undefined;
-        }
-        const lastEntry = ops[ops.length - 1];
-        if (lastEntry.op === "del") {
-            return undefined;
+    /** @category 6. Meta */
+    get group() {
+        return this.core.getGroup();
+    }
+    /** @category 4. Time travel */
+    atTime(time) {
+        const clone = Object.create(this);
+        clone.id = this.id;
+        clone.type = this.type;
+        clone.core = this.core;
+        clone.ops = this.ops;
+        clone.atTimeFilter = time;
+        return clone;
+    }
+    /** @internal */
+    timeFilteredOps(key) {
+        if (this.atTimeFilter) {
+            return this.ops[key]?.filter((op) => op.madeAt <= this.atTimeFilter);
         }
         else {
-            return lastEntry.value;
+            return this.ops[key];
         }
     }
-    getAtTime(key, time) {
-        const ops = this.ops[key];
-        if (!ops) {
-            return undefined;
-        }
-        const lastOpBeforeOrAtTime = ops.findLast((op) => op.madeAt <= time);
-        if (!lastOpBeforeOrAtTime) {
-            return undefined;
-        }
-        if (lastOpBeforeOrAtTime.op === "del") {
-            return undefined;
+    /**
+     * Get all keys currently in the map.
+     *
+     * @category 1. Reading */
+    keys() {
+        const keys = Object.keys(this.ops);
+        if (this.atTimeFilter) {
+            return keys.filter((key) => {
+                this.timeFilteredOps(key)?.length;
+            });
         }
         else {
-            return lastOpBeforeOrAtTime.value;
+            return keys;
         }
     }
-    /** Returns the accountID of the last account to modify the value for the given key. */
-    whoEdited(key) {
-        const tx = this.getLastTxID(key);
-        if (!tx) {
+    /**
+     * Returns the current value for the given key.
+     *
+     * @category 1. Reading
+     **/
+    get(key) {
+        const ops = this.timeFilteredOps(key);
+        if (!ops) {
             return undefined;
         }
-        const accountID = accountOrAgentIDfromSessionID(tx.sessionID);
-        if (isAccountID(accountID)) {
-            return accountID;
+        const includeUntil = this.atTimeFilter;
+        const lastEntry = includeUntil
+            ? ops.findLast((entry) => entry.madeAt <= includeUntil)
+            : ops[ops.length - 1];
+        if (lastEntry?.op === "del") {
+            return undefined;
         }
         else {
-            return undefined;
+            return lastEntry?.value;
         }
     }
-    getLastTxID(key) {
-        const ops = this.ops[key];
-        if (!ops) {
-            return undefined;
+    /** @category 1. Reading */
+    asObject() {
+        const object = {};
+        for (const key of this.keys()) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                object[key] = value;
+            }
         }
-        const lastEntry = ops[ops.length - 1];
-        return lastEntry.txID;
+        return object;
     }
-    getLastEntry(key) {
-        const ops = this.ops[key];
-        if (!ops) {
+    /** @category 1. Reading */
+    toJSON() {
+        return this.asObject();
+    }
+    /** @category 5. Edit history */
+    nthEditAt(key, n) {
+        const ops = this.timeFilteredOps(key);
+        if (!ops || ops.length <= n) {
             return undefined;
         }
-        const lastEntry = ops[ops.length - 1];
-        if (lastEntry.op === "del") {
+        const entry = ops[n];
+        if (this.atTimeFilter && entry.madeAt > this.atTimeFilter) {
             return undefined;
         }
-        else {
-            return { at: lastEntry.madeAt, txID: lastEntry.txID, value: lastEntry.value };
+        return {
+            by: accountOrAgentIDfromSessionID(entry.txID.sessionID),
+            tx: entry.txID,
+            at: new Date(entry.madeAt),
+            value: entry.op === "del" ? undefined : entry.value,
+        };
+    }
+    /** @category 5. Edit history */
+    lastEditAt(key) {
+        const ops = this.timeFilteredOps(key);
+        if (!ops || ops.length === 0) {
+            return undefined;
         }
+        return this.nthEditAt(key, ops.length - 1);
     }
-    getHistory(key) {
-        const ops = this.ops[key];
+    /** @category 5. Edit history */
+    *editsAt(key) {
+        const ops = this.timeFilteredOps(key);
         if (!ops) {
-            return [];
-        }
-        const history = [];
-        for (const op of ops) {
-            if (op.op === "del") {
-                history.push({ at: op.madeAt, txID: op.txID, value: undefined });
-            }
-            else {
-                history.push({ at: op.madeAt, txID: op.txID, value: op.value });
-            }
+            return;
         }
-        return history;
-    }
-    toJSON() {
-        const json = {};
-        for (const key of this.keys()) {
-            const value = this.get(key);
-            if (value !== undefined) {
-                json[key] = value;
-            }
+        for (let i = 0; i < ops.length; i++) {
+            yield this.nthEditAt(key, i);
         }
-        return json;
     }
+    /** @category 3. Subscription */
     subscribe(listener) {
         return this.core.subscribe((content) => {
             listener(content);
         });
     }
-    edit(changer) {
-        const editable = new WriteableCoMap(this.core);
-        changer(editable);
-        return new CoMap(this.core);
-    }
 }
-export class WriteableCoMap extends CoMap {
-    /** @internal */
-    edit(_changer) {
-        throw new Error("Already editing.");
+/** A collaborative map with precise shape `Shape` and optional static metadata `Meta` */
+export class CoMap extends CoMapView {
+    set(...args) {
+        if (typeof args[0] === "string") {
+            const [key, value, privacy = "private"] = args;
+            this.core.makeTransaction([
+                {
+                    op: "set",
+                    key,
+                    value: isCoValue(value) ? value.id : value,
+                },
+            ], privacy);
+        }
+        else {
+            const [kv, privacy = "private"] = args;
+            for (const [key, value] of Object.entries(kv)) {
+                this.core.makeTransaction([
+                    {
+                        op: "set",
+                        key,
+                        value: isCoValue(value) ? value.id : value,
+                    },
+                ], privacy);
+            }
+        }
+        return new CoMap(this.core);
     }
-    /** Sets a new value for the given key.
+    /** Returns a new version of this CoMap with the given key deleted (setting it to undefined).
      *
-     * If `privacy` is `"private"` **(default)**, both `key` and `value` are encrypted in the transaction, only readable by other members of the group this `CoMap` belongs to. Not even sync servers can see the content in plaintext.
+     * If `privacy` is `"private"` **(default)**, `key` is encrypted in the transaction, only readable by other members of the group this `CoMap` belongs to. Not even sync servers can see the content in plaintext.
      *
-     * If `privacy` is `"trusting"`, both `key` and `value` are stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers. */
-    set(key, value, privacy = "private") {
+     * If `privacy` is `"trusting"`, `key` is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     *
+     * @category 2. Editing
+     **/
+    delete(key, privacy = "private") {
         this.core.makeTransaction([
             {
-                op: "set",
+                op: "del",
                 key,
-                value,
             },
         ], privacy);
-        this.fillOpsFromCoValue();
+        return new CoMap(this.core);
+    }
+    /** @category 2. Editing */
+    mutate(mutator) {
+        const mutable = new MutableCoMap(this.core);
+        mutator(mutable);
+        return new CoMap(this.core);
+    }
+    /** @deprecated Use `mutate` instead. */
+    edit(mutator) {
+        return this.mutate(mutator);
+    }
+}
+export class MutableCoMap extends CoMapView {
+    /** Sets a new value for the given key.
+     *
+     * If `privacy` is `"private"` **(default)**, both `key` and `value` are encrypted in the transaction, only readable by other members of the group this `CoMap` belongs to. Not even sync servers can see the content in plaintext.
+     *
+     * If `privacy` is `"trusting"`, both `key` and `value` are stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     *
+     * @category 2. Mutation
+     */
+    set(key, value, privacy = "private") {
+        // eslint-disable-next-line @typescript-eslint/ban-types
+        const after = CoMap.prototype.set.call(this, key, value, privacy);
+        this.ops = after.ops;
     }
     /** Deletes the value for the given key (setting it to undefined).
      *
      * If `privacy` is `"private"` **(default)**, `key` is encrypted in the transaction, only readable by other members of the group this `CoMap` belongs to. Not even sync servers can see the content in plaintext.
      *
-     * If `privacy` is `"trusting"`, `key` is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers. */
+     * If `privacy` is `"trusting"`, `key` is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     * @category 2. Mutation
+     */
     delete(key, privacy = "private") {
-        this.core.makeTransaction([
-            {
-                op: "del",
-                key,
-            },
-        ], privacy);
-        this.fillOpsFromCoValue();
+        const after = CoMap.prototype.delete.call(this, key, privacy);
+        this.ops = after.ops;
     }
 }
 //# sourceMappingURL=coMap.js.map

package/dist/coValues/coMap.js.map

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

package/dist/coValues/coStream.d.ts

@@ -1,17 +1,17 @@
 import { JsonObject, JsonValue } from "../jsonValue.js";
-import { CoID, ReadableCoValue, WriteableCoValue } from "../coValue.js";
+import { CoValue, CoID } from "../coValue.js";
 import { CoValueCore } from "../coValueCore.js";
 import { Group } from "../group.js";
-import { SessionID } from "../ids.js";
-import { AccountID } from "../index.js";
-export type BinaryChunkInfo = {
+import { AgentID, SessionID, TransactionID } from "../ids.js";
+import { AccountID } from "../account.js";
+export type BinaryStreamInfo = {
     mimeType: string;
     fileName?: string;
     totalSizeBytes?: number;
 };
 export type BinaryStreamStart = {
     type: "start";
-} & BinaryChunkInfo;
+} & BinaryStreamInfo;
 export type BinaryStreamChunk = {
     type: "chunk";
     chunk: `binary_U${string}`;
@@ -23,56 +23,101 @@ export type BinaryCoStreamMeta = JsonObject & {
     type: "binary";
 };
 export type BinaryStreamItem = BinaryStreamStart | BinaryStreamChunk | BinaryStreamEnd;
-export declare class CoStream<T extends JsonValue, Meta extends JsonObject | null = null> implements ReadableCoValue {
-    id: CoID<CoStream<T, Meta>>;
+export type CoStreamItem<Item extends JsonValue | CoValue> = {
+    value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+    tx: TransactionID;
+    madeAt: number;
+};
+export declare class CoStreamView<Item extends JsonValue | CoValue, Meta extends JsonObject | null = null> implements CoValue {
+    id: CoID<this>;
     type: "costream";
     core: CoValueCore;
     items: {
-        [key: SessionID]: {
-            item: T;
-            madeAt: number;
-        }[];
+        [key: SessionID]: CoStreamItem<Item>[];
     };
+    readonly _item: Item;
     constructor(core: CoValueCore);
     get meta(): Meta;
     get group(): Group;
+    /** Not yet implemented */
+    atTime(_time: number): this;
     /** @internal */
     protected fillFromCoValue(): void;
-    getSingleStream(): T[] | undefined;
-    getLastItemsPerAccount(): {
-        [account: AccountID]: T | undefined;
-    };
-    getLastItemFrom(account: AccountID): T | undefined;
-    getLastItemFromMe(): T | undefined;
+    getSingleStream(): (Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>)[] | undefined;
+    sessions(): SessionID[];
+    accounts(): Set<AccountID | AgentID>;
+    nthItemIn(sessionID: SessionID, n: number): {
+        by: AccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+    } | undefined;
+    lastItemIn(sessionID: SessionID): {
+        by: AccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+    } | undefined;
+    itemsIn(sessionID: SessionID): Generator<{
+        by: `sealer_z${string}/signer_z${string}` | AccountID;
+        tx: TransactionID;
+        at: Date;
+        value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+    }, void, unknown>;
+    lastItemBy(account: AccountID | AgentID): {
+        by: AccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+    } | undefined;
+    itemsBy(account: AccountID | AgentID): Generator<{
+        by: `sealer_z${string}/signer_z${string}` | AccountID;
+        tx: TransactionID;
+        at: Date;
+        value: Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>;
+        in: `sealer_z${string}/signer_z${string}_session_z${string}` | `co_z${string}_session_z${string}`;
+    }, void, unknown>;
     toJSON(): {
-        [key: SessionID]: T[];
+        [key: SessionID]: (Item extends CoValue ? CoID<Item> : Exclude<Item, CoValue>)[];
     };
-    subscribe(listener: (coMap: CoStream<T, Meta>) => void): () => void;
-    edit(changer: (editable: WriteableCoStream<T, Meta>) => void): CoStream<T, Meta>;
+    subscribe(listener: (coStream: this) => void): () => void;
 }
-export declare class BinaryCoStream<Meta extends BinaryCoStreamMeta = {
+export declare class CoStream<Item extends JsonValue | CoValue, Meta extends JsonObject | null = null> extends CoStreamView<Item, Meta> implements CoValue {
+    push(item: Item extends CoValue ? Item | CoID<Item> : Item, privacy?: "private" | "trusting"): this;
+    mutate(mutator: (mutable: MutableCoStream<Item, Meta>) => void): this;
+    /** @deprecated Use `mutate` instead. */
+    edit(mutator: (mutable: MutableCoStream<Item, Meta>) => void): this;
+}
+export declare class MutableCoStream<Item extends JsonValue | CoValue, Meta extends JsonObject | null = null> extends CoStreamView<Item, Meta> implements CoValue {
+    push(item: Item extends CoValue ? Item | CoID<Item> : Item, privacy?: "private" | "trusting"): void;
+}
+export declare class BinaryCoStreamView<Meta extends BinaryCoStreamMeta = {
     type: "binary";
-}> extends CoStream<BinaryStreamItem, Meta> implements ReadableCoValue {
-    id: CoID<BinaryCoStream<Meta>>;
-    getBinaryChunks(allowUnfinished?: boolean): (BinaryChunkInfo & {
+}> extends CoStreamView<BinaryStreamItem, Meta> implements CoValue {
+    id: CoID<this>;
+    getBinaryChunks(allowUnfinished?: boolean): (BinaryStreamInfo & {
         chunks: Uint8Array[];
         finished: boolean;
     }) | undefined;
-    edit(changer: (editable: WriteableBinaryCoStream<Meta>) => void): BinaryCoStream<Meta>;
 }
-export declare class WriteableCoStream<T extends JsonValue, Meta extends JsonObject | null = null> extends CoStream<T, Meta> implements WriteableCoValue {
+export declare class BinaryCoStream<Meta extends BinaryCoStreamMeta = {
+    type: "binary";
+}> extends BinaryCoStreamView<Meta> implements CoValue {
     /** @internal */
-    edit(_changer: (editable: WriteableCoStream<T, Meta>) => void): CoStream<T, Meta>;
-    push(item: T, privacy?: "private" | "trusting"): void;
+    push(item: BinaryStreamItem, privacy?: "private" | "trusting"): this;
+    startBinaryStream(settings: BinaryStreamInfo, privacy?: "private" | "trusting"): this;
+    pushBinaryStreamChunk(chunk: Uint8Array, privacy?: "private" | "trusting"): this;
+    endBinaryStream(privacy?: "private" | "trusting"): this;
+    mutate(mutator: (mutable: MutableBinaryCoStream<Meta>) => void): this;
+    /** @deprecated Use `mutate` instead. */
+    edit(mutator: (mutable: MutableBinaryCoStream<Meta>) => void): this;
 }
-export declare class WriteableBinaryCoStream<Meta extends BinaryCoStreamMeta = {
+export declare class MutableBinaryCoStream<Meta extends BinaryCoStreamMeta = {
     type: "binary";
-}> extends BinaryCoStream<Meta> implements WriteableCoValue {
-    /** @internal */
-    edit(_changer: (editable: WriteableBinaryCoStream<Meta>) => void): BinaryCoStream<Meta>;
+}> extends BinaryCoStreamView<Meta> implements CoValue {
     /** @internal */
     push(item: BinaryStreamItem, privacy?: "private" | "trusting"): void;
-    startBinaryStream(settings: BinaryChunkInfo, privacy?: "private" | "trusting"): void;
+    startBinaryStream(settings: BinaryStreamInfo, privacy?: "private" | "trusting"): void;
     pushBinaryStreamChunk(chunk: Uint8Array, privacy?: "private" | "trusting"): void;
     endBinaryStream(privacy?: "private" | "trusting"): void;
 }