@aniketbiswas/obsidian-mcp-server 1.0.0

package/build/utils/config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Configuration Utilities
+ * ============================================================================
+ *
+ * Configuration management for the Obsidian MCP server.
+ * Handles environment variables and default configuration values.
+ * ============================================================================
+ */
+import { ObsidianConfig } from "../types/obsidian.js";
+/**
+ * Get the Obsidian configuration from environment variables.
+ * Throws an error if the required API key is not set.
+ *
+ * @returns The complete Obsidian configuration
+ * @throws Error if OBSIDIAN_API_KEY environment variable is not set
+ */
+export declare function getConfig(): ObsidianConfig;
+/**
+ * Try to get the config without throwing.
+ * Returns null if configuration is incomplete.
+ *
+ * @returns The configuration or null if not available
+ */
+export declare function tryGetConfig(): ObsidianConfig | null;
+/**
+ * Check if the required configuration is available.
+ *
+ * @returns True if configuration is complete
+ */
+export declare function isConfigured(): boolean;
+/**
+ * Get the base URL for the Obsidian API.
+ *
+ * @param config - The configuration object
+ * @returns The base URL string
+ */
+export declare function getBaseUrl(config: ObsidianConfig): string;
+/**
+ * Configuration documentation for users
+ */
+export declare const CONFIG_DOCS: string;
+//# sourceMappingURL=config.d.ts.map

package/build/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAc9B;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAsB1C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,cAAc,GAAG,IAAI,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGzD;AAiBD;;GAEG;AACH,eAAO,MAAM,WAAW,QAsBvB,CAAC"}

package/build/utils/config.js

