cojson 0.10.15 → 0.11.0

package/dist/coValues/coList.d.ts

@@ -0,0 +1,163 @@
+import { CoID, RawCoValue } from "../coValue.js";
+import { CoValueCore } from "../coValueCore.js";
+import { AgentID, SessionID, TransactionID } from "../ids.js";
+import { JsonObject, JsonValue } from "../jsonValue.js";
+import { RawAccountID } from "./account.js";
+import { RawGroup } from "./group.js";
+export type OpID = TransactionID & {
+    changeIdx: number;
+};
+export type InsertionOpPayload<T extends JsonValue> = {
+    op: "pre";
+    value: T;
+    before: OpID | "end";
+} | {
+    op: "app";
+    value: T;
+    after: OpID | "start";
+};
+export type DeletionOpPayload = {
+    op: "del";
+    insertion: OpID;
+};
+export type ListOpPayload<T extends JsonValue> = InsertionOpPayload<T> | DeletionOpPayload;
+type InsertionEntry<T extends JsonValue> = {
+    madeAt: number;
+    predecessors: OpID[];
+    successors: OpID[];
+} & InsertionOpPayload<T>;
+type DeletionEntry = {
+    madeAt: number;
+    deletionID: OpID;
+} & DeletionOpPayload;
+export declare class RawCoListView<Item extends JsonValue = JsonValue, Meta extends JsonObject | null = null> implements RawCoValue {
+    /** @category 6. Meta */
+    id: CoID<this>;
+    /** @category 6. Meta */
+    type: "colist" | "coplaintext";
+    /** @category 6. Meta */
+    core: CoValueCore;
+    /** @internal */
+    afterStart: OpID[];
+    /** @internal */
+    beforeEnd: OpID[];
+    /** @internal */
+    insertions: {
+        [sessionID: SessionID]: {
+            [txIdx: number]: {
+                [changeIdx: number]: InsertionEntry<Item>;
+            };
+        };
+    };
+    /** @internal */
+    deletionsByInsertion: {
+        [deletedSessionID: SessionID]: {
+            [deletedTxIdx: number]: {
+                [deletedChangeIdx: number]: DeletionEntry[];
+            };
+        };
+    };
+    /** @category 6. Meta */
+    readonly _item: Item;
+    /** @internal */
+    _cachedEntries?: {
+        value: Item;
+        madeAt: number;
+        opID: OpID;
+    }[];
+    /** @internal */
+    constructor(core: CoValueCore);
+    /** @category 6. Meta */
+    get headerMeta(): Meta;
+    /** @category 6. Meta */
+    get group(): RawGroup;
+    /**
+     * Not yet implemented
+     *
+     * @category 4. Time travel
+     */
+    atTime(_time: number): this;
+    /**
+     * Get the item currently at `idx`.
+     *
+     * @category 1. Reading
+     */
+    get(idx: number): Item | undefined;
+    /**
+     * Returns the current items in the CoList as an array.
+     *
+     * @category 1. Reading
+     **/
+    asArray(): Item[];
+    /** @internal */
+    entries(): {
+        value: Item;
+        madeAt: number;
+        opID: OpID;
+    }[];
+    /** @internal */
+    entriesUncached(): {
+        value: Item;
+        madeAt: number;
+        opID: OpID;
+    }[];
+    /** @internal */
+    private fillArrayFromOpID;
+    /**
+     * Returns the current items in the CoList as an array. (alias of `asArray`)
+     *
+     * @category 1. Reading
+     */
+    toJSON(): Item[];
+    /** @category 5. Edit history */
+    editAt(idx: number): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+    } | undefined;
+    /** @category 5. Edit history */
+    deletionEdits(): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+    }[];
+    /** @category 3. Subscription */
+    subscribe(listener: (coList: this) => void): () => void;
+}
+export declare class RawCoList<Item extends JsonValue = JsonValue, Meta extends JsonObject | null = JsonObject | null> extends RawCoListView<Item, Meta> implements RawCoValue {
+    /** Appends `item` after the item currently at index `after`.
+     *
+     * If `privacy` is `"private"` **(default)**, `item` is encrypted in the transaction, only readable by other members of the group this `CoList` belongs to. Not even sync servers can see the content in plaintext.
+     *
+     * If `privacy` is `"trusting"`, `item` is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     *
+     * @category 2. Editing
+     **/
+    append(item: Item, after?: number, privacy?: "private" | "trusting"): void;
+    appendItems(items: Item[], after?: number, privacy?: "private" | "trusting"): void;
+    /**
+     * Prepends `item` before the item currently at index `before`.
+     *
+     * If `privacy` is `"private"` **(default)**, `item` is encrypted in the transaction, only readable by other members of the group this `CoList` belongs to. Not even sync servers can see the content in plaintext.
+     *
+     * If `privacy` is `"trusting"`, `item` is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     *
+     * @category 2. Editing
+     */
+    prepend(item: Item, before?: number, privacy?: "private" | "trusting"): void;
+    /** Deletes the item at index `at`.
+     *
+     * If `privacy` is `"private"` **(default)**, the fact of this deletion is encrypted in the transaction, only readable by other members of the group this `CoList` belongs to. Not even sync servers can see the content in plaintext.
+     *
+     * If `privacy` is `"trusting"`, the fact of this deletion is stored in plaintext in the transaction, visible to everyone who gets a hold of it, including sync servers.
+     *
+     * @category 2. Editing
+     **/
+    delete(at: number, privacy?: "private" | "trusting"): void;
+    replace(at: number, newItem: Item, privacy?: "private" | "trusting"): void;
+    /** @internal */
+    rebuildFromCore(): void;
+}
+export {};
+//# sourceMappingURL=coList.d.ts.map

