@alkemio/matrix-adapter-lib 0.6.2 → 1.0.0-beta2

package/README.md

@@ -1,3 +1,205 @@
-# matrix-adapter-lib
+# @alkem-io/matrix-adapter-go-lib
 
-Library of types for working with the Alkemio matrix adapter service.
+TypeScript library providing type-safe DTOs and event types for interacting with the Alkemio Matrix Adapter service.
+
+## Installation
+
+```bash
+# npm
+npm install @alkem-io/matrix-adapter-go-lib
+
+# pnpm
+pnpm add @alkem-io/matrix-adapter-go-lib
+
+# yarn
+yarn add @alkem-io/matrix-adapter-go-lib
+```
+
+## Usage
+
+### Event Types
+
+Use `MatrixAdapterEventType` enum for RabbitMQ topic routing:
+
+```typescript
+import { MatrixAdapterEventType } from '@alkem-io/matrix-adapter-go-lib';
+
+// Subscribe to commands
+consumer.subscribe(MatrixAdapterEventType.COMMUNICATION_ROOM_CREATE);
+consumer.subscribe(MatrixAdapterEventType.COMMUNICATION_SPACE_CREATE);
+
+// Listen for events
+consumer.subscribe(MatrixAdapterEventType.COMMUNICATION_MESSAGE_RECEIVED);
+```
+
+### Request/Response DTOs
+
+All command payloads and responses are fully typed:
+
+```typescript
+import {
+  CreateRoomRequest,
+  CreateRoomResponse,
+  RoomTypeCommunity,
+  JoinRuleInvite,
+  BaseResponse,
+  ErrCodeRoomNotFound,
+} from '@alkem-io/matrix-adapter-go-lib';
+
+// Build a request
+const request: CreateRoomRequest = {
+  alkemio_room_id: 'uuid-v4-or-v7',
+  type: RoomTypeCommunity,
+  name: 'My Room',
+  initial_members: ['actor-uuid-1', 'actor-uuid-2'],
+  join_rule: JoinRuleInvite,
+};
+
+// Handle response
+function handleResponse(response: CreateRoomResponse) {
+  if (response.BaseResponse.success) {
+    console.log('Room created');
+  } else {
+    const error = response.BaseResponse.error;
+    if (error?.code === ErrCodeRoomNotFound) {
+      console.error('Room not found:', error.message);
+    }
+  }
+}
+```
+
+### Space Operations (Protocol V3)
+
+```typescript
+import {
+  CreateSpaceRequest,
+  GetSpaceResponse,
+  SetParentRequest,
+  BatchAddSpaceMemberRequest,
+  JoinRuleRestricted,
+} from '@alkem-io/matrix-adapter-go-lib';
+
+// Create a space with hierarchy
+const spaceRequest: CreateSpaceRequest = {
+  alkemio_context_id: 'context-uuid',
+  name: 'My Space',
+  parent_context_id: 'parent-context-uuid',
+  join_rule: JoinRuleRestricted,
+  initial_members: ['actor-uuid'],
+};
+
+// Set parent-child relationship
+const hierarchyRequest: SetParentRequest = {
+  child_id: 'room-or-space-uuid',
+  is_space: false, // true for subspaces, false for rooms
+  parent_context_id: 'parent-space-uuid',
+};
+
+// Batch membership operations
+const batchRequest: BatchAddSpaceMemberRequest = {
+  actor_id: 'actor-uuid',
+  alkemio_context_ids: ['space-1', 'space-2', 'space-3'],
+};
+```
+
+## API Reference
+
+### Event Types
+
+| Event | Topic | Description |
+|-------|-------|-------------|
+| `COMMUNICATION_ROOM_CREATE` | `communication.room.create` | Create a room |
+| `COMMUNICATION_ROOM_GET` | `communication.room.get` | Get room details |
+| `COMMUNICATION_ROOM_UPDATE` | `communication.room.update` | Update room metadata |
+| `COMMUNICATION_ROOM_DELETE` | `communication.room.delete` | Delete a room |
+| `COMMUNICATION_ROOM_LIST` | `communication.room.list` | List all rooms |
+| `COMMUNICATION_ROOM_MEMBER_BATCH_ADD` | `communication.room.member.batch.add` | Add actor to rooms |
+| `COMMUNICATION_ROOM_MEMBER_BATCH_REMOVE` | `communication.room.member.batch.remove` | Remove actor from rooms |
+| `COMMUNICATION_SPACE_CREATE` | `communication.space.create` | Create a space |
+| `COMMUNICATION_SPACE_GET` | `communication.space.get` | Get space details |
+| `COMMUNICATION_SPACE_UPDATE` | `communication.space.update` | Update space metadata |
+| `COMMUNICATION_SPACE_DELETE` | `communication.space.delete` | Delete a space |
+| `COMMUNICATION_SPACE_LIST` | `communication.space.list` | List all spaces |
+| `COMMUNICATION_SPACE_MEMBER_BATCH_ADD` | `communication.space.member.batch.add` | Add actor to spaces |
+| `COMMUNICATION_SPACE_MEMBER_BATCH_REMOVE` | `communication.space.member.batch.remove` | Remove actor from spaces |
+| `COMMUNICATION_HIERARCHY_SET_PARENT` | `communication.hierarchy.set_parent` | Set parent-child relationship |
+| `COMMUNICATION_MESSAGE_SEND` | `communication.message.send` | Send a message |
+| `COMMUNICATION_MESSAGE_GET` | `communication.message.get` | Get message details |
+| `COMMUNICATION_MESSAGE_DELETE` | `communication.message.delete` | Delete a message |
+| `COMMUNICATION_REACTION_ADD` | `communication.reaction.add` | Add reaction |
+| `COMMUNICATION_REACTION_REMOVE` | `communication.reaction.remove` | Remove reaction |
+| `COMMUNICATION_REACTION_GET` | `communication.reaction.get` | Get reaction details |
+| `COMMUNICATION_ACTOR_SYNC` | `communication.actor.sync` | Sync actor profile |
+| `COMMUNICATION_MESSAGE_RECEIVED` | `communication.message.received` | Message received event |
+
+### Type Aliases
+
+| Type | Description |
+|------|-------------|
+| `AlkemioRoomID` | UUID identifying a room in Alkemio |
+| `AlkemioActorID` | UUID identifying an actor (user/bot) |
+| `AlkemioContextID` | UUID identifying a context (Space) |
+| `MessageID` | Opaque message identifier |
+| `ReactionID` | Opaque reaction identifier |
+
+### Constants
+
+#### Room Types
+- `RoomTypeCommunity` - General community room
+- `RoomTypeDirect` - Direct message room (exactly 2 actors)
+
+#### Join Rules
+- `JoinRulePublic` - Anyone can join
+- `JoinRuleInvite` - Requires invitation
+- `JoinRuleRestricted` - Members of parent space can join (MSC3083)
+
+#### Error Codes
+- `ErrCodeInvalidParam` - Request validation failed
+- `ErrCodeRoomNotFound` - Room does not exist
+- `ErrCodeSpaceNotFound` - Space does not exist
+- `ErrCodeActorNotFound` - Actor does not exist
+- `ErrCodeMatrixError` - Matrix SDK/homeserver error
+- `ErrCodeInternalError` - Unexpected system error
+- `ErrCodeNotAllowed` - Operation not permitted
+
+## Response Handling
+
+All responses extend `BaseResponse`:
+
+```typescript
+interface BaseResponse {
+  success: boolean;
+  error?: ErrorResponse;
+}
+
+interface ErrorResponse {
+  code: ErrorCode;
+  message: string;
+  details?: string;
+}
+```
+
+Batch operations return per-item results using `BaseResponse`:
+
+```typescript
+interface BatchAddMemberResponse {
+  success: boolean;
+  error?: ErrorResponse;
+  results?: { [roomId: string]: BaseResponse };
+}
+```
+
+## Generation
+
+This library is **auto-generated** from Go source code in `pkg/dto/`. Do not edit `src/dto/generated.ts` directly.
+
+To regenerate after Go DTO changes:
+
+```bash
+# From repository root
+make generate
+```
+
+## License
+
+EUPL-1.2

