palbase 0.25.1 → 0.27.0

package/types/internal/src/modules/messaging.d.ts

@@ -80,15 +80,27 @@ export type AdminConversationRequest = {
      */
     photo?: string;
     settings?: GroupSettings;
+    /**
+     * The place of the app's it belongs to, as the app names it (org:<id>, project:<id>): 1 to 128 letters, digits and : _ . / @ -. Fixed as it is made; absent: none.
+     */
+    space?: string;
     /**
      * A group's title.
      */
     title?: string;
+    /**
+     * open (a space named: required): found in its space's open groups and joined by whom the project's hook lets (POST …/join); closed (the default): joined when someone adds you. A direct conversation is never open.
+     */
+    visibility?: "open" | "closed";
 };
 /**
- * A message the project's server says, as the app.
+ * A message the project's server says: as the app, or as one of the conversation's people (as_user_id, with via).
  */
 export type AdminMessageRequest = {
+    /**
+     * The person it is written as: one of the conversation's people now. The message is theirs, as if they sent it — what they may send there, their read of it, the others' unread counts and pushes, from them — and says via what wrote it. Each is in the access log, the person named.
+     */
+    as_user_id?: string;
     /**
      * The server's own id of it: sent again with it, it is the same message.
      */
@@ -101,6 +113,14 @@ export type AdminMessageRequest = {
      * What it says.
      */
     text: string;
+    /**
+     * The message whose thread it answers.
+     */
+    thread_id?: string;
+    /**
+     * What wrote it (as pal), shown with the message (Message.via): 1 to 32 letters, digits and _ . -. Required with as_user_id — the others always know it was not the person's own hand.
+     */
+    via?: string;
 };
 /**
  * The project's server's word on a person's name and picture.
@@ -115,6 +135,55 @@ export type AdminProfileRequest = {
      */
     name?: string | null;
 };
+/**
+ * What the project's server changes in a conversation: what its admins may, and whether it is read-only; what it names changes.
+ */
+export type AdminUpdateConversation = {
+    /**
+     * Who adds people.
+     */
+    add_policy?: "all" | "admins";
+    /**
+     * A group's description; null clears it.
+     */
+    description?: string | null;
+    /**
+     * Who changes details and timer.
+     */
+    edit_policy?: "all" | "admins";
+    /**
+     * Whether someone added reads what was said before them.
+     */
+    history_for_new_members?: boolean;
+    /**
+     * Where the app reads a group's picture; null clears it.
+     */
+    photo?: string | null;
+    /**
+     * Read-only: its people read what was said in it, nobody writes in it (no message, reaction, edit, file, or change to its details); false makes it writable again. Told in it as read_only_on / read_only_off.
+     */
+    read_only?: boolean;
+    /**
+     * Who writes: all or admins.
+     */
+    send_policy?: "all" | "admins";
+    /**
+     * How long a new message lives; null: for good.
+     */
+    timer_seconds?: number | null;
+    /**
+     * A group's title.
+     */
+    title?: string | null;
+    /**
+     * A direct conversation's vanish mode.
+     */
+    vanish?: boolean;
+    /**
+     * A group's: open (found in its space's open groups and joined by whom the project's hook lets; the group has a space — 400 space_required otherwise) or closed. Its admins' (or the project's server's); a person opening one is asked of the hook first (open_group): refused, 403 not_allowed. Opened, whoever joins reads what its history shows newcomers (history_for_new_members).
+     */
+    visibility?: "open" | "closed";
+};
 /**
  * A file a message carries.
  */
@@ -290,6 +359,10 @@ export type Conversation = {
      */
     photo: string | null;
     settings: ConversationSettings;
+    /**
+     * The place of the app's it belongs to (org:<id>, project:<id>), fixed as it was made; null: none. Always sent; absent (an answer kept from before it was): null.
+     */
+    space?: string | null;
     /**
      * A group's title.
      */
@@ -298,6 +371,10 @@ export type Conversation = {
      * How many times it changed.
      */
     version: number;
+    /**
+     * open: a group found in its space's open groups and joined by whom the project's hook lets; closed: joined when someone adds you (every direct conversation). Always sent; absent (an answer kept from before it was): closed.
+     */
+    visibility?: "open" | "closed";
 };
 /**
  * A conversation made, and whom it did not take.
@@ -329,6 +406,10 @@ export type ConversationCreatedEvent = {
      * Its people.
      */
     member_ids: string[];
+    /**
+     * Its space; null: none.
+     */
+    space?: string | null;
 };
 /**
  * messaging.conversation.deleted
@@ -353,6 +434,31 @@ export type ConversationPage = {
      */
     next_cursor?: string;
 };