package/dist/coValues/coList.d.ts.map

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

package/dist/coValues/coMap.d.ts

@@ -0,0 +1,142 @@
+import { CoID, RawCoValue } from "../coValue.js";
+import { CoValueCore } from "../coValueCore.js";
+import { AgentID, TransactionID } from "../ids.js";
+import { JsonObject, JsonValue } from "../jsonValue.js";
+import { CoValueKnownState } from "../sync.js";
+import { RawAccountID } from "./account.js";
+import type { RawGroup } from "./group.js";
+type MapOp<K extends string, V extends JsonValue | undefined> = {
+    txID: TransactionID;
+    madeAt: number;
+    changeIdx: number;
+    change: MapOpPayload<K, V>;
+};
+export type MapOpPayload<K extends string, V extends JsonValue | undefined> = {
+    op: "set";
+    key: K;
+    value: V;
+} | {
+    op: "del";
+    key: K;
+};
+export declare class RawCoMapView<Shape extends {
+    [key: string]: JsonValue | undefined;
+} = {
+    [key: string]: JsonValue | undefined;
+}, Meta extends JsonObject | null = JsonObject | null> implements RawCoValue {
+    /** @category 6. Meta */
+    id: CoID<this>;
+    /** @category 6. Meta */
+    type: "comap";
+    /** @category 6. Meta */
+    core: CoValueCore;
+    /** @internal */
+    latest: {
+        [Key in keyof Shape & string]?: MapOp<Key, Shape[Key]>;
+    };
+    /** @internal */
+    latestTxMadeAt: number;
+    /** @internal */
+    ops: {
+        [Key in keyof Shape & string]?: MapOp<Key, Shape[Key]>[];
+    };
+    /** @internal */
+    knownTransactions: CoValueKnownState["sessions"];
+    /** @internal */
+    ignorePrivateTransactions: boolean;
+    /** @internal */
+    atTimeFilter?: number;
+    /** @category 6. Meta */
+    readonly _shape: Shape;
+    /** @internal */
+    constructor(core: CoValueCore, options?: {
+        ignorePrivateTransactions: boolean;
+    });
+    processNewTransactions(): void;
+    isTimeTravelEntity(): boolean;
+    /** @category 6. Meta */
+    get headerMeta(): Meta;
+    /** @category 6. Meta */
+    get group(): RawGroup;
+    /** @category 4. Time travel */
+    atTime(time: number): this;
+    /** @internal */
+    timeFilteredOps<K extends keyof Shape & string>(key: K): MapOp<K, Shape[K]>[] | undefined;
+    /**
+     * Get all keys currently in the map.
+     *
+     * @category 1. Reading */
+    keys<K extends keyof Shape & string = keyof Shape & string>(): K[];
+    getRaw<K extends keyof Shape & string>(key: K): ({ [Key in keyof Shape & string]?: MapOp<Key, Shape[Key]> | undefined; }[K] & {}) | undefined;
+    /**
+     * Returns the current value for the given key.
+     *
+     * @category 1. Reading
+     **/
+    get<K extends keyof Shape & string>(key: K): Shape[K] | undefined;
+    /** @category 1. Reading */
+    asObject(): {
+        [K in keyof Shape & string]: Shape[K];
+    };
+    /** @category 1. Reading */
+    toJSON(): {
+        [K in keyof Shape & string]: Shape[K];
+    };
+    /** @category 5. Edit history */
+    nthEditAt<K extends keyof Shape & string>(key: K, n: number): {
+        by: RawAccountID | `sealer_z${string}/signer_z${string}`;
+        tx: TransactionID;
+        at: Date;
+        value: Shape[K] | undefined;
+    } | undefined;
+    /** @category 5. Edit history */
+    lastEditAt<K extends keyof Shape & string>(key: K): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value?: Shape[K];
+    } | undefined;
+    /** @category 5. Edit history */
+    editsAt<K extends keyof Shape & string>(key: K): Generator<{
+        by: RawAccountID | `sealer_z${string}/signer_z${string}`;
+        tx: TransactionID;
+        at: Date;
+        value: Shape[K] | undefined;
+    }, void, unknown>;
+    /** @category 3. Subscription */
+    subscribe(listener: (coMap: this) => void): () => void;
+}
+/** A collaborative map with precise shape `Shape` and optional static metadata `Meta` */
+export declare class RawCoMap<Shape extends {
+    [key: string]: JsonValue | undefined;
+} = {
+    [key: string]: JsonValue | undefined;
+}, Meta extends JsonObject | null = JsonObject | null> extends RawCoMapView<Shape, Meta> implements RawCoValue {
+    /** Set 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. Editing
+     **/
+    set<K extends keyof Shape & string>(key: K, value: Shape[K], privacy?: "private" | "trusting"): void;
+    assign(entries: Partial<Shape>, privacy?: "private" | "trusting"): void;
+    /** Delete 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.
+     *
+     * @category 2. Editing
+     **/
+    delete(key: keyof Shape & string, privacy?: "private" | "trusting"): void;
+}
+export declare function operationToEditEntry<K extends string, V extends JsonValue | undefined>(op: MapOp<K, V>): {
+    by: RawAccountID | `sealer_z${string}/signer_z${string}`;
+    tx: TransactionID;
+    at: Date;
+    value: V | undefined;
+};
+export {};
+//# sourceMappingURL=coMap.d.ts.map