package/dist/commands.d.ts

@@ -0,0 +1,101 @@
+import type { AddReactionRequest, AddReactionResponse, BaseResponse, BatchAddMemberRequest, BatchAddMemberResponse, BatchAddSpaceMemberRequest, BatchAddSpaceMemberResponse, BatchRemoveMemberRequest, BatchRemoveMemberResponse, BatchRemoveSpaceMemberRequest, BatchRemoveSpaceMemberResponse, CreateRoomRequest, CreateSpaceRequest, DeleteMessageRequest, DeleteRoomRequest, DeleteSpaceRequest, GetMessageRequest, GetMessageResponse, GetReactionRequest, GetReactionResponse, GetRoomRequest, GetRoomResponse, GetSpaceRequest, GetSpaceResponse, ListRoomsRequest, ListRoomsResponse, ListSpacesRequest, ListSpacesResponse, MessageReceivedPayload, RemoveReactionRequest, SendMessageRequest, SendMessageResponse, SetParentRequest, SyncActorRequest, UpdateRoomRequest, UpdateSpaceRequest } from './dto';
+export declare const Commands: {
+    readonly 'communication.actor.sync': {
+        readonly request: SyncActorRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.hierarchy.set_parent': {
+        readonly request: SetParentRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.message.delete': {
+        readonly request: DeleteMessageRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.message.get': {
+        readonly request: GetMessageRequest;
+        readonly response: GetMessageResponse;
+    };
+    readonly 'communication.message.send': {
+        readonly request: SendMessageRequest;
+        readonly response: SendMessageResponse;
+    };
+    readonly 'communication.reaction.add': {
+        readonly request: AddReactionRequest;
+        readonly response: AddReactionResponse;
+    };
+    readonly 'communication.reaction.get': {
+        readonly request: GetReactionRequest;
+        readonly response: GetReactionResponse;
+    };
+    readonly 'communication.reaction.remove': {
+        readonly request: RemoveReactionRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.room.create': {
+        readonly request: CreateRoomRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.room.delete': {
+        readonly request: DeleteRoomRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.room.get': {
+        readonly request: GetRoomRequest;
+        readonly response: GetRoomResponse;
+    };
+    readonly 'communication.room.list': {
+        readonly request: ListRoomsRequest;
+        readonly response: ListRoomsResponse;
+    };
+    readonly 'communication.room.member.batch.add': {
+        readonly request: BatchAddMemberRequest;
+        readonly response: BatchAddMemberResponse;
+    };
+    readonly 'communication.room.member.batch.remove': {
+        readonly request: BatchRemoveMemberRequest;
+        readonly response: BatchRemoveMemberResponse;
+    };
+    readonly 'communication.room.update': {
+        readonly request: UpdateRoomRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.space.create': {
+        readonly request: CreateSpaceRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.space.delete': {
+        readonly request: DeleteSpaceRequest;
+        readonly response: BaseResponse;
+    };
+    readonly 'communication.space.get': {
+        readonly request: GetSpaceRequest;
+        readonly response: GetSpaceResponse;
+    };
+    readonly 'communication.space.list': {
+        readonly request: ListSpacesRequest;
+        readonly response: ListSpacesResponse;
+    };
+    readonly 'communication.space.member.batch.add': {
+        readonly request: BatchAddSpaceMemberRequest;
+        readonly response: BatchAddSpaceMemberResponse;
+    };
+    readonly 'communication.space.member.batch.remove': {
+        readonly request: BatchRemoveSpaceMemberRequest;
+        readonly response: BatchRemoveSpaceMemberResponse;
+    };
+    readonly 'communication.space.update': {
+        readonly request: UpdateSpaceRequest;
+        readonly response: BaseResponse;
+    };
+};
+export declare const OutgoingEvents: {
+    readonly 'communication.message.received': {
+        readonly payload: MessageReceivedPayload;
+    };
+};
+export type CommandTopic = keyof typeof Commands;
+export type RequestFor<T extends CommandTopic> = (typeof Commands)[T]['request'];
+export type ResponseFor<T extends CommandTopic> = (typeof Commands)[T]['response'];
+export type OutgoingEventTopic = keyof typeof OutgoingEvents;
+export type PayloadFor<T extends OutgoingEventTopic> = (typeof OutgoingEvents)[T]['payload'];

