@elizaos/core 2.0.0-alpha.43 → 2.0.0-alpha.44

package/dist/sessions/session-key.d.ts

@@ -1,201 +0,0 @@
-/**
- * Session key utilities for ElizaOS.
- *
- * Provides functions for building, parsing, and normalizing session keys
- * used to identify agent sessions, threads, and peer connections.
- *
- * Session keys follow the format: agent:{agentId}:{rest}
- *
- * @module sessions/session-key
- */
-export declare const DEFAULT_AGENT_ID = "main";
-export declare const DEFAULT_MAIN_KEY = "main";
-export declare const DEFAULT_ACCOUNT_ID = "default";
-/**
- * Parsed agent session key components.
- */
-export type ParsedAgentSessionKey = {
-    /** The full original session key */
-    raw: string;
-    /** Agent ID extracted from the key */
-    agentId: string;
-    /** The remainder of the key after agent:{agentId}: */
-    rest: string;
-    /** Whether this is an ACP (Agent Communication Protocol) session */
-    isAcp: boolean;
-    /** Whether this is a subagent session */
-    isSubagent: boolean;
-    /** Thread ID if present */
-    threadId?: string;
-    /** Parent session key if this is a thread */
-    parentKey?: string;
-};
-/**
- * Parse an agent session key into its components.
- *
- * Session keys follow the format:
- * - agent:{agentId}:{rest}
- * - agent:{agentId}:acp:{...}
- * - agent:{agentId}:subagent:{subagentId}:{...}
- * - agent:{agentId}:{...}:thread:{threadId}
- *
- * @param sessionKey - The session key to parse
- * @returns Parsed components or null if invalid
- */
-export declare function parseAgentSessionKey(sessionKey: string | undefined | null): ParsedAgentSessionKey | null;
-/**
- * Check if a session key is an ACP session.
- *
- * @param sessionKey - The session key to check
- * @returns True if this is an ACP session
- */
-export declare function isAcpSessionKey(sessionKey: string | undefined | null): boolean;
-/**
- * Check if a session key is a subagent session.
- *
- * @param sessionKey - The session key to check
- * @returns True if this is a subagent session
- */
-export declare function isSubagentSessionKey(sessionKey: string | undefined | null): boolean;
-/**
- * Resolve the parent session key for a thread session.
- *
- * @param sessionKey - The session key to resolve
- * @returns Parent session key or the original key if not a thread
- */
-export declare function resolveThreadParentSessionKey(sessionKey: string | undefined | null): string | null;
-/**
- * Normalize a main key value.
- *
- * @param value - Value to normalize
- * @returns Normalized main key
- */
-export declare function normalizeMainKey(value: string | undefined | null): string;
-/**
- * Normalize an agent ID.
- *
- * Ensures the ID is path-safe and shell-friendly.
- *
- * @param value - Value to normalize
- * @returns Normalized agent ID
- */
-export declare function normalizeAgentId(value: string | undefined | null): string;
-/**
- * Sanitize an agent ID (alias for normalizeAgentId).
- *
- * @param value - Value to sanitize
- * @returns Sanitized agent ID
- */
-export declare function sanitizeAgentId(value: string | undefined | null): string;
-/**
- * Normalize an account ID.
- *
- * @param value - Value to normalize
- * @returns Normalized account ID
- */
-export declare function normalizeAccountId(value: string | undefined | null): string;
-/**
- * Build an agent session key from components.
- *
- * @param agentId - The agent ID
- * @param rest - The rest of the key
- * @returns Formatted session key
- */
-export declare function buildAgentSessionKey(agentId: string, rest: string): string;
-/**
- * Build the main session key for an agent.
- *
- * @param params - Session key parameters
- * @returns Main session key
- */
-export declare function buildAgentMainSessionKey(params: {
-    agentId: string;
-    mainKey?: string | undefined;
-}): string;
-/**
- * Build an ACP session key.
- *
- * @param agentId - The agent ID
- * @param acpKey - The ACP-specific key portion
- * @returns Formatted ACP session key
- */
-export declare function buildAcpSessionKey(agentId: string, acpKey: string): string;
-/**
- * Build a subagent session key.
- *
- * @param agentId - The parent agent ID
- * @param subagentId - The subagent ID
- * @param rest - Additional key portion
- * @returns Formatted subagent session key
- */
-export declare function buildSubagentSessionKey(agentId: string, subagentId: string, rest?: string): string;
-/**
- * Build a peer session key for an agent.
- *
- * @param params - Peer session parameters
- * @returns Peer session key
- */
-export declare function buildAgentPeerSessionKey(params: {
-    agentId: string;
-    mainKey?: string | undefined;
-    channel: string;
-    accountId?: string | null;
-    peerKind?: "dm" | "group" | "channel" | null;
-    peerId?: string | null;
-    identityLinks?: Record<string, string[]>;
-    /** DM session scope. */
-    dmScope?: "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
-}): string;
-/**
- * Convert a store session key to a request session key.
- *
- * @param storeKey - Store session key
- * @returns Request session key or undefined
- */
-export declare function toAgentRequestSessionKey(storeKey: string | undefined | null): string | undefined;
-/**
- * Convert a request session key to a store session key.
- *
- * @param params - Conversion parameters
- * @returns Store session key
- */
-export declare function toAgentStoreSessionKey(params: {
-    agentId: string;
-    requestKey: string | undefined | null;
-    mainKey?: string | undefined;
-}): string;
-/**
- * Resolve the agent ID from a session key.
- *
- * @param sessionKey - Session key to parse
- * @returns Resolved agent ID
- */
-export declare function resolveAgentIdFromSessionKey(sessionKey: string | undefined | null): string;
-/**
- * Build a group history key.
- *
- * @param params - History key parameters
- * @returns Group history key
- */
-export declare function buildGroupHistoryKey(params: {
-    channel: string;
-    accountId?: string | null;
-    peerKind: "group" | "channel";
-    peerId: string;
-}): string;
-/**
- * Resolve thread session keys.
- *
- * @param params - Thread resolution parameters
- * @returns Session key and optional parent session key
- */
-export declare function resolveThreadSessionKeys(params: {
-    baseSessionKey: string;
-    threadId?: string | null;
-    parentSessionKey?: string;
-    useSuffix?: boolean;
-}): {
-    sessionKey: string;
-    parentSessionKey?: string;
-};
-//# sourceMappingURL=session-key.d.ts.map

