@herdctl/discord 0.0.1

package/dist/mention-handler.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Mention handler for Discord bot interactions
+ *
+ * Provides utilities for:
+ * - Detecting bot mentions in messages
+ * - Stripping mentions from prompt text
+ * - Building conversation context from message history
+ */
+import type { Message, Collection, Snowflake, TextChannel, DMChannel, NewsChannel, ThreadChannel } from "discord.js";
+/**
+ * Supported text-based channel types for message fetching
+ */
+export type TextBasedChannel = TextChannel | DMChannel | NewsChannel | ThreadChannel;
+/**
+ * A processed message for context building
+ */
+export interface ContextMessage {
+    /** Discord user ID of the message author */
+    authorId: string;
+    /** Display name or username of the message author */
+    authorName: string;
+    /** Whether the author is a bot */
+    isBot: boolean;
+    /** Whether this is the bot's own message */
+    isSelf: boolean;
+    /** Message content with any bot mentions stripped */
+    content: string;
+    /** ISO timestamp of when the message was created */
+    timestamp: string;
+    /** The original message ID */
+    messageId: string;
+}
+/**
+ * Options for building conversation context
+ */
+export interface ContextBuildOptions {
+    /** Maximum number of messages to include (default: 10) */
+    maxMessages?: number;
+    /** Whether to include bot messages in context (default: true) */
+    includeBotMessages?: boolean;
+    /** Whether to prioritize user messages over bot messages (default: true) */
+    prioritizeUserMessages?: boolean;
+}
+/**
+ * Result of context building
+ */
+export interface ConversationContext {
+    /** Processed messages in chronological order (oldest first) */
+    messages: ContextMessage[];
+    /** The triggering message with mention stripped */
+    prompt: string;
+    /** Whether the bot was mentioned in the triggering message */
+    wasMentioned: boolean;
+}
+/**
+ * Check if a message mentions a specific bot user
+ *
+ * @param message - Discord message to check
+ * @param botUserId - The bot's user ID
+ * @returns true if the bot is mentioned, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isBotMentioned(message, client.user.id)) {
+ *   // Handle the mention
+ * }
+ * ```
+ */
+export declare function isBotMentioned(message: Message, botUserId: string): boolean;
+/**
+ * Check if a message should be processed based on channel mode
+ *
+ * @param message - Discord message to check
+ * @param botUserId - The bot's user ID
+ * @param mode - Channel mode ('mention' or 'auto')
+ * @returns true if the message should be processed, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (shouldProcessMessage(message, client.user.id, 'mention')) {
+ *   // Bot was mentioned, process the message
+ * }
+ * ```
+ */
+export declare function shouldProcessMessage(message: Message, botUserId: string, mode: "mention" | "auto"): boolean;
+/**
+ * Strip bot mention from message content
+ *
+ * Removes the bot mention (e.g., <@123456789>) from the message content
+ * and trims any excess whitespace.
+ *
+ * @param content - Message content to process
+ * @param botUserId - The bot's user ID
+ * @returns Content with the bot mention removed
+ *
+ * @example
+ * ```typescript
+ * const prompt = stripBotMention("<@123> help me with this", "123");
+ * // Returns: "help me with this"
+ * ```
+ */
+export declare function stripBotMention(content: string, botUserId: string): string;
+/**
+ * Strip all bot mentions from message content
+ *
+ * Removes all user mentions from the message content. Useful for
+ * cleaning context messages.
+ *
+ * @param content - Message content to process
+ * @param botUserId - The bot's user ID (optional, if provided only strips this bot)
+ * @returns Content with mentions removed
+ */
+export declare function stripMentions(content: string, botUserId?: string): string;
+/**
+ * Process a Discord message into a context message
+ *
+ * @param message - Discord message to process
+ * @param botUserId - The bot's user ID
+ * @returns Processed context message
+ */
+export declare function processMessage(message: Message, botUserId: string): ContextMessage;
+/**
+ * Fetch recent message history from a channel
+ *
+ * @param channel - Text-based channel to fetch from
+ * @param beforeMessageId - Fetch messages before this message ID
+ * @param limit - Maximum number of messages to fetch
+ * @returns Collection of messages
+ */
+export declare function fetchMessageHistory(channel: TextBasedChannel, beforeMessageId: string, limit: number): Promise<Collection<Snowflake, Message>>;
+/**
+ * Build conversation context from message history
+ *
+ * Fetches recent messages from the channel and processes them into
+ * a conversation context suitable for sending to Claude.
+ *
+ * @param triggerMessage - The message that triggered the bot
+ * @param channel - The channel to fetch history from
+ * @param botUserId - The bot's user ID
+ * @param options - Context building options
+ * @returns Conversation context with processed messages
+ *
+ * @example
+ * ```typescript
+ * const context = await buildConversationContext(
+ *   message,
+ *   message.channel,
+ *   client.user.id,
+ *   { maxMessages: 10, prioritizeUserMessages: true }
+ * );
+ *
+ * // Use context.prompt as the main prompt
+ * // Use context.messages for conversation history
+ * ```
+ */
+export declare function buildConversationContext(triggerMessage: Message, channel: TextBasedChannel, botUserId: string, options?: ContextBuildOptions): Promise<ConversationContext>;
+/**
+ * Format conversation context as a string for Claude
+ *
+ * Creates a formatted string representation of the conversation context
+ * suitable for including in a prompt to Claude.
+ *
+ * @param context - The conversation context to format
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * const formatted = formatContextForPrompt(context);
+ * // Returns:
+ * // [User123 at 2024-01-20T10:00:00Z]: How do I use this feature?
+ * // [BotName at 2024-01-20T10:00:30Z]: Here's how you can...
+ * // [User123 at 2024-01-20T10:01:00Z]: Thanks, but what about...
+ * ```
+ */
+export declare function formatContextForPrompt(context: ConversationContext): string;
+//# sourceMappingURL=mention-handler.d.ts.map