package/dist/commands.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutgoingEvents = exports.Commands = void 0;
+exports.Commands = {
+    'communication.actor.sync': {
+        request: {},
+        response: {},
+    },
+    'communication.hierarchy.set_parent': {
+        request: {},
+        response: {},
+    },
+    'communication.message.delete': {
+        request: {},
+        response: {},
+    },
+    'communication.message.get': {
+        request: {},
+        response: {},
+    },
+    'communication.message.send': {
+        request: {},
+        response: {},
+    },
+    'communication.reaction.add': {
+        request: {},
+        response: {},
+    },
+    'communication.reaction.get': {
+        request: {},
+        response: {},
+    },
+    'communication.reaction.remove': {
+        request: {},
+        response: {},
+    },
+    'communication.room.create': {
+        request: {},
+        response: {},
+    },
+    'communication.room.delete': {
+        request: {},
+        response: {},
+    },
+    'communication.room.get': {
+        request: {},
+        response: {},
+    },
+    'communication.room.list': {
+        request: {},
+        response: {},
+    },
+    'communication.room.member.batch.add': {
+        request: {},
+        response: {},
+    },
+    'communication.room.member.batch.remove': {
+        request: {},
+        response: {},
+    },
+    'communication.room.update': {
+        request: {},
+        response: {},
+    },
+    'communication.space.create': {
+        request: {},
+        response: {},
+    },
+    'communication.space.delete': {
+        request: {},
+        response: {},
+    },
+    'communication.space.get': {
+        request: {},
+        response: {},
+    },
+    'communication.space.list': {
+        request: {},
+        response: {},
+    },
+    'communication.space.member.batch.add': {
+        request: {},
+        response: {},
+    },
+    'communication.space.member.batch.remove': {
+        request: {},
+        response: {},
+    },
+    'communication.space.update': {
+        request: {},
+        response: {},
+    },
+};
+exports.OutgoingEvents = {
+    'communication.message.received': {
+        payload: {},
+    },
+};
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":";;;AA6Ca,QAAA,QAAQ,GAAG;IACtB,0BAA0B,EAAE;QAC1B,OAAO,EAAE,EAAsB;QAC/B,QAAQ,EAAE,EAAkB;KAC7B;IACD,oCAAoC,EAAE;QACpC,OAAO,EAAE,EAAsB;QAC/B,QAAQ,EAAE,EAAkB;KAC7B;IACD,8BAA8B,EAAE;QAC9B,OAAO,EAAE,EAA0B;QACnC,QAAQ,EAAE,EAAkB;KAC7B;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,EAAuB;QAChC,QAAQ,EAAE,EAAwB;KACnC;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAyB;KACpC;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAyB;KACpC;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAyB;KACpC;IACD,+BAA+B,EAAE;QAC/B,OAAO,EAAE,EAA2B;QACpC,QAAQ,EAAE,EAAkB;KAC7B;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,EAAuB;QAChC,QAAQ,EAAE,EAAkB;KAC7B;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,EAAuB;QAChC,QAAQ,EAAE,EAAkB;KAC7B;IACD,wBAAwB,EAAE;QACxB,OAAO,EAAE,EAAoB;QAC7B,QAAQ,EAAE,EAAqB;KAChC;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,EAAsB;QAC/B,QAAQ,EAAE,EAAuB;KAClC;IACD,qCAAqC,EAAE;QACrC,OAAO,EAAE,EAA2B;QACpC,QAAQ,EAAE,EAA4B;KACvC;IACD,wCAAwC,EAAE;QACxC,OAAO,EAAE,EAA8B;QACvC,QAAQ,EAAE,EAA+B;KAC1C;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,EAAuB;QAChC,QAAQ,EAAE,EAAkB;KAC7B;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAkB;KAC7B;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAkB;KAC7B;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,EAAqB;QAC9B,QAAQ,EAAE,EAAsB;KACjC;IACD,0BAA0B,EAAE;QAC1B,OAAO,EAAE,EAAuB;QAChC,QAAQ,EAAE,EAAwB;KACnC;IACD,sCAAsC,EAAE;QACtC,OAAO,EAAE,EAAgC;QACzC,QAAQ,EAAE,EAAiC;KAC5C;IACD,yCAAyC,EAAE;QACzC,OAAO,EAAE,EAAmC;QAC5C,QAAQ,EAAE,EAAoC;KAC/C;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,EAAwB;QACjC,QAAQ,EAAE,EAAkB;KAC7B;CACO,CAAC;AAKE,QAAA,cAAc,GAAG;IAC5B,gCAAgC,EAAE;QAChC,OAAO,EAAE,EAA4B;KACtC;CACO,CAAC"}