package/dist/sessions/session-key.d.ts.map

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

package/dist/sessions/store.d.ts

@@ -1,117 +0,0 @@
-/**
- * Session store for ElizaOS.
- *
- * Provides file-based session storage with caching, locking, and
- * atomic updates. Designed to be used as the primary session
- * persistence layer.
- *
- * @module sessions/store
- */
-import { type SessionEntry, type SessionStore } from "./types.js";
-/**
- * Clear all session store caches (for testing).
- */
-export declare function clearSessionStoreCacheForTest(): void;
-export declare function getSessionStoreCacheSizeForTest(): number;
-export type LoadSessionStoreOptions = {
-    /** Skip cache and read directly from disk */
-    skipCache?: boolean;
-};
-/**
- * Load a session store from disk.
- *
- * @param storePath - Path to the store file
- * @param opts - Load options
- * @returns Session store (empty object if file doesn't exist)
- */
-export declare function loadSessionStore(storePath: string, opts?: LoadSessionStoreOptions): SessionStore;
-/**
- * Save a session store to disk with locking.
- *
- * @param storePath - Path to the store file
- * @param store - Store to save
- */
-export declare function saveSessionStore(storePath: string, store: SessionStore): Promise<void>;
-/**
- * Update a session store with a mutator function.
- *
- * Acquires a lock, reads the store, applies mutations, and saves.
- *
- * @param storePath - Path to the store file
- * @param mutator - Function to mutate the store
- * @returns Result of the mutator function
- */
-export declare function updateSessionStore<T>(storePath: string, mutator: (store: SessionStore) => Promise<T> | T): Promise<T>;
-/**
- * Update a single session entry.
- *
- * @param params - Update parameters
- * @returns Updated entry or null if not found
- */
-export declare function updateSessionStoreEntry(params: {
-    storePath: string;
-    sessionKey: string;
-    update: (entry: SessionEntry) => Promise<Partial<SessionEntry> | null>;
-}): Promise<SessionEntry | null>;
-/**
- * Get a session entry from the store.
- *
- * @param storePath - Path to the store file
- * @param sessionKey - Session key to look up
- * @returns Session entry or undefined
- */
-export declare function getSessionEntry(storePath: string, sessionKey: string): SessionEntry | undefined;
-/**
- * Get a session entry by session ID.
- *
- * @param storePath - Path to the store file
- * @param sessionId - Session ID to look up
- * @returns Session entry or undefined
- */
-export declare function getSessionEntryById(storePath: string, sessionId: string): SessionEntry | undefined;
-/**
- * Get the updated timestamp for a session.
- *
- * @param params - Query parameters
- * @returns Timestamp or undefined
- */
-export declare function readSessionUpdatedAt(params: {
-    storePath: string;
-    sessionKey: string;
-}): number | undefined;
-/**
- * Create or update a session entry.
- *
- * @param params - Upsert parameters
- * @returns The created/updated entry
- */
-export declare function upsertSessionEntry(params: {
-    storePath: string;
-    sessionKey: string;
-    patch: Partial<SessionEntry>;
-}): Promise<SessionEntry>;
-/**
- * Delete a session entry.
- *
- * @param params - Delete parameters
- * @returns True if entry was deleted
- */
-export declare function deleteSessionEntry(params: {
-    storePath: string;
-    sessionKey: string;
-}): Promise<boolean>;
-/**
- * List all session keys in a store.
- *
- * @param storePath - Path to the store file
- * @returns Array of session keys
- */
-export declare function listSessionKeys(storePath: string): string[];
-/**
- * List all sessions with their entries.
- *
- * @param storePath - Path to the store file
- * @returns Array of [key, entry] tuples
- */
-export declare function listSessions(storePath: string): Array<[string, SessionEntry]>;
-//# sourceMappingURL=store.d.ts.map