package/dist/mention-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-handler.d.ts","sourceRoot":"","sources":["../src/mention-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMrH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,GAAG,MAAM,GACvB,OAAO,CAaT;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzE;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,cAAc,CAUhB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAKzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAoE9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAW3E"}

package/dist/mention-handler.js

@@ -0,0 +1,236 @@
+/**
+ * Mention handler for Discord bot interactions
+ *
+ * Provides utilities for:
+ * - Detecting bot mentions in messages
+ * - Stripping mentions from prompt text
+ * - Building conversation context from message history
+ */
+// =============================================================================
+// Mention Detection
+// =============================================================================
+/**
+ * Check if a message mentions a specific bot user
+ *
+ * @param message - Discord message to check
+ * @param botUserId - The bot's user ID
+ * @returns true if the bot is mentioned, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isBotMentioned(message, client.user.id)) {
+ *   // Handle the mention
+ * }
+ * ```
+ */
+export function isBotMentioned(message, botUserId) {
+    // Check if the bot is directly mentioned
+    return message.mentions.users.has(botUserId);
+}
+/**
+ * Check if a message should be processed based on channel mode
+ *
+ * @param message - Discord message to check
+ * @param botUserId - The bot's user ID
+ * @param mode - Channel mode ('mention' or 'auto')
+ * @returns true if the message should be processed, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (shouldProcessMessage(message, client.user.id, 'mention')) {
+ *   // Bot was mentioned, process the message
+ * }
+ * ```
+ */
+export function shouldProcessMessage(message, botUserId, mode) {
+    // Never process messages from bots (including self)
+    if (message.author.bot) {
+        return false;
+    }
+    // In 'auto' mode, process all non-bot messages
+    if (mode === "auto") {
+        return true;
+    }
+    // In 'mention' mode, only process if bot is mentioned
+    return isBotMentioned(message, botUserId);
+}
+// =============================================================================
+// Mention Stripping
+// =============================================================================
+/**
+ * Strip bot mention from message content
+ *
+ * Removes the bot mention (e.g., <@123456789>) from the message content
+ * and trims any excess whitespace.
+ *
+ * @param content - Message content to process
+ * @param botUserId - The bot's user ID
+ * @returns Content with the bot mention removed
+ *
+ * @example
+ * ```typescript
+ * const prompt = stripBotMention("<@123> help me with this", "123");
+ * // Returns: "help me with this"
+ * ```
+ */
+export function stripBotMention(content, botUserId) {
+    // Match both regular mentions <@id> and nickname mentions <@!id>
+    const mentionRegex = new RegExp(`<@!?${botUserId}>`, "g");
+    return content.replace(mentionRegex, "").trim();
+}
+/**
+ * Strip all bot mentions from message content
+ *
+ * Removes all user mentions from the message content. Useful for
+ * cleaning context messages.
+ *
+ * @param content - Message content to process
+ * @param botUserId - The bot's user ID (optional, if provided only strips this bot)
+ * @returns Content with mentions removed
+ */
+export function stripMentions(content, botUserId) {
+    if (botUserId) {
+        return stripBotMention(content, botUserId);
+    }
+    // Strip all user mentions
+    return content.replace(/<@!?\d+>/g, "").trim();
+}
+// =============================================================================
+// Context Building
+// =============================================================================
+/**
+ * Process a Discord message into a context message
+ *
+ * @param message - Discord message to process
+ * @param botUserId - The bot's user ID
+ * @returns Processed context message
+ */
+export function processMessage(message, botUserId) {
+    return {
+        authorId: message.author.id,
+        authorName: message.author.displayName ?? message.author.username,
+        isBot: message.author.bot,
+        isSelf: message.author.id === botUserId,
+        content: stripBotMention(message.content, botUserId),
+        timestamp: message.createdAt.toISOString(),
+        messageId: message.id,
+    };
+}
+/**
+ * Fetch recent message history from a channel
+ *
+ * @param channel - Text-based channel to fetch from
+ * @param beforeMessageId - Fetch messages before this message ID
+ * @param limit - Maximum number of messages to fetch
+ * @returns Collection of messages
+ */
+export async function fetchMessageHistory(channel, beforeMessageId, limit) {
+    return channel.messages.fetch({
+        before: beforeMessageId,
+        limit,
+    });
+}
+/**
+ * Build conversation context from message history
+ *
+ * Fetches recent messages from the channel and processes them into
+ * a conversation context suitable for sending to Claude.
+ *
+ * @param triggerMessage - The message that triggered the bot
+ * @param channel - The channel to fetch history from
+ * @param botUserId - The bot's user ID
+ * @param options - Context building options
+ * @returns Conversation context with processed messages
+ *
+ * @example
+ * ```typescript
+ * const context = await buildConversationContext(
+ *   message,
+ *   message.channel,
+ *   client.user.id,
+ *   { maxMessages: 10, prioritizeUserMessages: true }
+ * );
+ *
+ * // Use context.prompt as the main prompt
+ * // Use context.messages for conversation history
+ * ```
+ */
+export async function buildConversationContext(triggerMessage, channel, botUserId, options = {}) {
+    const { maxMessages = 10, includeBotMessages = true, prioritizeUserMessages = true, } = options;
+    // Process the trigger message
+    const wasMentioned = isBotMentioned(triggerMessage, botUserId);
+    const prompt = stripBotMention(triggerMessage.content, botUserId);
+    // Fetch message history (messages before the trigger)
+    // Fetch more than we need to allow for filtering
+    const fetchLimit = prioritizeUserMessages ? maxMessages * 2 : maxMessages;
+    const history = await fetchMessageHistory(channel, triggerMessage.id, fetchLimit);
+    // Convert to array and process
+    let processedMessages = Array.from(history.values())
+        .map((msg) => processMessage(msg, botUserId))
+        .filter((msg) => {
+        // Filter out bot messages if not included
+        if (!includeBotMessages && msg.isBot) {
+            return false;
+        }
+        // Always filter out empty messages
+        if (!msg.content.trim()) {
+            return false;
+        }
+        return true;
+    });
+    // If prioritizing user messages, sort to put user messages first
+    // then take the limit, then re-sort by timestamp
+    if (prioritizeUserMessages && processedMessages.length > maxMessages) {
+        // Separate user and bot messages
+        const userMessages = processedMessages.filter((m) => !m.isBot);
+        const botMessages = processedMessages.filter((m) => m.isBot);
+        // Take user messages first, fill remaining with bot messages
+        const selectedMessages = [
+            ...userMessages.slice(0, maxMessages),
+            ...botMessages.slice(0, Math.max(0, maxMessages - userMessages.length)),
+        ].slice(0, maxMessages);
+        // Sort by timestamp (oldest first)
+        processedMessages = selectedMessages.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    else {
+        // Take messages and sort by timestamp (oldest first) for chronological order
+        processedMessages = processedMessages
+            .slice(0, maxMessages)
+            .sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    return {
+        messages: processedMessages,
+        prompt,
+        wasMentioned,
+    };
+}
+/**
+ * Format conversation context as a string for Claude
+ *
+ * Creates a formatted string representation of the conversation context
+ * suitable for including in a prompt to Claude.
+ *
+ * @param context - The conversation context to format
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * const formatted = formatContextForPrompt(context);
+ * // Returns:
+ * // [User123 at 2024-01-20T10:00:00Z]: How do I use this feature?
+ * // [BotName at 2024-01-20T10:00:30Z]: Here's how you can...
+ * // [User123 at 2024-01-20T10:01:00Z]: Thanks, but what about...
+ * ```
+ */
+export function formatContextForPrompt(context) {
+    if (context.messages.length === 0) {
+        return "";
+    }
+    return context.messages
+        .map((msg) => {
+        const authorLabel = msg.isBot ? `${msg.authorName} (bot)` : msg.authorName;
+        return `[${authorLabel} at ${msg.timestamp}]: ${msg.content}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=mention-handler.js.map

package/dist/mention-handler.js.map

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

package/dist/session-manager/__tests__/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/session-manager/__tests__/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../../src/session-manager/__tests__/errors.test.ts"],"names":[],"mappings":""}

package/dist/session-manager/__tests__/errors.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect } from "vitest";
+import { SessionErrorCode, SessionManagerError, SessionStateReadError, SessionStateWriteError, SessionDirectoryCreateError, isSessionManagerError, } from "../errors.js";
+// =============================================================================
+// SessionManagerError Tests
+// =============================================================================
+describe("SessionManagerError", () => {
+    it("creates error with correct properties", () => {
+        const error = new SessionManagerError("Test error message", SessionErrorCode.STATE_READ_FAILED, "test-agent");
+        expect(error.message).toBe("Test error message");
+        expect(error.code).toBe(SessionErrorCode.STATE_READ_FAILED);
+        expect(error.agentName).toBe("test-agent");
+        expect(error.name).toBe("SessionManagerError");
+    });
+    it("accepts cause option", () => {
+        const cause = new Error("Original error");
+        const error = new SessionManagerError("Wrapper error", SessionErrorCode.STATE_WRITE_FAILED, "test-agent", { cause });
+        expect(error.cause).toBe(cause);
+    });
+});
+// =============================================================================
+// SessionStateReadError Tests
+// =============================================================================
+describe("SessionStateReadError", () => {
+    it("creates error with correct message and properties", () => {
+        const error = new SessionStateReadError("my-agent", "/path/to/state.yaml");
+        expect(error.message).toBe("Failed to read session state for agent 'my-agent' from '/path/to/state.yaml'");
+        expect(error.code).toBe(SessionErrorCode.STATE_READ_FAILED);
+        expect(error.agentName).toBe("my-agent");
+        expect(error.path).toBe("/path/to/state.yaml");
+        expect(error.name).toBe("SessionStateReadError");
+    });
+    it("accepts cause option", () => {
+        const cause = new Error("ENOENT");
+        const error = new SessionStateReadError("my-agent", "/path/to/state.yaml", { cause });
+        expect(error.cause).toBe(cause);
+    });
+});
+// =============================================================================
+// SessionStateWriteError Tests
+// =============================================================================
+describe("SessionStateWriteError", () => {
+    it("creates error with correct message and properties", () => {
+        const error = new SessionStateWriteError("my-agent", "/path/to/state.yaml");
+        expect(error.message).toBe("Failed to write session state for agent 'my-agent' to '/path/to/state.yaml'");
+        expect(error.code).toBe(SessionErrorCode.STATE_WRITE_FAILED);
+        expect(error.agentName).toBe("my-agent");
+        expect(error.path).toBe("/path/to/state.yaml");
+        expect(error.name).toBe("SessionStateWriteError");
+    });
+    it("accepts cause option", () => {
+        const cause = new Error("EACCES");
+        const error = new SessionStateWriteError("my-agent", "/path/to/state.yaml", { cause });
+        expect(error.cause).toBe(cause);
+    });
+});
+// =============================================================================
+// SessionDirectoryCreateError Tests
+// =============================================================================
+describe("SessionDirectoryCreateError", () => {
+    it("creates error with correct message and properties", () => {
+        const error = new SessionDirectoryCreateError("my-agent", "/path/to/sessions");
+        expect(error.message).toBe("Failed to create session directory for agent 'my-agent' at '/path/to/sessions'");
+        expect(error.code).toBe(SessionErrorCode.DIRECTORY_CREATE_FAILED);
+        expect(error.agentName).toBe("my-agent");
+        expect(error.path).toBe("/path/to/sessions");
+        expect(error.name).toBe("SessionDirectoryCreateError");
+    });
+    it("accepts cause option", () => {
+        const cause = new Error("EPERM");
+        const error = new SessionDirectoryCreateError("my-agent", "/path/to/sessions", { cause });
+        expect(error.cause).toBe(cause);
+    });
+});
+// =============================================================================
+// isSessionManagerError Tests
+// =============================================================================
+describe("isSessionManagerError", () => {
+    it("returns true for SessionManagerError", () => {
+        const error = new SessionManagerError("Test", SessionErrorCode.STATE_READ_FAILED, "agent");
+        expect(isSessionManagerError(error)).toBe(true);
+    });
+    it("returns true for SessionStateReadError", () => {
+        const error = new SessionStateReadError("agent", "/path");
+        expect(isSessionManagerError(error)).toBe(true);
+    });
+    it("returns true for SessionStateWriteError", () => {
+        const error = new SessionStateWriteError("agent", "/path");
+        expect(isSessionManagerError(error)).toBe(true);
+    });
+    it("returns true for SessionDirectoryCreateError", () => {
+        const error = new SessionDirectoryCreateError("agent", "/path");
+        expect(isSessionManagerError(error)).toBe(true);
+    });
+    it("returns false for regular Error", () => {
+        const error = new Error("Not a session error");
+        expect(isSessionManagerError(error)).toBe(false);
+    });
+    it("returns false for null", () => {
+        expect(isSessionManagerError(null)).toBe(false);
+    });
+    it("returns false for undefined", () => {
+        expect(isSessionManagerError(undefined)).toBe(false);
+    });
+    it("returns false for string", () => {
+        expect(isSessionManagerError("error")).toBe(false);
+    });
+    it("returns false for object", () => {
+        expect(isSessionManagerError({ message: "error" })).toBe(false);
+    });
+});
+// =============================================================================
+// Error Code Tests
+// =============================================================================
+describe("SessionErrorCode", () => {
+    it("has all expected error codes", () => {
+        expect(SessionErrorCode.STATE_READ_FAILED).toBe("SESSION_STATE_READ_FAILED");
+        expect(SessionErrorCode.STATE_WRITE_FAILED).toBe("SESSION_STATE_WRITE_FAILED");
+        expect(SessionErrorCode.DIRECTORY_CREATE_FAILED).toBe("SESSION_DIRECTORY_CREATE_FAILED");
+        expect(SessionErrorCode.SESSION_NOT_FOUND).toBe("SESSION_NOT_FOUND");
+        expect(SessionErrorCode.SESSION_EXPIRED).toBe("SESSION_EXPIRED");
+        expect(SessionErrorCode.INVALID_STATE).toBe("SESSION_INVALID_STATE");
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/session-manager/__tests__/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../../src/session-manager/__tests__/errors.test.ts"],"names":[],"mappings":"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"}

package/dist/session-manager/__tests__/session-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-manager.test.d.ts.map

package/dist/session-manager/__tests__/session-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.test.d.ts","sourceRoot":"","sources":["../../../src/session-manager/__tests__/session-manager.test.ts"],"names":[],"mappings":""}