package/dist/coValues/coMap.d.ts.map

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

package/dist/coValues/coPlainText.d.ts

@@ -0,0 +1,33 @@
+import { CoValueCore } from "../coValueCore.js";
+import { JsonObject } from "../jsonValue.js";
+import { OpID, RawCoList } from "./coList.js";
+export type StringifiedOpID = string & {
+    __stringifiedOpID: true;
+};
+export declare function stringifyOpID(opID: OpID): StringifiedOpID;
+type PlaintextIdxMapping = {
+    opIDbeforeIdx: OpID[];
+    opIDafterIdx: OpID[];
+    idxAfterOpID: {
+        [opID: StringifiedOpID]: number;
+    };
+    idxBeforeOpID: {
+        [opID: StringifiedOpID]: number;
+    };
+};
+export declare class RawCoPlainText<Meta extends JsonObject | null = JsonObject | null> extends RawCoList<string, Meta> {
+    /** @category 6. Meta */
+    type: "coplaintext";
+    private _segmenter;
+    _cachedMapping: WeakMap<NonNullable<typeof this._cachedEntries>, PlaintextIdxMapping>;
+    constructor(core: CoValueCore);
+    get mapping(): PlaintextIdxMapping;
+    toString(): string;
+    insertAfter(idx: number, text: string, privacy?: "private" | "trusting"): void;
+    deleteRange({ from, to }: {
+        from: number;
+        to: number;
+    }, privacy?: "private" | "trusting"): void;
+}
+export {};
+//# sourceMappingURL=coPlainText.d.ts.map