package/dist/sessions/store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAoFpB;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAGxD;AA0FD,MAAM,MAAM,uBAAuB,GAAG;IACpC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,uBAA4B,GACjC,YAAY,CA4Dd;AAiKD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;CACxE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsB/B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,YAAY,GAAG,SAAS,CAG1B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9B,GAAG,OAAO,CAAC,YAAY,CAAC,CASxB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAK7E"}

package/dist/sessions/types.d.ts

@@ -1,197 +0,0 @@
-/**
- * Session types for ElizaOS.
- *
- * Defines the core data structures for session management including
- * session entries, scopes, origins, and related metadata.
- *
- * Note: Some session-related types (SessionOrigin, SessionModelOverride, etc.)
- * are defined in types/memory.ts to avoid circular dependencies. This module
- * imports them for use in SessionEntry but does not re-export them to avoid
- * duplicate exports when both sessions and types are exported from index.
- *
- * @module sessions/types
- */
-import type { SessionOrigin, SessionSkillsSnapshot } from "../types/memory.js";
-/**
- * Normalized chat type for session classification.
- */
-export type SessionChatType = "dm" | "group" | "channel" | "thread";
-/**
- * Delivery context for routing responses.
- */
-export type SessionDeliveryContext = {
-    /** Channel to deliver to */
-    channel?: string;
-    /** Target recipient/destination */
-    to?: string;
-    /** Account to use for delivery */
-    accountId?: string;
-    /** Thread to deliver to */
-    threadId?: string | number;
-};
-/**
- * Core session entry representing a conversation session.
- *
- * This is the primary data structure for session state in ElizaOS.
- */
-export type SessionEntry = {
-    /** Unique session identifier (UUID) */
-    sessionId: string;
-    /** Last update timestamp (milliseconds since epoch) */
-    updatedAt: number;
-    /** Path to the session transcript file */
-    sessionFile?: string;
-    /** Parent session key that spawned this session (for subagent scoping) */
-    spawnedBy?: string;
-    /** Human-readable label for the session */
-    label?: string;
-    /** Display name for UI purposes */
-    displayName?: string;
-    /** Whether system introduction has been sent */
-    systemSent?: boolean;
-    /** Whether the last run was aborted */
-    abortedLastRun?: boolean;
-    /** Type of chat (dm, group, channel, thread) */
-    chatType?: SessionChatType;
-    /** Primary channel for this session */
-    channel?: string;
-    /** Group identifier (for group chats) */
-    groupId?: string;
-    /** Group subject/name */
-    subject?: string;
-    /** Group channel name (e.g., "#general") */
-    groupChannel?: string;
-    /** Space/server name (e.g., Discord guild) */
-    space?: string;
-    /** Origin information */
-    origin?: SessionOrigin;
-    /** Current delivery context */
-    deliveryContext?: SessionDeliveryContext;
-    /** Last channel used for delivery */
-    lastChannel?: string;
-    /** Last recipient */
-    lastTo?: string;
-    /** Last account used */
-    lastAccountId?: string;
-    /** Last thread ID */
-    lastThreadId?: string | number;
-    /** Thinking/reasoning level */
-    thinkingLevel?: string;
-    /** Verbose output level */
-    verboseLevel?: string;
-    /** Reasoning level */
-    reasoningLevel?: string;
-    /** Elevated permissions level */
-    elevatedLevel?: string;
-    /** Provider override */
-    providerOverride?: string;
-    /** Model override */
-    modelOverride?: string;
-    /** Auth profile override */
-    authProfileOverride?: string;
-    /** Source of auth profile override */
-    authProfileOverrideSource?: "auto" | "user";
-    /** Compaction count when auth profile was set */
-    authProfileOverrideCompactionCount?: number;
-    /** Input tokens consumed */
-    inputTokens?: number;
-    /** Output tokens generated */
-    outputTokens?: number;
-    /** Total tokens */
-    totalTokens?: number;
-    /** Context window tokens */
-    contextTokens?: number;
-    /** Number of compaction operations */
-    compactionCount?: number;
-    /** Model provider used */
-    modelProvider?: string;
-    /** Model identifier used */
-    model?: string;
-    /** Group activation mode (mention or always) */
-    groupActivation?: "mention" | "always";
-    /** Whether group needs system introduction */
-    groupActivationNeedsSystemIntro?: boolean;
-    /** Send policy (allow or deny responses) */
-    sendPolicy?: "allow" | "deny";
-    /** Response usage display mode */
-    responseUsage?: "on" | "off" | "tokens" | "full";
-    /** Text-to-speech auto mode */
-    ttsAuto?: "on" | "off" | "voice-only";
-    /** Execution host */
-    execHost?: string;
-    /** Execution security mode */
-    execSecurity?: string;
-    /** Execution ask mode */
-    execAsk?: string;
-    /** Execution node */
-    execNode?: string;
-    /** Timestamp when memory was last flushed */
-    memoryFlushAt?: number;
-    /** Compaction count when memory was flushed */
-    memoryFlushCompactionCount?: number;
-    /** Snapshot of active skills */
-    skillsSnapshot?: SessionSkillsSnapshot;
-    /** Last delivered heartbeat payload */
-    lastHeartbeatText?: string;
-    /** Timestamp when last heartbeat was sent */
-    lastHeartbeatSentAt?: number;
-    /** Map of CLI session identifiers */
-    cliSessionIds?: Record<string, string>;
-};
-/**
- * Session store mapping session keys to entries.
- */
-export type SessionStore = Record<string, SessionEntry>;
-/**
- * Merge a session entry with a partial update.
- *
- * @param existing - Existing session entry (or undefined for new)
- * @param patch - Partial updates to apply
- * @returns Merged session entry
- */
-export declare function mergeSessionEntry(existing: SessionEntry | undefined, patch: Partial<SessionEntry>): SessionEntry;
-/**
- * Create a new session entry with minimal required fields.
- *
- * @param overrides - Optional field overrides
- * @returns New session entry
- */
-export declare function createSessionEntry(overrides?: Partial<SessionEntry>): SessionEntry;
-/**
- * Check if a session entry is valid.
- *
- * @param entry - Entry to validate
- * @returns True if entry has required fields
- */
-export declare function isValidSessionEntry(entry: unknown): entry is SessionEntry;
-/**
- * Result of resolving a session key.
- */
-export type SessionResolution = {
-    /** The resolved session key */
-    sessionKey: string;
-    /** Whether this is a new session */
-    isNew: boolean;
-    /** The session entry */
-    entry: SessionEntry;
-};
-/**
- * Result of resolving a group session key.
- */
-export type GroupKeyResolution = {
-    /** The resolved group key */
-    key: string;
-    /** Channel identifier */
-    channel?: string;
-    /** Group/room identifier */
-    id?: string;
-    /** Chat type */
-    chatType?: SessionChatType;
-};
-/** Default trigger for resetting a session */
-export declare const DEFAULT_RESET_TRIGGER = "/new";
-/** All default reset triggers */
-export declare const DEFAULT_RESET_TRIGGERS: string[];
-/** Default idle timeout in minutes */
-export declare const DEFAULT_IDLE_MINUTES = 60;
-//# sourceMappingURL=types.d.ts.map