@@ -0,0 +1,117 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Configuration Utilities
+ * ============================================================================
+ *
+ * Configuration management for the Obsidian MCP server.
+ * Handles environment variables and default configuration values.
+ * ============================================================================
+ */
+import { DEFAULT_CONFIG, } from "../types/obsidian.js";
+/**
+ * Environment variable names for configuration
+ */
+const ENV_VARS = {
+    API_KEY: "OBSIDIAN_API_KEY",
+    HOST: "OBSIDIAN_HOST",
+    PORT: "OBSIDIAN_PORT",
+    SECURE: "OBSIDIAN_SECURE",
+    TIMEOUT: "OBSIDIAN_TIMEOUT",
+    VERIFY_SSL: "OBSIDIAN_VERIFY_SSL",
+};
+/**
+ * Get the Obsidian configuration from environment variables.
+ * Throws an error if the required API key is not set.
+ *
+ * @returns The complete Obsidian configuration
+ * @throws Error if OBSIDIAN_API_KEY environment variable is not set
+ */
+export function getConfig() {
+    const apiKey = process.env[ENV_VARS.API_KEY];
+    if (!apiKey) {
+        throw new Error(`Missing required environment variable: ${ENV_VARS.API_KEY}\n` +
+            "Please set your Obsidian Local REST API key.\n" +
+            "You can find this in Obsidian Settings > Local REST API > API Key");
+    }
+    return {
+        apiKey,
+        host: process.env[ENV_VARS.HOST] || DEFAULT_CONFIG.host,
+        port: parseInt(process.env[ENV_VARS.PORT] || String(DEFAULT_CONFIG.port), 10),
+        secure: parseBooleanEnv(ENV_VARS.SECURE, DEFAULT_CONFIG.secure),
+        timeout: parseInt(process.env[ENV_VARS.TIMEOUT] || String(DEFAULT_CONFIG.timeout), 10),
+        verifySsl: parseBooleanEnv(ENV_VARS.VERIFY_SSL, DEFAULT_CONFIG.verifySsl),
+    };
+}
+/**
+ * Try to get the config without throwing.
+ * Returns null if configuration is incomplete.
+ *
+ * @returns The configuration or null if not available
+ */
+export function tryGetConfig() {
+    try {
+        return getConfig();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if the required configuration is available.
+ *
+ * @returns True if configuration is complete
+ */
+export function isConfigured() {
+    return !!process.env[ENV_VARS.API_KEY];
+}
+/**
+ * Get the base URL for the Obsidian API.
+ *
+ * @param config - The configuration object
+ * @returns The base URL string
+ */
+export function getBaseUrl(config) {
+    const protocol = config.secure ? "https" : "http";
+    return `${protocol}://${config.host}:${config.port}`;
+}
+/**
+ * Parse a boolean from an environment variable.
+ *
+ * @param envVar - The environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns The parsed boolean value
+ */
+function parseBooleanEnv(envVar, defaultValue) {
+    const value = process.env[envVar];
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return value.toLowerCase() === "true" || value === "1";
+}
+/**
+ * Configuration documentation for users
+ */
+export const CONFIG_DOCS = `
+Obsidian MCP Server Configuration
+=================================
+
+Required Environment Variables:
+-------------------------------
+${ENV_VARS.API_KEY}     : Your Obsidian Local REST API key (REQUIRED)
+                        Find it in: Obsidian Settings > Local REST API > API Key
+
+Optional Environment Variables:
+-------------------------------
+${ENV_VARS.HOST}        : Host where Obsidian runs (default: ${DEFAULT_CONFIG.host})
+${ENV_VARS.PORT}        : REST API port (default: ${DEFAULT_CONFIG.port})
+${ENV_VARS.SECURE}      : Use HTTPS (default: ${DEFAULT_CONFIG.secure})
+${ENV_VARS.TIMEOUT}     : Request timeout in ms (default: ${DEFAULT_CONFIG.timeout})
+${ENV_VARS.VERIFY_SSL}  : Verify SSL certificates (default: ${DEFAULT_CONFIG.verifySsl})
+
+Example .env file:
+------------------
+${ENV_VARS.API_KEY}=your-api-key-here
+${ENV_VARS.HOST}=127.0.0.1
+${ENV_VARS.PORT}=27124
+`;
+//# sourceMappingURL=config.js.map

package/build/utils/config.js.map

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

package/build/utils/frontmatter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Frontmatter Utilities
+ * ============================================================================
+ *
+ * Utilities for parsing and manipulating YAML frontmatter in markdown files.
+ * Obsidian uses YAML frontmatter for note metadata.
+ * ============================================================================
+ */
+import { StandardFrontmatter } from "../types/obsidian.js";
+/**
+ * Result of parsing frontmatter from a markdown file.
+ */
+export interface ParsedFrontmatter {
+    /** Parsed frontmatter object */
+    frontmatter: Record<string, unknown>;
+    /** Content without frontmatter */
+    body: string;
+    /** Raw frontmatter string (including ---) */
+    raw: string;
+}
+/**
+ * Parse YAML frontmatter from markdown content.
+ *
+ * @param content - The full markdown content
+ * @returns Parsed frontmatter and body content
+ */
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+/**
+ * Convert a frontmatter object to YAML string with delimiters.
+ *
+ * @param frontmatter - The frontmatter object
+ * @returns YAML string with --- delimiters
+ */
+export declare function stringifyFrontmatter(frontmatter: StandardFrontmatter): string;
+/**
+ * Update frontmatter in a markdown file.
+ *
+ * @param content - Original markdown content
+ * @param updates - Frontmatter fields to update
+ * @returns Updated markdown content
+ */
+export declare function updateFrontmatter(content: string, updates: Partial<StandardFrontmatter>): string;
+/**
+ * Remove frontmatter from markdown content.
+ *
+ * @param content - Markdown content with frontmatter
+ * @returns Content without frontmatter
+ */
+export declare function removeFrontmatter(content: string): string;
+/**
+ * Extract a specific frontmatter field.
+ *
+ * @param content - Markdown content
+ * @param field - Field name to extract
+ * @returns The field value or undefined
+ */
+export declare function getFrontmatterField<T = unknown>(content: string, field: string): T | undefined;
+/**
+ * Add tags to a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param tags - Tags to add
+ * @returns Updated content
+ */
+export declare function addTags(content: string, tags: string[]): string;
+/**
+ * Remove tags from a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param tags - Tags to remove
+ * @returns Updated content
+ */
+export declare function removeTags(content: string, tags: string[]): string;
+/**
+ * Get all tags from a note (frontmatter + inline).
+ *
+ * @param content - Markdown content
+ * @returns Array of unique tags
+ */
+export declare function getAllTags(content: string): string[];
+/**
+ * Add aliases to a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param aliases - Aliases to add
+ * @returns Updated content
+ */
+export declare function addAliases(content: string, aliases: string[]): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/build/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;CACb;AAQD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA8BnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM,CAO7E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,SAAS,CAGf;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAY/D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBlE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBpD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CASrE"}

package/build/utils/frontmatter.js

@@ -0,0 +1,306 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Frontmatter Utilities
+ * ============================================================================
+ *
+ * Utilities for parsing and manipulating YAML frontmatter in markdown files.
+ * Obsidian uses YAML frontmatter for note metadata.
+ * ============================================================================
+ */
+/**
+ * Regular expression to match YAML frontmatter.
+ * Matches content between --- delimiters at the start of a file.
+ */
+const FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+/**
+ * Parse YAML frontmatter from markdown content.
+ *
+ * @param content - The full markdown content
+ * @returns Parsed frontmatter and body content
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return {
+            frontmatter: {},
+            body: content,
+            raw: "",
+        };
+    }
+    const raw = match[0];
+    const yamlContent = match[1];
+    const body = content.slice(raw.length);
+    try {
+        const frontmatter = parseYaml(yamlContent);
+        return {
+            frontmatter,
+            body,
+            raw,
+        };
+    }
+    catch {
+        // Return empty frontmatter if parsing fails
+        return {
+            frontmatter: {},
+            body: content,
+            raw: "",
+        };
+    }
+}
+/**
+ * Convert a frontmatter object to YAML string with delimiters.
+ *
+ * @param frontmatter - The frontmatter object
+ * @returns YAML string with --- delimiters
+ */
+export function stringifyFrontmatter(frontmatter) {
+    if (!frontmatter || Object.keys(frontmatter).length === 0) {
+        return "";
+    }
+    const yamlContent = stringifyYaml(frontmatter);
+    return `---\n${yamlContent}---\n`;
+}
+/**
+ * Update frontmatter in a markdown file.
+ *
+ * @param content - Original markdown content
+ * @param updates - Frontmatter fields to update
+ * @returns Updated markdown content
+ */
+export function updateFrontmatter(content, updates) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    const updatedFrontmatter = { ...frontmatter, ...updates };
+    const newFrontmatter = stringifyFrontmatter(updatedFrontmatter);
+    return newFrontmatter + body;
+}
+/**
+ * Remove frontmatter from markdown content.
+ *
+ * @param content - Markdown content with frontmatter
+ * @returns Content without frontmatter
+ */
+export function removeFrontmatter(content) {
+    return parseFrontmatter(content).body;
+}
+/**
+ * Extract a specific frontmatter field.
+ *
+ * @param content - Markdown content
+ * @param field - Field name to extract
+ * @returns The field value or undefined
+ */
+export function getFrontmatterField(content, field) {
+    const { frontmatter } = parseFrontmatter(content);
+    return frontmatter[field];
+}
+/**
+ * Add tags to a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param tags - Tags to add
+ * @returns Updated content
+ */
+export function addTags(content, tags) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    const existingTags = Array.isArray(frontmatter.tags) ? frontmatter.tags : [];
+    // Normalize tags (remove # prefix if present)
+    const normalizedTags = tags.map((tag) => (tag.startsWith("#") ? tag.slice(1) : tag));
+    // Merge and deduplicate tags
+    const allTags = [...new Set([...existingTags, ...normalizedTags])];
+    const updatedFrontmatter = { ...frontmatter, tags: allTags };
+    return stringifyFrontmatter(updatedFrontmatter) + body;
+}
+/**
+ * Remove tags from a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param tags - Tags to remove
+ * @returns Updated content
+ */
+export function removeTags(content, tags) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    if (!Array.isArray(frontmatter.tags)) {
+        return content;
+    }
+    // Normalize tags for comparison
+    const tagsToRemove = new Set(tags.map((tag) => (tag.startsWith("#") ? tag.slice(1) : tag).toLowerCase()));
+    const filteredTags = frontmatter.tags.filter((tag) => !tagsToRemove.has(tag.toLowerCase()));
+    const updatedFrontmatter = { ...frontmatter, tags: filteredTags };
+    return stringifyFrontmatter(updatedFrontmatter) + body;
+}
+/**
+ * Get all tags from a note (frontmatter + inline).
+ *
+ * @param content - Markdown content
+ * @returns Array of unique tags
+ */
+export function getAllTags(content) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    const tags = new Set();
+    // Get tags from frontmatter
+    if (Array.isArray(frontmatter.tags)) {
+        frontmatter.tags.forEach((tag) => tags.add(tag));
+    }
+    // Find inline tags (#tag format)
+    const inlineTagRegex = /#([a-zA-Z][a-zA-Z0-9_/-]*)/g;
+    let match;
+    while ((match = inlineTagRegex.exec(body)) !== null) {
+        tags.add(match[1]);
+    }
+    return Array.from(tags);
+}
+/**
+ * Add aliases to a note's frontmatter.
+ *
+ * @param content - Markdown content
+ * @param aliases - Aliases to add
+ * @returns Updated content
+ */
+export function addAliases(content, aliases) {
+    const { frontmatter, body } = parseFrontmatter(content);
+    const existingAliases = Array.isArray(frontmatter.aliases) ? frontmatter.aliases : [];
+    // Merge and deduplicate aliases
+    const allAliases = [...new Set([...existingAliases, ...aliases])];
+    const updatedFrontmatter = { ...frontmatter, aliases: allAliases };
+    return stringifyFrontmatter(updatedFrontmatter) + body;
+}
+// =============================================================================
+// Simple YAML Parser/Stringifier
+// =============================================================================
+// We implement a simple YAML parser to avoid external dependencies.
+// This handles the common frontmatter use cases in Obsidian.
+// =============================================================================
+/**
+ * Parse a simple YAML string into an object.
+ * Handles common frontmatter patterns: strings, numbers, booleans, arrays, simple objects.
+ */
+function parseYaml(yaml) {
+    const result = {};
+    const lines = yaml.split(/\r?\n/);
+    let currentKey = "";
+    let currentArray = null;
+    for (const line of lines) {
+        // Skip empty lines
+        if (!line.trim())
+            continue;
+        // Check for array item
+        if (line.match(/^\s*-\s+/)) {
+            if (currentArray !== null) {
+                const value = line.replace(/^\s*-\s+/, "").trim();
+                currentArray.push(parseYamlValue(value));
+            }
+            continue;
+        }
+        // Check for key-value pair
+        const keyMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)\s*:\s*(.*)?$/);
+        if (keyMatch) {
+            // Save previous array if any
+            if (currentArray !== null && currentKey) {
+                result[currentKey] = currentArray;
+                currentArray = null;
+            }
+            currentKey = keyMatch[1];
+            const valueStr = keyMatch[2]?.trim();
+            if (!valueStr) {
+                // Empty value might indicate start of array or nested object
+                currentArray = [];
+            }
+            else {
+                result[currentKey] = parseYamlValue(valueStr);
+                currentArray = null;
+            }
+        }
+    }
+    // Save final array if any
+    if (currentArray !== null && currentKey) {
+        result[currentKey] = currentArray;
+    }
+    return result;
+}
+/**
+ * Parse a single YAML value.
+ */
+function parseYamlValue(value) {
+    // Handle quoted strings
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Handle booleans
+    if (value.toLowerCase() === "true")
+        return true;
+    if (value.toLowerCase() === "false")
+        return false;
+    // Handle null
+    if (value.toLowerCase() === "null" || value === "~")
+        return null;
+    // Handle numbers
+    if (/^-?\d+$/.test(value))
+        return parseInt(value, 10);
+    if (/^-?\d+\.\d+$/.test(value))
+        return parseFloat(value);
+    // Handle inline arrays [item1, item2]
+    if (value.startsWith("[") && value.endsWith("]")) {
+        const inner = value.slice(1, -1);
+        if (!inner.trim())
+            return [];
+        return inner.split(",").map((item) => parseYamlValue(item.trim()));
+    }
+    // Return as string
+    return value;
+}
+/**
+ * Convert an object to YAML string.
+ */
+function stringifyYaml(obj, indent = 0) {
+    const lines = [];
+    const prefix = "  ".repeat(indent);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                lines.push(`${prefix}${key}: []`);
+            }
+            else {
+                lines.push(`${prefix}${key}:`);
+                for (const item of value) {
+                    lines.push(`${prefix}  - ${stringifyYamlValue(item)}`);
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            lines.push(`${prefix}${key}:`);
+            lines.push(stringifyYaml(value, indent + 1));
+        }
+        else {
+            lines.push(`${prefix}${key}: ${stringifyYamlValue(value)}`);
+        }
+    }
+    return lines.join("\n") + (indent === 0 ? "\n" : "");
+}
+/**
+ * Convert a single value to YAML string.
+ */
+function stringifyYamlValue(value) {
+    if (value === null)
+        return "null";
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "string") {
+        // Quote strings that need it
+        if (value.includes(":") ||
+            value.includes("#") ||
+            value.includes("\n") ||
+            value.startsWith(" ") ||
+            value.endsWith(" ") ||
+            /^[\[\]{}>|*&!%@`]/.test(value)) {
+            return `"${value.replace(/"/g, '\\"')}"`;
+        }
+        return value;
+    }
+    return String(value);
+}
+//# sourceMappingURL=frontmatter.js.map

package/build/utils/frontmatter.js.map

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

package/build/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Utilities Index
+ * ============================================================================
+ *
+ * Central export point for all utility modules.
+ * ============================================================================
+ */
+export * from "./config.js";
+export * from "./client.js";
+export * from "./frontmatter.js";
+export * from "./markdown.js";
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/build/utils/index.js

@@ -0,0 +1,13 @@
+/**
+ * ============================================================================
+ * OBSIDIAN MCP - Utilities Index
+ * ============================================================================
+ *
+ * Central export point for all utility modules.
+ * ============================================================================
+ */
+export * from "./config.js";
+export * from "./client.js";
+export * from "./frontmatter.js";
+export * from "./markdown.js";
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}