@principal-ai/control-tower-core 0.4.0 → 0.4.1

package/dist/abstractions/DefaultPresenceManager.d.ts

@@ -8,6 +8,7 @@
  * backed by Redis or another shared data store.
  */
 import type { BaseServer } from "../server/BaseServer.js";
+import type { Message } from "../types/index.js";
 import type { ActivityUpdate, DeviceInfo, PresenceChangeEvent, PresenceConfig, PresenceStatus, UserPresence } from "../types/presence.js";
 import type { ExtendedUserPresence, PresenceExtension } from "./PresenceExtension.js";
 import { PresenceManager } from "./PresenceManager.js";
@@ -59,5 +60,44 @@ export declare class DefaultPresenceManager<TExtendedData = Record<string, unkno
      * Get total unique user count
      */
     getUniqueUserCount(): number;
+    /**
+     * Convert UserPresence to SerializableUserPresence
+     * Converts the devices Map to a plain object for JSON serialization
+     */
+    private serializePresence;
+    /**
+     * Handle presence WebSocket messages
+     *
+     * This method handles core presence messages and delegates to extensions
+     * for extension-specific messages. Use this with CustomMessageHandler.
+     *
+     * @param userId - Authenticated user ID
+     * @param deviceId - Device/client ID
+     * @param message - The WebSocket message
+     * @param sendResponse - Callback to send response
+     * @returns true if the message was handled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const server = new ServerBuilder()
+     *   .withPresenceManager(presenceManager)
+     *   .withCustomMessageHandler(async (clientId, message, sendResponse) => {
+     *     const client = server.getClient(clientId);
+     *     if (!client?.authenticated || !client.userId) return false;
+     *     const deviceId = getDeviceIdForClient(clientId);
+     *     return presenceManager.handlePresenceMessage(
+     *       client.userId,
+     *       deviceId,
+     *       message,
+     *       sendResponse
+     *     );
+     *   })
+     *   .build();
+     * ```
+     */
+    handlePresenceMessage(userId: string, deviceId: string, message: Message, sendResponse: (response: {
+        type: string;
+        payload: unknown;
+    }) => Promise<void>): Promise<boolean>;
 }
 //# sourceMappingURL=DefaultPresenceManager.d.ts.map

package/dist/abstractions/DefaultPresenceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultPresenceManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/DefaultPresenceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EACX,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACX,oBAAoB,EACpB,iBAAiB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAWvD,qBAAa,sBAAsB,CAClC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACtC,SAAQ,eAAe;IACxB,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,MAAM,CAAC,CAAa;gBAG3B,MAAM,CAAC,EAAE,cAAc,GAAG;QACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;KAChD;IAMF;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAgIlB,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAuEzB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAiC7D,eAAe,CACpB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAyBhD,gBAAgB,CACrB,OAAO,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAa/B,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;IA4BhE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IASrD,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,CAAC;IAUlB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4EnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG5B"}
+{"version":3,"file":"DefaultPresenceManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/DefaultPresenceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACX,cAAc,EACd,UAAU,EAEV,mBAAmB,EACnB,cAAc,EAKd,cAAc,EAEd,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACX,oBAAoB,EACpB,iBAAiB,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAWvD,qBAAa,sBAAsB,CAClC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACtC,SAAQ,eAAe;IACxB,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,MAAM,CAAC,CAAa;gBAG3B,MAAM,CAAC,EAAE,cAAc,GAAG;QACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;KAChD;IAMF;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAgIlB,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAuEzB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAiC7D,eAAe,CACpB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAyBhD,gBAAgB,CACrB,OAAO,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAa/B,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;IA4BhE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IASrD,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,CAAC;IAUlB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4EnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,qBAAqB,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC3E,OAAO,CAAC,OAAO,CAAC;CA2JnB"}

package/dist/abstractions/DefaultPresenceManager.js