+/**
+ * messaging.conversation.read
+ */
+export type ConversationReadEvent = {
+    /**
+     * The conversation.
+     */
+    conversation_id: string;
+    /**
+     * How far they read it (a message's seq).
+     */
+    read_seq: number;
+    /**
+     * The conversation's space; null: none.
+     */
+    space: string | null;
+    /**
+     * The thread they read; null: the conversation itself.
+     */
+    thread_id: string | null;
+    /**
+     * Who read it.
+     */
+    user_id: string;
+};
 /**
  * How a conversation runs.
  */
@@ -369,6 +475,10 @@ export type ConversationSettings = {
      * Whether someone added reads what was said before them.
      */
     history_for_new_members: boolean;
+    /**
+     * Read-only (the project's server's word): its people read what was said in it, nobody writes in it — no message, reaction, edit, file, or change to its details; the server still may. Always sent; absent (an answer kept from before it was): false.
+     */
+    read_only?: boolean;
     /**
      * Who writes in the group: all or admins.
      */
@@ -383,9 +493,13 @@ export type ConversationSettings = {
     vanish: boolean;
 };
 /**
- * Opens the direct conversation with a person.
+ * Opens the direct conversation with a person, in a space.
  */
 export type DirectRequest = {
+    /**
+     * The space it is in (org:<id>): the pair has one direct conversation in each space, and one with none. 1 to 128 letters, digits and : _ . / @ -; absent: none.
+     */
+    space?: string;
     /**
      * The other person.
      */
@@ -472,10 +586,18 @@ export type GroupRequest = {
      */
     photo?: string;
     settings?: GroupSettings;
+    /**
+     * The place of the app's it belongs to, as the app names it (org:<id>, project:<id>): 1 to 128 letters, digits and : _ . / @ -. Fixed as it is made; absent: none.
+     */
+    space?: string;
     /**
      * Its title.
      */
     title: string;
+    /**
+     * open (a space named: required): found in its space's open groups and joined by whom the project's hook lets (POST …/join); closed (the default): joined when someone adds you. A person's open group is asked of the project's hook first (open_group, the space named): refused, 403 not_allowed.
+     */
+    visibility?: "open" | "closed";
 };
 /**
  * How a group runs, as it is made.
@@ -520,7 +642,7 @@ export type HiddenMessage = {
  */
 export type HookSettings = {
     /**
-     * When it does not answer: allow everyone, or deny (the client retries).
+     * When it does not answer: allow everyone, or deny (the client retries). Allow is for a direct conversation and people added to a group alone: a space's open groups — having one, finding them, joining one — are refused (503 hook_unavailable) while it is silent, whatever this says.
      */
     on_error: "allow" | "deny";
     /**
@@ -537,7 +659,7 @@ export type HookSettings = {
  */
 export type HookSettingsRequest = {
     /**
-     * allow or deny (default).
+     * allow or deny (default). Allow never opens a space's open groups (open_group, list_open, join): those are refused while the hook is silent.
      */
     on_error?: "allow" | "deny";
     /**
@@ -788,11 +910,76 @@ export type Message = {
      * How many times it changed (a reaction, an answer in its thread, an edit).
      */
     version: number;
+    /**
+     * What the project's server wrote it through, as one of the conversation's people or as the app (as pal): show it beside the message ("sent by Pal"). null: its writer wrote it. Always sent; absent (an answer kept from before it was): null.
+     */
+    via?: string | null;
     /**
      * When it is seen a limited number of times.
      */
     view_once: ViewOnce | null;
 };
+/**
+ * messaging.message.created
+ */
+export type MessageCreatedEvent = {
+    /**
+     * The conversation.
+     */
+    conversation_id: string;
+    /**
+     * direct or group.
+     */
+    conversation_kind: string;
+    /**
+     * When it was written.
+     */
+    created_at: string;
+    /**
+     * Whether it carries files.
+     */
+    has_attachments: boolean;
+    /**
+     * text or media (files).
+     */
+    kind: string;
+    /**
+     * Whom its words name.
+     */
+    mention_ids: string[];
+    /**
+     * The message: read it with the secret key (GET /messaging/admin/conversations/{conversation_id}/messages).
+     */
+    message_id: string;
+    /**
+     * Whom it is for: the conversation's people but its writer (and one blocking them, whom it never reaches).
+     */
+    recipient_ids: string[];
+    /**
+     * Its writer; null: the project's server, as the app.
+     */
+    sender_id: string | null;
+    /**
+     * Its place in the conversation.
+     */
+    seq: number;
+    /**
+     * The conversation's space; null: none.
+     */
+    space: string | null;
+    /**
+     * What it says, when the project lets the event say it (settings.event_text) — never a message meant to go (vanish mode, seen a limited number of times, living a while): the event stream keeps an event 7 days; absent otherwise.
+     */
+    text?: string;
+    /**
+     * The message whose thread it answers; null: none.
+     */
+    thread_id: string | null;
+    /**
+     * What the project's server wrote it through (as pal); null: its writer wrote it.
+     */
+    via: string | null;
+};
 export type MessagePage = {
     /**
      * The messages.
@@ -845,9 +1032,9 @@ export type MyProfile = {
  */
 export type NotAdded = {
     /**
-     * not_allowed (the project's hook did not let them be reached, or they block whoever added them) or group_full.
+     * not_allowed (the project's hook did not let them be reached, or they block whoever added them), group_full, or user_deleted (their account was deleted).
      */
-    reason: "not_allowed" | "group_full";
+    reason: "not_allowed" | "group_full" | "user_deleted";
     /**
      * The person.
      */
@@ -866,6 +1053,54 @@ export type NotificationsRequest = {
      */
     notify_level?: "all" | "mentions" | "none";
 };
+/**
+ * An open group of a space, as one who may find it reads it.
+ */
+export type OpenGroup = {
+    /**
+     * When it was made.
+     */
+    created_at: string;
+    /**
+     * Its description.
+     */
+    description: string | null;
+    /**
+     * The group.
+     */
+    id: string;
+    /**
+     * Whether the reader is in it.
+     */
+    joined: boolean;
+    /**
+     * When something was last said in it; null: nothing yet.
+     */
+    last_message_at: string | null;
+    /**
+     * How many people are in it.
+     */
+    member_count: number;
+    /**
+     * Where the app reads its picture.
+     */
+    photo: string | null;
+    /**
+     * Its space.
+     */
+    space: string;
+    /**
+     * Its title.
+     */
+    title: string | null;
+};
+export type OpenGroupPage = {
+    data: OpenGroup[];
+    /**
+     * The next page's cursor; absent on the last.
+     */
+    next_cursor?: string;
+};
 /**
  * A person as the conversations show them.
  */
@@ -1348,6 +1583,10 @@ export type Settings = {
      * A deleted user's messages: keep (their writer anonymous) or delete.
      */
     deleted_user_messages: "keep" | "delete";
+    /**
+     * Whether messaging.message.created says what the message says (text) — never a message meant to go (vanish mode, seen a limited number of times, living a while): the words leave the sealed store for the project's backend, kept on the event stream for 7 days. false: the backend reads the message with the secret key. Always sent; absent: false.
+     */
+    event_text?: boolean;
     /**
      * The hook asked whom one may reach; null: anyone may reach anyone.
      */
@@ -1377,6 +1616,10 @@ export type SettingsRequest = {
      * keep or delete.
      */
     deleted_user_messages?: "keep" | "delete";
+    /**
+     * Whether messaging.message.created says what the message says (text).
+     */
+    event_text?: boolean;
     /**
      * The hook; null removes it.
      */
@@ -1456,7 +1699,7 @@ export type SystemEvent = {
      */
     title?: string;
     /**
-     * What happened: created, members_added, member_left, member_removed, role_changed, title_changed, description_changed, photo_changed, timer_changed, vanish_on, vanish_off, settings_changed, screenshot.
+     * What happened: created, members_added, member_joined (one joined an open group by themselves), member_left, member_removed, role_changed, title_changed, description_changed, photo_changed, timer_changed, vanish_on, vanish_off, settings_changed, read_only_on, read_only_off, screenshot. A person whose account was deleted is named deleted_… here, as everywhere.
      */
     type: string;
     /**
@@ -1559,6 +1802,10 @@ export type UpdateConversation = {
      * A direct conversation's vanish mode.
      */
     vanish?: boolean;
+    /**
+     * A group's: open (found in its space's open groups and joined by whom the project's hook lets; the group has a space — 400 space_required otherwise) or closed. Its admins' (or the project's server's); a person opening one is asked of the hook first (open_group): refused, 403 not_allowed. Opened, whoever joins reads what its history shows newcomers (history_for_new_members).
+     */
+    visibility?: "open" | "closed";
 };
 /**
  * Changes a member's role.
@@ -1739,6 +1986,14 @@ export interface Events {
      * messaging.conversation.deleted: a conversation was deleted for everyone.
      */
     "messaging.conversation.deleted": ConversationDeletedEvent;
+    /**
+     * messaging.conversation.read: a person read a conversation, or a thread of it, further (a read receipt, or clearing it). Told only to the endpoints that name it, and written only while one does.
+     */
+    "messaging.conversation.read": ConversationReadEvent;
+    /**
+     * messaging.message.created: a message reached a conversation — a person's, or the project's server's (as the app, or as a person: via) — with whom it is for and whom it names. Told only to the endpoints that name it (an endpoint of every event is not sent it), and written only while one does.
+     */
+    "messaging.message.created": MessageCreatedEvent;
     /**
      * messaging.report.created: a person reported a conversation, someone in it or messages of it; read it with the secret key.
      */
@@ -1761,13 +2016,15 @@ export declare function client(t: Transport): {
     /**
      * The project's conversations
      *
-     * The project's conversations (a person's, when `user_id` names one), the latest first.
+     * The project's conversations (a person's, when `user_id` names one; the direct one of two, when `with` names the other), the latest first.
      */
     adminListConversations(input?: {
         query?: {
-            user_id?: string; /** How many (1 to 100; 30 when absent). */
+            user_id?: string; /** Another person, beside user_id: the direct conversation of the two (none when they have none): their direct conversations in every space (space narrows them). */
+            with?: string; /** How many (1 to 100; 30 when absent). */
             limit?: number; /** The cursor a page handed out (next_cursor). */
-            cursor?: string;
+            cursor?: string; /** Only the conversations of these spaces: one space a parameter, repeated for more, at most 20. */
+            space?: string[];
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, ConversationPage>>;
@@ -1802,6 +2059,18 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<204, undefined>>;
+    /**
+     * Change a conversation, or make it read-only
+     *
+     * The project's server changes a conversation as its admins may — a group's title, description, picture, timer and policies; a direct conversation's timer and vanish mode — and makes it read-only, or writable again: its people read what was said in it, nobody writes in it (no message, reaction, edit, file, or change to its details), while the server still may (POST …/messages). Each change is told in the conversation, as a message of the platform's.
+     */
+    adminUpdateConversation(input: {
+        path: {
+            conversation_id: string;
+        };
+        body: AdminUpdateConversation; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Conversation>>;
     /**
      * Add people to a group
      *
@@ -1844,7 +2113,7 @@ export declare function client(t: Transport): {
     /**
      * Say something in a conversation
      *
-     * The project's server says something in a conversation, as the app. Sent again with the same `client_message_id`, it is the same message.
+     * The project's server says something in a conversation — as the app (sender_id null), or as one of its people (as_user_id, with via): the message is theirs, as if they sent it (what they may send there, their read of it, the others' unread counts and pushes, from them), and says what wrote it (Message.via). In a thread too (thread_id). Sent again with the same client_message_id, it is the same message (200).
      */
     adminSendMessage(input: {
         path: {
@@ -1881,7 +2150,7 @@ export declare function client(t: Transport): {
     /**
      * A person's name and picture
      *
-     * The project's server names a person and gives their picture, as its own records say.
+     * The project's server names a person and gives their picture, as its own records say. A person whose account was deleted is not given one again (`409 user_deleted`): a sync racing the deletion does not bring them back.
      */
     adminPutProfile(input: {
         path: {
@@ -1975,12 +2244,13 @@ export declare function client(t: Transport): {
     /**
      * The reader's conversations
      *
-     * The signed-in person's conversations, the latest first, with their own place in each, what they have not read and the last message each shows. A direct conversation someone else opened shows once something is said in it; one they cleared, once something new is.
+     * The signed-in person's conversations (of the spaces it names, when it names any), the latest first, with their own place in each, what they have not read and the last message each shows. A direct conversation someone else opened shows once something is said in it; one they cleared, once something new is.
      */
     listConversations(input?: {
         query?: {
             limit?: number; /** The cursor a page handed out (next_cursor). */
-            cursor?: string;
+            cursor?: string; /** Only the conversations of these spaces: one space a parameter, repeated for more (space=org:a&space=org:b), at most 20. */
+            space?: string[];
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, ConversationPage>>;
@@ -2061,6 +2331,17 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<204, undefined>>;
+    /**
+     * Join an open group
+     *
+     * The reader joins an open group by themselves — when the project's hook lets them (action join, the group and its space named; with no hook, anyone) and it has room. They read it as one added to it does (its history when it shows it to newcomers), and its people are told (member_joined). Joining one they are in answers it as it is. One an admin removed does not join again by themselves.
+     */
+    joinGroup(input: {
+        path: {
+            conversation_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Conversation>>;
     /**
      * A conversation's people
      *
@@ -2309,6 +2590,19 @@ export declare function client(t: Transport): {
         body: UploadRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<201, Upload>>;
+    /**
+     * A space's open groups
+     *
+     * A space's open groups, the oldest first, each with whether the reader is in it — when the project's hook lets the reader find them (action list_open, the space named; with no hook, anyone). Join one with POST /messaging/conversations/{conversation_id}/join.
+     */
+    listOpenGroups(input: {
+        query: {
+            space: string; /** How many (1 to 100; 50 when absent). */
+            limit?: number; /** The cursor a page handed out (next_cursor). */
+            cursor?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, OpenGroupPage>>;
     /**
      * The reader's own profile
      *
@@ -2404,7 +2698,8 @@ export declare function client(t: Transport): {
             by?: "words" | "meaning"; /** Search one conversation of the reader's only. */
             conversation_id?: string; /** How many (1 to 50; 20 when absent). */
             limit?: number; /** The cursor a page handed out (next_cursor). */
-            cursor?: string;
+            cursor?: string; /** Search only the conversations of these spaces: one space a parameter, repeated for more, at most 20. */
+            space?: string[];
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, SearchPage>>;
@@ -2419,7 +2714,7 @@ export declare function client(t: Transport): {
     /**
      * Change how the project runs its conversations
      *
-     * What it names changes: how long messages are kept (null: for good), whether pushes say what a message says, what becomes of a deleted user's messages, and the hook asked whom one may reach (null: none). The hook is POSTed `{event: "messaging.can_message", action: "direct" | "group_add", from_user_id, to_user_ids, conversation_id}`, signed as Standard Webhooks sign (webhook-id, webhook-timestamp, webhook-signature), and answers 200 `{allowed_user_ids: [...]}`. A hook set for the first time is given its signing secret, here, once.
+     * What it names changes: how long messages are kept (null: for good), whether pushes say what a message says, what becomes of a deleted user's messages, the hook asked whom one may reach (null: none), and whether messaging.message.created says what a message says (event_text). The hook is POSTed `{event: "messaging.can_message", action: "direct" | "group_add" | "open_group" | "list_open" | "join", from_user_id, to_user_ids, conversation_id, space}` — whom of to_user_ids from_user_id may reach (a direct conversation, a group they are added to), or, to_user_ids being [from_user_id], whether they may have an open group in a space (open_group: making one, or opening theirs), find a space's open groups (list_open) or join one (join); space is the conversation's (absent: none), signed as Standard Webhooks sign (webhook-id, webhook-timestamp, webhook-signature), and answers 200 `{allowed_user_ids: [...]}`. A hook set for the first time is given its signing secret, here, once.
      */
     putSettings(input: {
         body: SettingsRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */

package/types/server/src/server.d.ts

@@ -35,6 +35,14 @@ export interface PalbaseServer {
     fields: Fields;
     flags: ReturnType<typeof modules.flags.client>;
     machines: ReturnType<typeof modules.machines.client>;
+    /**
+     * The messaging module's calls as its contract states them. The project's server makes its admin ones with the
+     * secret key: a conversation for people (adminCreateConversation, in a space), a message as the app or as one of
+     * the conversation's people (adminSendMessage with as_user_id and via: "pal" — the others see it was not their own
+     * hand), its conversations by person, pair or space (adminListConversations). A person's own calls are their app's
+     * (palbase/web, the iOS and Android SDKs), with their session.
+     */
+    messaging: ReturnType<typeof modules.messaging.client>;
     notify: ReturnType<typeof modules.notify.client>;
     purchases: ReturnType<typeof modules.purchases.client>;
     realtime: ReturnType<typeof modules.realtime.client>;

package/types/web/src/messaging.d.ts

@@ -11,6 +11,7 @@ export type Profile = api.Profile;
 export type ScheduledMessage = api.ScheduledMessage;
 export type ThreadState = api.ThreadState;
 export type SearchMatch = api.SearchMatch;
+export type OpenGroup = api.OpenGroup;
 export type { DeletedGroup, Entry, Hit, OutboxItem } from '../../internal/src/messaging/index.js';
 export interface MessagingOptions {
     /**
@@ -117,6 +118,8 @@ export interface SearchOptions {
     by?: 'words' | 'meaning';
     /** Search one conversation of the person's only. */
     conversationId?: string;
+    /** Search the conversations of one space only (org:<id>): a place of the app's they belong to. */
+    space?: string;
     /** How many messages a page holds (1 to 50; 20 when absent). */
     limit?: number;
     /** The page after the one that handed out this cursor (nextCursor): a search by words alone. */
@@ -256,8 +259,13 @@ export declare class Messaging {
     private seat;
     private typed;
     private tell;
-    /** The person's conversations, the latest first, kept up to date. */
-    conversations(): ConversationList;
+    /**
+     * The person's conversations, the latest first, kept up to date — those of some spaces only (spaces: the places of
+     * the app's they belong to, as org:<id>), when it names any.
+     */
+    conversations(opts?: {
+        spaces?: string[];
+    }): ConversationList;
     /**
      * The groups the person was in that someone deleted, kept up to date while the person may still report them
      * (reportableUntil, 14 days after), the latest to stop first: report() names one by its id, no message needed. A
@@ -273,15 +281,27 @@ export declare class Messaging {
     conversation(conversationId: string, opts?: {
         at?: string;
     }): ConversationView;
-    /** The direct conversation with someone — the one there is, or a new one. */
-    direct(userId: string): Promise<ConversationView>;
-    /** A new group, the person its owner. */
+    /**
+     * The direct conversation with someone — the one there is, or a new one — in a space (org:<id>): the two have one in
+     * each space, and one with none. The project's hook is asked, the space named.
+     */
+    direct(userId: string, opts?: {
+        space?: string;
+    }): Promise<ConversationView>;
+    /**
+     * A new group, the person its owner — in a space (org:<id>), and open (found in the space's open groups and joined
+     * by whom the project's hook lets: openGroups, join) or closed (the default: joined when someone adds you). An open
+     * group names its space ('space_required'), and the project's hook is asked whether the person may make one there
+     * ('open_group'; refused: 'not_allowed').
+     */
     group(input: {
         title: string;
         memberIds?: string[];
         description?: string;
         photo?: string;
         settings?: api.GroupSettings;
+        space?: string;
+        visibility?: 'open' | 'closed';
     }): Promise<{
         conversation: ConversationView;
         notAdded: api.NotAdded[];
@@ -301,8 +321,26 @@ export declare class Messaging {
      * means instead, the nearest first, each with its score: one page, no conversations by name. Opened as any find is.
      */
     search(query: string, opts?: SearchOptions): Promise<SearchResults>;
-    /** The person's conversations whose name says every word asked: a group's title, the other person's name. */
+    /** The person's conversations (of a space, when one is named) whose name says every word asked: a group's title, the other person's name. */
     private named;
+    /**
+     * A space's open groups (org:<id>), the oldest first, a page at a time — each with whether the person is in it
+     * (joined) — when the project's hook lets them find them; refused otherwise (a PalbaseError, code 'not_allowed').
+     */
+    openGroups(space: string, opts?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: OpenGroup[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Joins an open group by themselves — when the project's hook lets them and it has room — and answers it, the person
+     * in it. Joining one they are in answers it as it is. Refused (a PalbaseError) when the hook does not let them
+     * ('not_allowed'), an admin removed them ('removed'), it is read-only ('read_only') or full ('group_full'); a closed
+     * group is not found.
+     */
+    join(conversationId: string): Promise<ConversationView>;
     /** The person's messages scheduled for later, kept up to date. */
     scheduled(): ScheduledList;
     /** The threads the person follows, the latest answered first. */
@@ -373,6 +411,9 @@ declare abstract class View<S> implements Observed<S> {
     protected abstract read(): S;
 }
 export declare class ConversationList extends View<ConversationListState> {
+    /** The spaces it is narrowed to (none: every conversation). */
+    readonly spaces: readonly string[];
+    constructor(m: Messaging, spaces?: readonly string[]);
     protected touches(t: Touched): boolean;
     protected read(): ConversationListState;
 }