package/dist/dto/generated.d.ts

@@ -0,0 +1,273 @@
+export interface SyncActorRequest {
+    actor_id: AlkemioActorID;
+    display_name: string;
+    avatar_url?: string;
+}
+export interface BatchAddMemberRequest {
+    actor_id: AlkemioActorID;
+    alkemio_room_ids: AlkemioRoomID[];
+}
+export interface BatchAddMemberResponse extends BaseResponse {
+    results?: {
+        [key: string]: BaseResponse;
+    };
+}
+export interface BatchRemoveMemberRequest {
+    actor_id: AlkemioActorID;
+    alkemio_room_ids: AlkemioRoomID[];
+    reason?: string;
+}
+export interface BatchRemoveMemberResponse extends BaseResponse {
+    results?: {
+        [key: string]: BaseResponse;
+    };
+}
+export declare const TopicRoomCreate = "communication.room.create";
+export declare const TopicRoomGet = "communication.room.get";
+export declare const TopicRoomUpdate = "communication.room.update";
+export declare const TopicRoomDelete = "communication.room.delete";
+export declare const TopicRoomList = "communication.room.list";
+export declare const TopicMessageSend = "communication.message.send";
+export declare const TopicMessageGet = "communication.message.get";
+export declare const TopicMessageDelete = "communication.message.delete";
+export declare const TopicMessageReceived = "communication.message.received";
+export declare const TopicReactionAdd = "communication.reaction.add";
+export declare const TopicReactionRemove = "communication.reaction.remove";
+export declare const TopicReactionGet = "communication.reaction.get";
+export declare const TopicRoomMemberBatchAdd = "communication.room.member.batch.add";
+export declare const TopicRoomMemberBatchRemove = "communication.room.member.batch.remove";
+export declare const TopicActorSync = "communication.actor.sync";
+export declare const TopicSpaceCreate = "communication.space.create";
+export declare const TopicSpaceGet = "communication.space.get";
+export declare const TopicSpaceUpdate = "communication.space.update";
+export declare const TopicSpaceDelete = "communication.space.delete";
+export declare const TopicSpaceList = "communication.space.list";
+export declare const TopicHierarchySetParent = "communication.hierarchy.set_parent";
+export declare const TopicSpaceMemberBatchAdd = "communication.space.member.batch.add";
+export declare const TopicSpaceMemberBatchRemove = "communication.space.member.batch.remove";
+export interface CommandDef {
+    Topic: string;
+    RequestType: string;
+    ResponseType: string;
+}
+export type ErrorCode = string;
+export declare const ErrCodeInvalidParam: ErrorCode;
+export declare const ErrCodeRoomNotFound: ErrorCode;
+export declare const ErrCodeSpaceNotFound: ErrorCode;
+export declare const ErrCodeActorNotFound: ErrorCode;
+export declare const ErrCodeMessageNotFound: ErrorCode;
+export declare const ErrCodeReactionNotFound: ErrorCode;
+export declare const ErrCodeMatrixError: ErrorCode;
+export declare const ErrCodeInternalError: ErrorCode;
+export declare const ErrCodeNotAllowed: ErrorCode;
+export interface ErrorResponse {
+    code: ErrorCode;
+    message: string;
+    details?: string;
+}
+export interface BaseResponse {
+    success: boolean;
+    error?: ErrorResponse;
+}
+export interface MessageReceivedPayload {
+    roomId: string;
+    roomName: string;
+    message: Message;
+    actorID: string;
+    communityId?: string;
+}
+export interface Message {
+    id: string;
+    message: string;
+    threadID?: string;
+    sender: string;
+    timestamp: number;
+    reactions: Reaction[];
+}
+export interface Reaction {
+    id: string;
+    emoji: string;
+    sender: string;
+    timestamp: number;
+    messageId: string;
+}
+export interface SetParentRequest {
+    child_id: string;
+    is_space: boolean;
+    parent_context_id: AlkemioContextID;
+    order?: string;
+    suggested?: boolean;
+}
+export interface MessageDto {
+    id: MessageID;
+    content: string;
+    sender_actor_id: AlkemioActorID;
+    timestamp: string;
+    reactions: ReactionDto[];
+    thread_id?: MessageID;
+}
+export interface SendMessageRequest {
+    alkemio_room_id: AlkemioRoomID;
+    sender_actor_id: AlkemioActorID;
+    content: string;
+    parent_message_id?: MessageID;
+}
+export interface SendMessageResponse extends BaseResponse {
+    message_id: MessageID;
+    timestamp: string;
+}
+export interface GetMessageRequest {
+    alkemio_room_id: AlkemioRoomID;
+    message_id: MessageID;
+}
+export interface GetMessageResponse extends BaseResponse {
+    message: MessageDto;
+}
+export interface DeleteMessageRequest {
+    alkemio_room_id: AlkemioRoomID;
+    message_id: MessageID;
+    sender_actor_id: AlkemioActorID;
+    reason?: string;
+}
+export interface ReactionDto {
+    id: ReactionID;
+    emoji: string;
+    sender_actor_id: AlkemioActorID;
+    timestamp: string;
+}
+export interface AddReactionRequest {
+    alkemio_room_id: AlkemioRoomID;
+    message_id: MessageID;
+    sender_actor_id: AlkemioActorID;
+    emoji: string;
+}
+export interface AddReactionResponse extends BaseResponse {
+    reaction_id: ReactionID;
+}
+export interface RemoveReactionRequest {
+    alkemio_room_id: AlkemioRoomID;
+    reaction_id: ReactionID;
+    sender_actor_id: AlkemioActorID;
+}
+export interface GetReactionRequest {
+    alkemio_room_id: AlkemioRoomID;
+    reaction_id: ReactionID;
+}
+export interface GetReactionResponse extends BaseResponse {
+    reaction: ReactionDto;
+}
+export interface CreateRoomRequest {
+    alkemio_room_id: AlkemioRoomID;
+    type: RoomType;
+    name?: string;
+    initial_members?: AlkemioActorID[];
+    topic?: string;
+    avatar_url?: string;
+    parent_context_id?: AlkemioContextID;
+    join_rule?: JoinRule;
+}
+export interface GetRoomRequest {
+    alkemio_room_id: AlkemioRoomID;
+}
+export interface GetRoomResponse extends BaseResponse {
+    alkemio_room_id: AlkemioRoomID;
+    display_name: string;
+    member_actor_ids: AlkemioActorID[];
+    messages: MessageDto[];
+}
+export interface UpdateRoomRequest {
+    alkemio_room_id: AlkemioRoomID;
+    name?: string;
+    topic?: string;
+    is_public?: boolean;
+    avatar_url?: string;
+    join_rule?: JoinRule;
+}
+export interface DeleteRoomRequest {
+    alkemio_room_id: AlkemioRoomID;
+    reason?: string;
+}
+export interface ListRoomsRequest {
+    cursor?: string;
+}
+export interface ListRoomsResponse extends BaseResponse {
+    alkemio_room_ids: AlkemioRoomID[];
+    next_cursor?: string;
+}
+export interface SpaceChildDto {
+    child_id: string;
+    is_space: boolean;
+    order?: string;
+    suggested?: boolean;
+}
+export interface CreateSpaceRequest {
+    alkemio_context_id: AlkemioContextID;
+    name: string;
+    topic?: string;
+    avatar_url?: string;
+    parent_context_id?: AlkemioContextID;
+    join_rule?: JoinRule;
+    initial_members?: AlkemioActorID[];
+}
+export interface GetSpaceRequest {
+    alkemio_context_id: AlkemioContextID;
+}
+export interface GetSpaceResponse extends BaseResponse {
+    alkemio_context_id: AlkemioContextID;
+    display_name: string;
+    topic?: string;
+    avatar_url?: string;
+    join_rule: JoinRule;
+    member_actor_ids: AlkemioActorID[];
+    children: SpaceChildDto[];
+    parent_context_id?: AlkemioContextID;
+}
+export interface UpdateSpaceRequest {
+    alkemio_context_id: AlkemioContextID;
+    name?: string;
+    topic?: string;
+    avatar_url?: string;
+    join_rule?: JoinRule;
+}
+export interface DeleteSpaceRequest {
+    alkemio_context_id: AlkemioContextID;
+    reason?: string;
+}
+export interface ListSpacesRequest {
+    cursor?: string;
+}
+export interface ListSpacesResponse extends BaseResponse {
+    alkemio_context_ids: AlkemioContextID[];
+    next_cursor?: string;
+}
+export interface BatchAddSpaceMemberRequest {
+    actor_id: AlkemioActorID;
+    alkemio_context_ids: AlkemioContextID[];
+}
+export interface BatchAddSpaceMemberResponse extends BaseResponse {
+    results?: {
+        [key: string]: BaseResponse;
+    };
+}
+export interface BatchRemoveSpaceMemberRequest {
+    actor_id: AlkemioActorID;
+    alkemio_context_ids: AlkemioContextID[];
+    reason?: string;
+}
+export interface BatchRemoveSpaceMemberResponse extends BaseResponse {
+    results?: {
+        [key: string]: BaseResponse;
+    };
+}
+export type AlkemioRoomID = string;
+export type AlkemioActorID = string;
+export type MessageID = string;
+export type ReactionID = string;
+export type AlkemioContextID = string;
+export type RoomType = string;
+export declare const RoomTypeCommunity: RoomType;
+export declare const RoomTypeDirect: RoomType;
+export type JoinRule = string;
+export declare const JoinRulePublic: JoinRule;
+export declare const JoinRuleInvite: JoinRule;
+export declare const JoinRuleRestricted: JoinRule;