@@ -393,5 +393,171 @@ class DefaultPresenceManager extends PresenceManager_js_1.PresenceManager {
     getUniqueUserCount() {
         return this.userPresences.size + this.gracePeriodEntries.size;
     }
+    /**
+     * Convert UserPresence to SerializableUserPresence
+     * Converts the devices Map to a plain object for JSON serialization
+     */
+    serializePresence(presence) {
+        const { devices, extended, ...rest } = presence;
+        return {
+            ...rest,
+            devices: Object.fromEntries(devices),
+            // Spread extended data at top level for compatibility
+            ...(extended || {}),
+        };
+    }
+    /**
+     * Handle presence WebSocket messages
+     *
+     * This method handles core presence messages and delegates to extensions
+     * for extension-specific messages. Use this with CustomMessageHandler.
+     *
+     * @param userId - Authenticated user ID
+     * @param deviceId - Device/client ID
+     * @param message - The WebSocket message
+     * @param sendResponse - Callback to send response
+     * @returns true if the message was handled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const server = new ServerBuilder()
+     *   .withPresenceManager(presenceManager)
+     *   .withCustomMessageHandler(async (clientId, message, sendResponse) => {
+     *     const client = server.getClient(clientId);
+     *     if (!client?.authenticated || !client.userId) return false;
+     *     const deviceId = getDeviceIdForClient(clientId);
+     *     return presenceManager.handlePresenceMessage(
+     *       client.userId,
+     *       deviceId,
+     *       message,
+     *       sendResponse
+     *     );
+     *   })
+     *   .build();
+     * ```
+     */
+    async handlePresenceMessage(userId, deviceId, message, sendResponse) {
+        switch (message.type) {
+            case "presence:get_users": {
+                const onlineUsers = await this.getOnlineUsers();
+                const users = onlineUsers.map((u) => this.serializePresence(u));
+                const response = {
+                    users,
+                    stats: {
+                        totalOnline: users.length,
+                    },
+                };
+                await sendResponse({ type: "presence:get_users", payload: response });
+                return true;
+            }
+            case "presence:get_user": {
+                const { userId: targetUserId } = message.payload;
+                const userPresence = await this.getUserPresence(targetUserId);
+                const response = {
+                    user: userPresence ? this.serializePresence(userPresence) : null,
+                };
+                await sendResponse({ type: "presence:get_user", payload: response });
+                return true;
+            }
+            case "presence:set_status": {
+                const { status, statusMessage } = message.payload;
+                await this.setUserStatus(userId, status);
+                // Broadcast status change
+                if (this.config.broadcastPresenceUpdates && this.server) {
+                    const experimental = this.server.experimental;
+                    await experimental?.broadcastAuthenticated({
+                        type: "presence:status_changed",
+                        payload: { userId, status, statusMessage },
+                    });
+                }
+                const response = { success: true };
+                await sendResponse({ type: "presence:set_status", payload: response });
+                return true;
+            }
+            case "presence:set_visibility": {
+                const { visible } = message.payload;
+                // Visibility is handled by extensions
+                // Find an extension that can handle visibility
+                for (const ext of this.extensions) {
+                    if (typeof ext.setVisibility === "function") {
+                        ext.setVisibility(userId, visible);
+                        break;
+                    }
+                }
+                const response = { success: true };
+                await sendResponse({ type: "presence:set_visibility", payload: response });
+                return true;
+            }
+            case "presence:repo_status_update": {
+                const { repoId, gitStatus } = message.payload;
+                // Find extension that can handle git status update
+                let updated = false;
+                for (const ext of this.extensions) {
+                    if (typeof ext.updateRepositoryGitStatus === "function") {
+                        updated = ext.updateRepositoryGitStatus(userId, repoId, deviceId, gitStatus);
+                        break;
+                    }
+                }
+                if (!updated) {
+                    const response = {
+                        success: false,
+                        message: "Repository session not found",
+                    };
+                    await sendResponse({ type: "presence:repo_status_update", payload: response });
+                    return true;
+                }
+                // Broadcast status change
+                if (this.config.broadcastPresenceUpdates && this.server) {
+                    // Check visibility
+                    let visible = true;
+                    for (const ext of this.extensions) {
+                        const shouldShow = await ext.shouldBeVisible?.(userId);
+                        if (shouldShow === false) {
+                            visible = false;
+                            break;
+                        }
+                    }
+                    if (visible) {
+                        const experimental = this.server.experimental;
+                        await experimental?.broadcastAuthenticated({
+                            type: "presence:repo_status_changed",
+                            payload: { userId, repoId, deviceId, gitStatus },
+                        });
+                    }
+                }
+                const response = {
+                    success: true,
+                    message: "Status updated",
+                };
+                await sendResponse({ type: "presence:repo_status_update", payload: response });
+                return true;
+            }
+            default: {
+                // Try extension handlers
+                for (const ext of this.extensions) {
+                    if (ext.handleMessage) {
+                        const result = await ext.handleMessage(userId, deviceId, message.type, message.payload);
+                        if (result) {
+                            // Send response
+                            await sendResponse({
+                                type: message.type,
+                                payload: result.response,
+                            });
+                            // Handle broadcast if specified
+                            if (result.broadcast && this.server) {
+                                const experimental = this.server.experimental;
+                                await experimental?.broadcastAuthenticated({
+                                    type: result.broadcast.type,
+                                    payload: result.broadcast.payload,
+                                });
+                            }
+                            return true;
+                        }
+                    }
+                }
+                return false; // Message not handled
+            }
+        }
+    }
 }
 exports.DefaultPresenceManager = DefaultPresenceManager;