package/dist/coValues/coPlainText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coPlainText.d.ts","sourceRoot":"","sources":["../../src/coValues/coPlainText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAqB,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IAAE,iBAAiB,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CAEzD;AAED,KAAK,mBAAmB,GAAG;IACzB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,YAAY,EAAE;QAAE,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAA;KAAE,CAAC;IAClD,aAAa,EAAE;QAAE,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,qBAAa,cAAc,CACzB,IAAI,SAAS,UAAU,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAClD,SAAQ,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;IAC/B,wBAAwB;IACxB,IAAI,gBAA0B;IAE9B,OAAO,CAAC,UAAU,CAAiB;IAEnC,cAAc,EAAE,OAAO,CACrB,WAAW,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,EACvC,mBAAmB,CACpB,CAAC;gBAEU,IAAI,EAAE,WAAW;IAa7B,IAAI,OAAO,wBA6BV;IAED,QAAQ;IAMR,WAAW,CACT,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,SAAS,GAAG,UAAsB;IAoB7C,WAAW,CACT,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAC1C,OAAO,GAAE,SAAS,GAAG,UAAsB;CAsB9C"}

package/dist/coValues/coStream.d.ts

@@ -0,0 +1,109 @@
+import { CoID, RawCoValue } from "../coValue.js";
+import { CoValueCore } from "../coValueCore.js";
+import { AgentID, SessionID, TransactionID } from "../ids.js";
+import { JsonObject, JsonValue } from "../jsonValue.js";
+import { CoValueKnownState } from "../sync.js";
+import { RawAccountID } from "./account.js";
+import { RawGroup } from "./group.js";
+export type BinaryStreamInfo = {
+    mimeType: string;
+    fileName?: string;
+    totalSizeBytes?: number;
+};
+export type BinaryStreamStart = {
+    type: "start";
+} & BinaryStreamInfo;
+export type BinaryStreamChunk = {
+    type: "chunk";
+    chunk: `binary_U${string}`;
+};
+export type BinaryStreamEnd = {
+    type: "end";
+};
+export type BinaryCoStreamMeta = JsonObject & {
+    type: "binary";
+};
+export type BinaryStreamItem = BinaryStreamStart | BinaryStreamChunk | BinaryStreamEnd;
+export type CoStreamItem<Item extends JsonValue> = {
+    value: Item;
+    tx: TransactionID;
+    madeAt: number;
+};
+export declare class RawCoStreamView<Item extends JsonValue = JsonValue, Meta extends JsonObject | null = JsonObject | null> implements RawCoValue {
+    id: CoID<this>;
+    type: "costream";
+    core: CoValueCore;
+    items: {
+        [key: SessionID]: CoStreamItem<Item>[];
+    };
+    /** @internal */
+    knownTransactions: CoValueKnownState["sessions"];
+    readonly _item: Item;
+    constructor(core: CoValueCore);
+    get headerMeta(): Meta;
+    get group(): RawGroup;
+    /** Not yet implemented */
+    atTime(_time: number): this;
+    /** @internal */
+    protected processNewTransactions(): void;
+    getSingleStream(): Item[] | undefined;
+    sessions(): SessionID[];
+    accounts(): Set<RawAccountID>;
+    nthItemIn(sessionID: SessionID, n: number): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+    } | undefined;
+    lastItemIn(sessionID: SessionID): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+    } | undefined;
+    itemsIn(sessionID: SessionID): Generator<{
+        by: RawAccountID | `sealer_z${string}/signer_z${string}`;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+    }, void, unknown>;
+    lastItemBy(account: RawAccountID | AgentID): {
+        by: RawAccountID | AgentID;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+    } | undefined;
+    itemsBy(account: RawAccountID | AgentID): Generator<{
+        by: RawAccountID | `sealer_z${string}/signer_z${string}`;
+        tx: TransactionID;
+        at: Date;
+        value: Item;
+        in: SessionID;
+    }, void, unknown>;
+    toJSON(): {
+        [key: SessionID]: Item[];
+    };
+    subscribe(listener: (coStream: this) => void): () => void;
+}
+export declare class RawCoStream<Item extends JsonValue = JsonValue, Meta extends JsonObject | null = JsonObject | null> extends RawCoStreamView<Item, Meta> implements RawCoValue {
+    push(item: Item, privacy?: "private" | "trusting"): void;
+}
+export declare class RawBinaryCoStreamView<Meta extends BinaryCoStreamMeta = {
+    type: "binary";
+}> extends RawCoStreamView<BinaryStreamItem, Meta> implements RawCoValue {
+    isBinaryStreamEnded(): boolean;
+    getBinaryChunks(allowUnfinished?: boolean): (BinaryStreamInfo & {
+        chunks: Uint8Array[];
+        finished: boolean;
+    }) | undefined;
+}
+export declare class RawBinaryCoStream<Meta extends BinaryCoStreamMeta = {
+    type: "binary";
+}> extends RawBinaryCoStreamView<Meta> implements RawCoValue {
+    /** @internal */
+    push(item: BinaryStreamItem, privacy?: "private" | "trusting", updateView?: boolean): void;
+    startBinaryStream(settings: BinaryStreamInfo, privacy?: "private" | "trusting"): void;
+    pushBinaryStreamChunk(chunk: Uint8Array, privacy?: "private" | "trusting"): void;
+    endBinaryStream(privacy?: "private" | "trusting"): void;
+}
+//# sourceMappingURL=coStream.d.ts.map