package/dist/sessions/types.d.ts.map

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

package/dist/settings.d.ts

@@ -1,99 +0,0 @@
-import type { Character, IAgentRuntime, OnboardingConfig, Setting, World, WorldSettings } from "./types";
-/**
- * Creates a Setting object from a configSetting object by omitting the 'value' property.
- *
- * @param {Omit<Setting, 'value'>} configSetting - The configSetting object to create the Setting from.
- * @returns {Setting} A new Setting object created from the provided configSetting object.
- */
-export declare function createSettingFromConfig(configSetting: Omit<Setting, "value">): Setting;
-/**
- * Gets the salt for the agent.
- *
- * @returns {string} The salt for the agent.
- */
-export declare function getSalt(): string;
-/**
- * Clears the salt cache - useful for tests or when environment changes
- */
-export declare function clearSaltCache(): void;
-/**
- * Common encryption function for string values
- * @param {string} value - The string value to encrypt
- * @param {string} salt - The salt to use for encryption
- * @returns {string} - The encrypted value in 'iv:encrypted' format
- */
-export declare function encryptStringValue(value: string, salt: string): string;
-/**
- * Common decryption function for string values
- * @param value - The encrypted value in 'iv:encrypted' format
- * @param salt - The salt to use for decryption
- * @returns The decrypted string value, or original value if not encrypted
- */
-export declare function decryptStringValue(value: string, salt: string): string;
-/**
- * Migrates an encrypted string from legacy v1 (AES-CBC) to v2 (AES-GCM).
- *
- * - v2 values are returned unchanged
- * - v1 values are decrypted then re-encrypted as v2
- * - non-encrypted values are returned unchanged
- */
-export declare function migrateEncryptedStringValue(value: string, salt: string): string;
-/**
- * Applies salt to the value of a setting
- * Only applies to secret settings with string values
- */
-export declare function saltSettingValue(setting: Setting, salt: string): Setting;
-/**
- * Removes salt from the value of a setting
- * Only applies to secret settings with string values
- */
-export declare function unsaltSettingValue(setting: Setting, salt: string): Setting;
-/**
- * Applies salt to all settings in a WorldSettings object
- */
-export declare function saltWorldSettings(worldSettings: WorldSettings, salt: string): WorldSettings;
-/**
- * Removes salt from all settings in a WorldSettings object
- */
-export declare function unsaltWorldSettings(worldSettings: WorldSettings, salt: string): WorldSettings;
-/**
- * Updates settings state in world metadata
- */
-export declare function updateWorldSettings(runtime: IAgentRuntime, serverId: string, worldSettings: WorldSettings): Promise<boolean>;
-/**
- * Gets settings state from world metadata
- */
-export declare function getWorldSettings(runtime: IAgentRuntime, serverId: string): Promise<WorldSettings | null>;
-/**
- * Initializes settings configuration for a server
- */
-export declare function initializeOnboarding(runtime: IAgentRuntime, world: World, config: OnboardingConfig): Promise<WorldSettings | null>;
-/**
- * Encrypts sensitive data in a Character object
- * @param {Character} character - The character object to encrypt secrets for
- * @returns {Character} - A copy of the character with encrypted secrets
- */
-export declare function encryptedCharacter(character: Character): Character;
-/**
- * Decrypts sensitive data in a Character object
- * @param {Character} character - The character object with encrypted secrets
- * @param {IAgentRuntime} runtime - The runtime information needed for salt generation
- * @returns {Character} - A copy of the character with decrypted secrets
- */
-export declare function decryptedCharacter(character: Character, _runtime: IAgentRuntime): Character;
-/**
- * Helper function to encrypt all string values in an object
- * @param {Record<string, string | number | boolean>} obj - Object with values to encrypt
- * @param {string} salt - The salt to use for encryption
- * @returns {Record<string, unknown>} - Object with encrypted values
- */
-export declare function encryptObjectValues(obj: Record<string, string | number | boolean>, salt: string): Record<string, string | number | boolean>;
-/**
- * Helper function to decrypt all string values in an object
- * @param {Record<string, string | number | boolean>} obj - Object with encrypted values
- * @param {string} salt - The salt to use for decryption
- * @returns {Record<string, unknown>} - Object with decrypted values
- */
-export declare function decryptObjectValues(obj: Record<string, string | number | boolean>, salt: string): Record<string, string | number | boolean>;
-export { decryptStringValue as decryptSecret };
-//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,KAAK,EACL,aAAa,EACd,MAAM,SAAS,CAAC;AAKjB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GACpC,OAAO,CAcT;AAoCD;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAiDhC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAsCtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAiDtE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAaxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAa1E;AA0BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,GACX,aAAa,CASf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,GACX,aAAa,CASf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAe/B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuC/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAalE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,GACtB,SAAS,CAaX;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAY3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAY3C;AAED,OAAO,EAAE,kBAAkB,IAAI,aAAa,EAAE,CAAC"}