package/dist/abstractions/PresenceExtension.d.ts

@@ -9,8 +9,31 @@
  * - Control visibility of users
  * - React to room joins/leaves
  * - Track application-specific presence state
+ * - Handle custom WebSocket messages
  */
 import type { UserPresence } from "../types/presence.js";
+/**
+ * Result from handling a presence message
+ */
+export interface PresenceMessageHandlerResult {
+    /**
+     * Response payload to send back to the client
+     */
+    response: unknown;
+    /**
+     * Optional broadcast payload to send to other clients
+     * If provided, will be broadcast to all authenticated clients
+     */
+    broadcast?: {
+        type: string;
+        payload: unknown;
+        /**
+         * If true, exclude the sender from the broadcast
+         * @default true
+         */
+        excludeSender?: boolean;
+    };
+}
 /**
  * Extension for adding custom presence data and behavior
  *
@@ -106,6 +129,45 @@ export interface PresenceExtension<TExtendedData = Record<string, unknown>> {
      * Use this for cleanup tasks like persisting state.
      */
     destroy?(): Promise<void> | void;
+    /**
+     * Lifecycle: Called when presence state should be cleaned up for a user
+     *
+     * Use this for cleaning up user-specific state when they go fully offline.
+     *
+     * @param userId - User identifier
+     */
+    onPresenceCleanup?(userId: string): Promise<void> | void;
+    /**
+     * Handle extension-specific WebSocket messages
+     *
+     * Return a result if the message was handled, undefined if not.
+     * The presence manager will send the response and handle any broadcasts.
+     *
+     * @param userId - User identifier
+     * @param deviceId - Device/client identifier
+     * @param messageType - The message type (e.g., 'presence:repo_status_update')
+     * @param payload - The message payload
+     * @returns Handler result with response and optional broadcast, or undefined if not handled
+     *
+     * @example
+     * ```typescript
+     * async handleMessage(userId, deviceId, type, payload) {
+     *   if (type === 'presence:repo_status_update') {
+     *     const { repoId, gitStatus } = payload;
+     *     this.updateGitStatus(userId, repoId, deviceId, gitStatus);
+     *     return {
+     *       response: { success: true, message: 'Status updated' },
+     *       broadcast: {
+     *         type: 'presence:repo_status_changed',
+     *         payload: { userId, repoId, deviceId, gitStatus }
+     *       }
+     *     };
+     *   }
+     *   return undefined;
+     * }
+     * ```
+     */
+    handleMessage?(userId: string, deviceId: string, messageType: string, payload: unknown): Promise<PresenceMessageHandlerResult | undefined> | PresenceMessageHandlerResult | undefined;
 }
 /**
  * Extended user presence with custom data

package/dist/abstractions/PresenceExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceExtension.d.ts","sourceRoot":"","sources":["../../src/abstractions/PresenceExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE;;;;;;OAMG;IACH,YAAY,CAAC,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvE;;;;;;OAMG;IACH,iBAAiB,CAAC,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,oBAAoB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9E;;;;;;;;OAQG;IACH,YAAY,CAAC,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB;;;;;;OAMG;IACH,UAAU,CAAC,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB;;;;;;;OAOG;IACH,eAAe,CAAC,CACf,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC;IAExD;;;;;;;;OAQG;IACH,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAE7D;;;;;;OAMG;IACH,UAAU,CAAC,CACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,GACnD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpC;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC5E,SAAQ,YAAY;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CACzB"}
+{"version":3,"file":"PresenceExtension.d.ts","sourceRoot":"","sources":["../../src/abstractions/PresenceExtension.ts"],"names":[],"mappings":"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"}

package/dist/abstractions/PresenceExtension.js

@@ -10,5 +10,6 @@
  * - Control visibility of users
  * - React to room joins/leaves
  * - Track application-specific presence state
+ * - Handle custom WebSocket messages
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/abstractions/index.d.ts

@@ -5,7 +5,7 @@ export { DefaultPresenceManager } from "./DefaultPresenceManager.js";
 export { DefaultRoomManager } from "./DefaultRoomManager.js";
 export { EventListener, TypedEventEmitter, UnsubscribeFn, } from "./EventEmitter.js";
 export { LockManager } from "./LockManager.js";
-export { type ExtendedUserPresence, type PresenceExtension, } from "./PresenceExtension.js";
+export { type ExtendedUserPresence, type PresenceExtension, type PresenceMessageHandlerResult, } from "./PresenceExtension.js";
 export { PresenceManager } from "./PresenceManager.js";
 export { RoomManager } from "./RoomManager.js";
 export { IStorageAdapter, StorageOperation } from "./StorageAdapter.js";

package/dist/abstractions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,aAAa,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,aAAa,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}