@nekutima/biome-sdk 0.1.31 → 0.1.33

package/README.md

@@ -11,6 +11,7 @@ The Biome SDK is the **official contract** between frontend and backend teams, p
 - 🔄 **Authentication** - Login, logout, session management
 - 📋 **Task Management** - CRUD operations, state transitions, search
 - 👤 **Profile Management** - User profiles, updates, validation
+- 💬 **Chat System** - Real-time messaging, typing indicators, read receipts
 - 📁 **File Upload** - Image validation, upload, management
 - 🛡️ **CSRF Protection** - Auto-injection, token management
 - 🔧 **Utilities** - Sorting, validation, date manipulation
@@ -176,6 +177,9 @@ const biomeNoCsrf = BiomeSDK.initialize({
 - [CONTRACT.md](./CONTRACT.md) - SDK contract and scope
 - [FRONTEND_INTEGRATION.md](./FRONTEND_INTEGRATION.md) - Frontend integration guide
 - [BACKEND_INTEGRATION.md](./BACKEND_INTEGRATION.md) - Backend integration guide
+- [docs/INDEX.md](./docs/INDEX.md) - Complete documentation index
+- [docs/chat-sdk.md](./docs/chat-sdk.md) - Comprehensive chat SDK documentation
+- [CHANGELOG.md](./CHANGELOG.md) - Version history and changes
 
 ## Version
 

package/dist/chat/chat.service.d.ts

@@ -1,48 +1,64 @@
 import { BiomeHttpClient } from "../core/http-client";
-export interface ChatMessageWithSender {
-    id: number;
-    chatId: number;
-    senderId: number;
-    senderUsername: string;
-    senderAvatarUrl?: string;
-    content: string;
-    createdAt: Date;
-    updatedAt?: Date;
-}
-export interface ChatWithParticipants {
-    id: number;
-    taskId: number;
-    participantIds: number[];
-    participantUsernames: string[];
-    createdAt: Date;
-    updatedAt?: Date;
-}
-export interface TaskChatMessagesResponse {
-    chat: ChatWithParticipants;
-    messages: ChatMessageWithSender[];
-    pagination: {
-        hasMore: boolean;
-        nextCursor?: string;
-    };
-}
-export interface SendChatMessageResponse {
-    message: ChatMessageWithSender;
-}
+import { ChatMessageWithSender, TaskChatMessagesResponse, ChatEvent } from "../models/chat.model";
 export declare class BiomeChat {
     private readonly http;
+    private eventSources;
+    private eventListeners;
     constructor(http: BiomeHttpClient);
     /**
      * Get chat messages for a task
+     * @param taskId - The task ID
+     * @param cursor - Pagination cursor for loading more messages
+     * @param limit - Number of messages to fetch (default: 50)
      */
-    getMessages(taskId: number, cursor?: string): Promise<TaskChatMessagesResponse>;
+    getMessages(taskId: number, cursor?: string, limit?: number): Promise<TaskChatMessagesResponse>;
     /**
      * Send a chat message for a task
+     * @param taskId - The task ID
+     * @param content - The message content
      */
     sendMessage(taskId: number, content: string): Promise<ChatMessageWithSender>;
+    /**
+     * Mark a message as read
+     * @param messageId - The message ID to mark as read
+     */
+    markMessageAsRead(messageId: number): Promise<void>;
+    /**
+     * Send typing indicator
+     * @param taskId - The task ID
+     * @param isTyping - Whether user is typing
+     */
+    sendTypingIndicator(taskId: number, isTyping: boolean): Promise<void>;
     /**
      * Connect to chat events via SSE
-     * Returns raw EventSource for frontend to handle
+     * @param chatId - The chat ID
+     * @returns EventSource connection
      */
     connect(chatId: number): EventSource;
+    /**
+     * Disconnect from chat events
+     * @param chatId - The chat ID
+     */
+    disconnect(chatId: number): void;
+    /**
+     * Subscribe to chat events
+     * @param chatId - The chat ID
+     * @param listener - Event listener callback
+     */
+    subscribeToEvents(chatId: number, listener: (event: ChatEvent) => void): void;
+    /**
+     * Unsubscribe from chat events
+     * @param chatId - The chat ID
+     * @param listener - Event listener callback to remove
+     */
+    unsubscribeFromEvents(chatId: number, listener: (event: ChatEvent) => void): void;
+    /**
+     * Get all active chat connections
+     */
+    getActiveConnections(): number[];
+    /**
+     * Disconnect all chat connections
+     */
+    disconnectAll(): void;
 }
 //# sourceMappingURL=chat.service.d.ts.map

package/dist/chat/chat.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.service.d.ts","sourceRoot":"","sources":["../../src/chat/chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;gBAE3B,IAAI,EAAE,eAAe;IAIjC;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,CAAC;IAYpC;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;CAMrC"}
+{"version":3,"file":"chat.service.d.ts","sourceRoot":"","sources":["../../src/chat/chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EAIxB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,cAAc,CAA6D;gBAEvE,IAAI,EAAE,eAAe;IAIjC;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,wBAAwB,CAAC;IAiBpC;;;;OAIG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAqBjC;;;OAGG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD;;;;OAIG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAUpC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAsD7E;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAUjF;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;CAOtB"}

package/dist/chat/chat.service.js

@@ -4,42 +4,192 @@ exports.BiomeChat = void 0;
 const error_handler_1 = require("../core/error-handler");
 class BiomeChat {
     constructor(http) {
+        this.eventSources = new Map();
+        this.eventListeners = new Map();
         this.http = http;
     }
     /**
      * Get chat messages for a task
+     * @param taskId - The task ID
+     * @param cursor - Pagination cursor for loading more messages
+     * @param limit - Number of messages to fetch (default: 50)
      */
-    async getMessages(taskId, cursor) {
+    async getMessages(taskId, cursor, limit = 50) {
         try {
-            const params = cursor ? `?cursor=${encodeURIComponent(cursor)}` : "";
-            const response = await this.http.get(`/tasks/task/${taskId}/chat/messages${params}`);
+            const params = new URLSearchParams();
+            if (cursor)
+                params.append('cursor', cursor);
+            if (limit)
+                params.append('limit', limit.toString());
+            const queryString = params.toString() ? `?${params.toString()}` : "";
+            const response = await this.http.get(`/tasks/task/${taskId}/chat/messages${queryString}`);
             return response.payload;
         }
         catch (error) {
-            throw (0, error_handler_1.createSdkError)(error, "Failed to get chat messages");
+            const sdkError = (0, error_handler_1.createSdkError)(error, "Failed to get chat messages");
+            throw new Error(sdkError.userMessage || sdkError.message);
         }
     }
     /**
      * Send a chat message for a task
+     * @param taskId - The task ID
+     * @param content - The message content
      */
     async sendMessage(taskId, content) {
         try {
+            // Validate message content
+            if (!content || content.trim().length === 0) {
+                const error = (0, error_handler_1.createSdkError)(new Error("Message content cannot be empty"), "Invalid message");
+                throw new Error(error.userMessage || error.message);
+            }
             const response = await this.http.post(`/tasks/task/${taskId}/chat/messages`, { content });
             return response.payload.message;
         }
         catch (error) {
-            throw (0, error_handler_1.createSdkError)(error, "Failed to send chat message");
+            if (error instanceof Error && error.message.includes("Message content cannot be empty")) {
+                throw error;
+            }
+            const sdkError = (0, error_handler_1.createSdkError)(error, "Failed to send chat message");
+            throw new Error(sdkError.userMessage || sdkError.message);
+        }
+    }
+    /**
+     * Mark a message as read
+     * @param messageId - The message ID to mark as read
+     */
+    async markMessageAsRead(messageId) {
+        try {
+            await this.http.post(`/chats/messages/${messageId}/read`, {});
+        }
+        catch (error) {
+            const sdkError = (0, error_handler_1.createSdkError)(error, "Failed to mark message as read");
+            throw new Error(sdkError.userMessage || sdkError.message);
+        }
+    }
+    /**
+     * Send typing indicator
+     * @param taskId - The task ID
+     * @param isTyping - Whether user is typing
+     */
+    async sendTypingIndicator(taskId, isTyping) {
+        try {
+            await this.http.post(`/tasks/task/${taskId}/chat/typing`, { isTyping });
+        }
+        catch (error) {
+            // Silently fail typing indicators to avoid disrupting user experience
+            console.debug("Failed to send typing indicator:", error);
         }
     }
     /**
      * Connect to chat events via SSE
-     * Returns raw EventSource for frontend to handle
+     * @param chatId - The chat ID
+     * @returns EventSource connection
      */
     connect(chatId) {
-        const baseUrl = this.http.baseURL;
-        return new EventSource(`${baseUrl}/chats/${chatId}/events`, {
+        const baseUrl = this.http.baseURL.replace(/\/$/, ''); // Remove trailing slash
+        const eventSource = new EventSource(`${baseUrl}/chats/${chatId}/events`, {
             withCredentials: true,
         });
+        this.eventSources.set(chatId, eventSource);
+        return eventSource;
+    }
+    /**
+     * Disconnect from chat events
+     * @param chatId - The chat ID
+     */
+    disconnect(chatId) {
+        const eventSource = this.eventSources.get(chatId);
+        if (eventSource) {
+            eventSource.close();
+            this.eventSources.delete(chatId);
+            this.eventListeners.delete(chatId);
+        }
+    }
+    /**
+     * Subscribe to chat events
+     * @param chatId - The chat ID
+     * @param listener - Event listener callback
+     */
+    subscribeToEvents(chatId, listener) {
+        if (!this.eventListeners.has(chatId)) {
+            this.eventListeners.set(chatId, []);
+            // Set up the EventSource connection if not already connected
+            let eventSource = this.eventSources.get(chatId);
+            if (!eventSource) {
+                eventSource = this.connect(chatId);
+            }
+            // Handle different event types
+            eventSource.addEventListener('chat.message.created', (e) => {
+                try {
+                    const payload = JSON.parse(e.data);
+                    const event = {
+                        type: 'message.created',
+                        payload: payload
+                    };
+                    this.eventListeners.get(chatId)?.forEach(cb => cb(event));
+                }
+                catch (error) {
+                    console.error('Failed to parse message.created event:', error);
+                }
+            });
+            eventSource.addEventListener('chat.message.read', (e) => {
+                try {
+                    const payload = JSON.parse(e.data);
+                    const event = {
+                        type: 'message.read',
+                        payload: payload
+                    };
+                    this.eventListeners.get(chatId)?.forEach(cb => cb(event));
+                }
+                catch (error) {
+                    console.error('Failed to parse message.read event:', error);
+                }
+            });
+            eventSource.addEventListener('user.typing', (e) => {
+                try {
+                    const payload = JSON.parse(e.data);
+                    const event = {
+                        type: 'user.typing',
+                        payload: payload
+                    };
+                    this.eventListeners.get(chatId)?.forEach(cb => cb(event));
+                }
+                catch (error) {
+                    console.error('Failed to parse user.typing event:', error);
+                }
+            });
+        }
+        this.eventListeners.get(chatId)?.push(listener);
+    }
+    /**
+     * Unsubscribe from chat events
+     * @param chatId - The chat ID
+     * @param listener - Event listener callback to remove
+     */
+    unsubscribeFromEvents(chatId, listener) {
+        const listeners = this.eventListeners.get(chatId);
+        if (listeners) {
+            const index = listeners.indexOf(listener);
+            if (index > -1) {
+                listeners.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Get all active chat connections
+     */
+    getActiveConnections() {
+        return Array.from(this.eventSources.keys());
+    }
+    /**
+     * Disconnect all chat connections
+     */
+    disconnectAll() {
+        this.eventSources.forEach((es, chatId) => {
+            es.close();
+        });
+        this.eventSources.clear();
+        this.eventListeners.clear();
     }
 }
 exports.BiomeChat = BiomeChat;

package/dist/chat/chat.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.service.js","sourceRoot":"","sources":["../../src/chat/chat.service.ts"],"names":[],"mappings":";;;AACA,yDAAuD;AAoCvD,MAAa,SAAS;IAGpB,YAAY,IAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,MAAe;QAEf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAElC,eAAe,MAAM,iBAAiB,MAAM,EAAE,CAAC,CAAC;YAClD,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,8BAAc,EAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAEnC,eAAe,MAAM,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,8BAAc,EAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAc;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,OAAO,IAAI,WAAW,CAAC,GAAG,OAAO,UAAU,MAAM,SAAS,EAAE;YAC1D,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AApDD,8BAoDC"}
+{"version":3,"file":"chat.service.js","sourceRoot":"","sources":["../../src/chat/chat.service.ts"],"names":[],"mappings":"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"}

package/dist/ecosystem/ecosystem.model.d.ts

@@ -1,16 +1,59 @@
 /**
- * Unified Ecosystem model for Biome platform
- * This model is shared between frontend and backend
+ * Ecosystem model for Biome platform
+ * Ecosystems are containers that can be nested and have participants
  */
+import { OrganizationMinimal } from './organization.model';
+import { PersonMinimal } from './person.model';
+export type EcosystemType = 'business' | 'personal' | 'community' | 'government' | 'nonprofit' | 'other';
+export type EcosystemStatus = 'active' | 'inactive' | 'archived';
+export { OrganizationMinimal };
+export { PersonMinimal };
 export interface Ecosystem {
     id?: number;
     name: string;
     description?: string;
-    deleted: boolean;
+    type?: EcosystemType;
+    status?: EcosystemStatus;
+    ownerId: number;
+    parentEcosystemId?: number;
+    deletedAt?: Date;
+    deletedBy?: number;
     createdAt: Date;
     createdBy: number;
     updatedAt: Date;
     updatedBy: number;
 }
 export type EcosystemMinimal = Pick<Ecosystem, 'id' | 'name' | 'description'>;
+export interface CreateEcosystemRequest {
+    name: string;
+    description?: string;
+    type?: EcosystemType;
+    parentEcosystemId?: number;
+}
+export interface UpdateEcosystemRequest {
+    name?: string;
+    description?: string;
+    type?: EcosystemType;
+    status?: EcosystemStatus;
+    parentEcosystemId?: number;
+}
+export interface EcosystemListParams {
+    page?: number;
+    limit?: number;
+    status?: EcosystemStatus;
+    parentEcosystemId?: number;
+}
+export interface EcosystemListResponse {
+    ecosystems: Ecosystem[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface EcosystemWithParticipants extends Ecosystem {
+    organizations: OrganizationMinimal[];
+    people: PersonMinimal[];
+}
 //# sourceMappingURL=ecosystem.model.d.ts.map

package/dist/ecosystem/ecosystem.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem.model.d.ts","sourceRoot":"","sources":["../../src/ecosystem/ecosystem.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC"}
+{"version":3,"file":"ecosystem.model.d.ts","sourceRoot":"","sources":["../../src/ecosystem/ecosystem.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAU,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AACzG,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,WAAW,SAAS;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED,MAAM,WAAW,yBAA0B,SAAQ,SAAS;IACxD,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,MAAM,EAAE,aAAa,EAAE,CAAC;CAC3B"}

package/dist/ecosystem/ecosystem.model.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
- * Unified Ecosystem model for Biome platform
- * This model is shared between frontend and backend
+ * Ecosystem model for Biome platform
+ * Ecosystems are containers that can be nested and have participants
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ecosystem.model.js.map

package/dist/ecosystem/ecosystem.service.d.ts

@@ -0,0 +1,76 @@
+import { BiomeHttpClient } from "../core/http-client";
+import { Ecosystem, CreateEcosystemRequest, UpdateEcosystemRequest, EcosystemListParams, EcosystemListResponse, OrganizationMinimal, PersonMinimal } from "./ecosystem.model";
+/**
+ * Ecosystem management service
+ */
+export declare class BiomeEcosystems {
+    private http;
+    constructor(http: BiomeHttpClient);
+    /**
+     * Get ecosystem by ID
+     */
+    getById(id: number): Promise<Ecosystem>;
+    /**
+     * Get organizations belonging to an ecosystem
+     */
+    getOrganizations(ecosystemId: number): Promise<OrganizationMinimal[]>;
+    /**
+     * Get people belonging to an ecosystem
+     */
+    getPeople(ecosystemId: number): Promise<PersonMinimal[]>;
+    /**
+     * List ecosystems with pagination and filters
+     */
+    list(params?: EcosystemListParams): Promise<EcosystemListResponse>;
+    /**
+     * Get child ecosystems (nested 1:n)
+     */
+    getChildren(parentId: number): Promise<Ecosystem[]>;
+    /**
+     * Create a new ecosystem
+     */
+    create(ecosystem: CreateEcosystemRequest): Promise<{
+        id: number;
+    }>;
+    /**
+     * Update an existing ecosystem
+     */
+    update(id: number, updates: UpdateEcosystemRequest): Promise<Ecosystem>;
+    /**
+     * Delete an ecosystem (soft delete)
+     */
+    delete(id: number): Promise<void>;
+    /**
+     * Add organization to ecosystem
+     */
+    addOrganization(ecosystemId: number, organizationId: number): Promise<void>;
+    /**
+     * Remove organization from ecosystem
+     */
+    removeOrganization(ecosystemId: number, organizationId: number): Promise<void>;
+    /**
+     * Add person to ecosystem
+     */
+    addPerson(ecosystemId: number, personId: number): Promise<void>;
+    /**
+     * Remove person from ecosystem
+     */
+    removePerson(ecosystemId: number, personId: number): Promise<void>;
+    /**
+     * Set parent ecosystem (for nesting)
+     */
+    setParent(ecosystemId: number, parentEcosystemId: number): Promise<Ecosystem>;
+    /**
+     * Remove parent ecosystem
+     */
+    removeParent(ecosystemId: number): Promise<Ecosystem>;
+    /**
+     * Transfer ownership to another user
+     */
+    transferOwnership(ecosystemId: number, newOwnerId: number): Promise<Ecosystem>;
+    /**
+     * Build query parameters from filters
+     */
+    private buildQueryParams;
+}
+//# sourceMappingURL=ecosystem.service.d.ts.map

package/dist/ecosystem/ecosystem.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem.service.d.ts","sourceRoot":"","sources":["../../src/ecosystem/ecosystem.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EACH,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EAErB,mBAAmB,EACnB,aAAa,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,eAAe;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,eAAe;IAEzC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAW7C;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAW3E;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAW9D;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAYxE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAWzD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAYxE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAY7E;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjF;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpF;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrE;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAYnF;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAW3D;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAYpF;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoB3B"}