package/dist/coValues/coStream.d.ts.map

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

package/dist/coValues/group.d.ts

@@ -0,0 +1,143 @@
+import { CoID } from "../coValue.js";
+import { CoValueUniqueness } from "../coValueCore.js";
+import { Encrypted, KeyID, KeySecret, Sealed } from "../crypto/crypto.js";
+import { AgentID, ChildGroupReference, ParentGroupReference } from "../ids.js";
+import { JsonObject } from "../jsonValue.js";
+import { AccountRole, Role } from "../permissions.js";
+import { ControlledAccountOrAgent, RawAccount, RawAccountID } from "./account.js";
+import { RawCoList } from "./coList.js";
+import { RawCoMap } from "./coMap.js";
+import { RawCoPlainText } from "./coPlainText.js";
+import { RawBinaryCoStream, RawCoStream } from "./coStream.js";
+export declare const EVERYONE: "everyone";
+export type Everyone = "everyone";
+export type ParentGroupReferenceRole = "revoked" | "extend" | "reader" | "writer" | "admin";
+export type GroupShape = {
+    profile: CoID<RawCoMap> | null;
+    root: CoID<RawCoMap> | null;
+    [key: RawAccountID | AgentID]: Role;
+    [EVERYONE]?: Role;
+    readKey?: KeyID;
+    [writeKeyFor: `writeKeyFor_${RawAccountID | AgentID}`]: KeyID;
+    [revelationFor: `${KeyID}_for_${RawAccountID | AgentID}`]: Sealed<KeySecret>;
+    [revelationFor: `${KeyID}_for_${Everyone}`]: KeySecret;
+    [oldKeyForNewKey: `${KeyID}_for_${KeyID}`]: Encrypted<KeySecret, {
+        encryptedID: KeyID;
+        encryptingID: KeyID;
+    }>;
+    [parent: ParentGroupReference]: ParentGroupReferenceRole;
+    [child: ChildGroupReference]: "revoked" | "extend";
+};
+/** A `Group` is a scope for permissions of its members (`"reader" | "writer" | "admin"`), applying to objects owned by that group.
+ *
+ *  A `Group` object exposes methods for permission management and allows you to create new CoValues owned by that group.
+ *
+ *  (Internally, a `Group` is also just a `CoMap`, mapping member accounts to roles and containing some
+ *  state management for making cryptographic keys available to current members)
+ *
+ *  @example
+ *  You typically get a group from a CoValue that you already have loaded:
+ *
+ *  ```typescript
+ *  const group = coMap.group;
+ *  ```
+ *
+ *  @example
+ *  Or, you can create a new group with a `LocalNode`:
+ *
+ *  ```typescript
+ *  const localNode.createGroup();
+ *  ```
+ * */
+export declare class RawGroup<Meta extends JsonObject | null = JsonObject | null> extends RawCoMap<GroupShape, Meta> {
+    /**
+     * Returns the current role of a given account.
+     *
+     * @category 1. Role reading
+     */
+    roleOf(accountID: RawAccountID | typeof EVERYONE): Role | undefined;
+    /** @internal */
+    roleOfInternal(accountID: RawAccountID | AgentID | typeof EVERYONE): {
+        role: Role;
+        via: CoID<RawGroup> | undefined;
+    } | undefined;
+    getParentGroups(atTime?: number): {
+        group: RawGroup;
+        role: ParentGroupReferenceRole;
+    }[];
+    loadAllChildGroups(): Promise<unknown[]>;
+    getChildGroups(): RawGroup<JsonObject | null>[];
+    /**
+     * Returns the role of the current account in the group.
+     *
+     * @category 1. Role reading
+     */
+    myRole(): Role | undefined;
+    /**
+     * Directly grants a new member a role in the group. The current account must be an
+     * admin to be able to do so. Throws otherwise.
+     *
+     * @category 2. Role changing
+     */
+    addMember(account: RawAccount | ControlledAccountOrAgent | Everyone, role: Role): void;
+    /** @internal */
+    addMemberInternal(account: RawAccount | ControlledAccountOrAgent | AgentID | Everyone, role: Role): void;
+    private storeKeyRevelationForMember;
+    private getWriteOnlyKeys;
+    getCurrentReadKeyId(): `key_z${string}` | undefined;
+    getMemberKeys(): (RawAccountID | AgentID)[];
+    getAllMemberKeysSet(): Set<RawAccountID | `sealer_z${string}/signer_z${string}`>;
+    /** @internal */
+    rotateReadKey(removedMemberKey?: RawAccountID | AgentID | "everyone"): void;
+    /** Detect circular references in group inheritance */
+    isSelfExtension(parent: RawGroup): boolean;
+    extend(parent: RawGroup, role?: "reader" | "writer" | "admin" | "inherit"): void;
+    revokeExtend(parent: RawGroup): Promise<void>;
+    /**
+     * Strips the specified member of all roles (preventing future writes in
+     *  the group and owned values) and rotates the read encryption key for that group
+     * (preventing reads of new content in the group and owned values)
+     *
+     * @category 2. Role changing
+     */
+    removeMember(account: RawAccount | ControlledAccountOrAgent | Everyone): Promise<void>;
+    /** @internal */
+    removeMemberInternal(account: RawAccount | ControlledAccountOrAgent | AgentID | Everyone): void;
+    /**
+     * Creates an invite for new members to indirectly join the group,
+     * allowing them to grant themselves the specified role with the InviteSecret
+     * (a string starting with "inviteSecret_") - use `LocalNode.acceptInvite()` for this purpose.
+     *
+     * @category 2. Role changing
+     */
+    createInvite(role: AccountRole): InviteSecret;
+    /**
+     * Creates a new `CoMap` within this group, with the specified specialized
+     * `CoMap` type `M` and optional static metadata.
+     *
+     * @category 3. Value creation
+     */
+    createMap<M extends RawCoMap>(init?: M["_shape"], meta?: M["headerMeta"], initPrivacy?: "trusting" | "private", uniqueness?: CoValueUniqueness): M;
+    /**
+     * Creates a new `CoList` within this group, with the specified specialized
+     * `CoList` type `L` and optional static metadata.
+     *
+     * @category 3. Value creation
+     */
+    createList<L extends RawCoList>(init?: L["_item"][], meta?: L["headerMeta"], initPrivacy?: "trusting" | "private", uniqueness?: CoValueUniqueness): L;
+    /**
+     * Creates a new `CoPlainText` within this group, with the specified specialized
+     * `CoPlainText` type `T` and optional static metadata.
+     *
+     * @category 3. Value creation
+     */
+    createPlainText<T extends RawCoPlainText>(init?: string, meta?: T["headerMeta"], initPrivacy?: "trusting" | "private"): T;
+    /** @category 3. Value creation */
+    createStream<C extends RawCoStream>(meta?: C["headerMeta"], uniqueness?: CoValueUniqueness): C;
+    /** @category 3. Value creation */
+    createBinaryStream<C extends RawBinaryCoStream>(meta?: C["headerMeta"], uniqueness?: CoValueUniqueness): C;
+}
+export declare function isInheritableRole(roleInParent: Role | undefined): roleInParent is "revoked" | "admin" | "writer" | "reader";
+export type InviteSecret = `inviteSecret_z${string}`;
+export declare function secretSeedFromInviteSecret(inviteSecret: InviteSecret): Uint8Array;
+//# sourceMappingURL=group.d.ts.map

package/dist/coValues/group.d.ts.map

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