@ankimcp/anki-mcp-server 0.8.0

package/dist/mcp/types/anki.types.d.ts

@@ -0,0 +1,180 @@
+export declare enum CardType {
+    New = 0,
+    Learning = 1,
+    Review = 2,
+    Relearning = 3
+}
+export interface AnkiCard {
+    cardId: number;
+    fields: Record<string, {
+        value: string;
+        order: number;
+    }>;
+    fieldOrder: number;
+    question: string;
+    answer: string;
+    modelName: string;
+    ord: number;
+    deckName: string;
+    css: string;
+    factor?: number;
+    interval?: number;
+    note: number;
+    type: number;
+    queue: number;
+    due?: number;
+    reps?: number;
+    lapses?: number;
+    left?: number;
+    mod?: number;
+    flags?: number;
+    tags?: string[];
+}
+export interface SimplifiedCard {
+    cardId: number;
+    front: string;
+    back: string;
+    deckName: string;
+    modelName: string;
+    due: number;
+    interval: number;
+    factor: number;
+}
+export interface CardPresentation {
+    cardId: number;
+    front: string;
+    back?: string;
+    deckName: string;
+    modelName: string;
+    tags: string[];
+    currentInterval: number;
+    easeFactor: number;
+    reviews: number;
+    lapses: number;
+    cardType: string;
+    noteId: number;
+}
+export interface DeckInfo {
+    name: string;
+    stats?: DeckStats;
+}
+export interface DeckStats {
+    deck_id: number;
+    name: string;
+    new_count: number;
+    learn_count: number;
+    review_count: number;
+    total_new: number;
+    total_cards: number;
+}
+export declare enum CardRating {
+    Again = 1,
+    Hard = 2,
+    Good = 3,
+    Easy = 4
+}
+export interface AnkiConnectRequest {
+    action: string;
+    version: number;
+    params?: Record<string, any>;
+    key?: string;
+}
+export interface AnkiConnectResponse<T = any> {
+    result: T;
+    error: string | null;
+}
+export interface NoteOptions {
+    allowDuplicate?: boolean;
+    duplicateScope?: "deck" | "collection";
+    duplicateScopeOptions?: {
+        deckName?: string;
+        checkChildren?: boolean;
+        checkAllModels?: boolean;
+    };
+}
+export interface AddNoteParams {
+    deckName: string;
+    modelName: string;
+    fields: Record<string, string>;
+    tags?: string[];
+    options?: NoteOptions;
+}
+export interface Model {
+    name: string;
+    id: number;
+    css: string;
+    fields: string[];
+}
+export interface NoteInfo {
+    noteId: number;
+    modelName: string;
+    tags: string[];
+    fields: Record<string, {
+        value: string;
+        order: number;
+    }>;
+    cards: number[];
+    mod: number;
+}
+export interface UpdateNoteFieldsParams {
+    note: {
+        id: number;
+        fields: Record<string, string>;
+        audio?: Array<{
+            url: string;
+            filename: string;
+            fields: string[];
+        }>;
+        picture?: Array<{
+            url: string;
+            filename: string;
+            fields: string[];
+        }>;
+    };
+}
+export interface CardTemplate {
+    Name: string;
+    Front: string;
+    Back: string;
+}
+export interface CreateModelParams {
+    modelName: string;
+    inOrderFields: string[];
+    cardTemplates: CardTemplate[];
+    css?: string;
+    isCloze?: boolean;
+}
+export interface UpdateModelStylingParams {
+    model: {
+        name: string;
+        css: string;
+    };
+}
+export interface GuiCurrentCardInfo {
+    answer: string;
+    question: string;
+    deckName: string;
+    modelName: string;
+    cardId: number;
+    buttons: number[];
+    nextReviews: string[];
+    fields?: Record<string, {
+        value: string;
+        order: number;
+    }>;
+}
+export interface GuiBrowseParams {
+    query: string;
+    reorderCards?: {
+        order: "ascending" | "descending";
+        columnId: string;
+    };
+}
+export interface GuiAddCardsParams {
+    note: {
+        deckName: string;
+        modelName: string;
+        fields: Record<string, string>;
+        tags?: string[];
+    };
+}

package/dist/mcp/types/anki.types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardRating = exports.CardType = void 0;
+var CardType;
+(function (CardType) {
+    CardType[CardType["New"] = 0] = "New";
+    CardType[CardType["Learning"] = 1] = "Learning";
+    CardType[CardType["Review"] = 2] = "Review";
+    CardType[CardType["Relearning"] = 3] = "Relearning";
+})(CardType || (exports.CardType = CardType = {}));
+var CardRating;
+(function (CardRating) {
+    CardRating[CardRating["Again"] = 1] = "Again";
+    CardRating[CardRating["Hard"] = 2] = "Hard";
+    CardRating[CardRating["Good"] = 3] = "Good";
+    CardRating[CardRating["Easy"] = 4] = "Easy";
+})(CardRating || (exports.CardRating = CardRating = {}));
+//# sourceMappingURL=anki.types.js.map

package/dist/mcp/types/anki.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anki.types.js","sourceRoot":"","sources":["../../../src/mcp/types/anki.types.ts"],"names":[],"mappings":";;;AAOA,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,qCAAO,CAAA;IACP,+CAAY,CAAA;IACZ,2CAAU,CAAA;IACV,mDAAc,CAAA;AAChB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAqFD,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6CAAS,CAAA;IACT,2CAAQ,CAAA;IACR,2CAAQ,CAAA;IACR,2CAAQ,CAAA;AACV,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}

package/dist/mcp/utils/anki.utils.d.ts

@@ -0,0 +1,19 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { AnkiCard } from "../types/anki.types";
+export declare function cleanHtml(html: string): string;
+export declare function extractCardContent(fields: AnkiCard["fields"]): {
+    front: string;
+    back: string;
+};
+export declare function getCardType(type: number): string;
+export declare function getNoteType(modelName: string): string;
+export declare function getRatingDescription(rating: number): string;
+export declare function createSuccessResponse(data: any): CallToolResult;
+export declare function createErrorResponse(error: unknown, context?: Record<string, any>): CallToolResult;
+export declare function formatInterval(days: number): string;
+export declare function parseDeckStats(stats: any): {
+    new_count: number;
+    learn_count: number;
+    review_count: number;
+    total_cards: number;
+};

package/dist/mcp/utils/anki.utils.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanHtml = cleanHtml;
+exports.extractCardContent = extractCardContent;
+exports.getCardType = getCardType;
+exports.getNoteType = getNoteType;
+exports.getRatingDescription = getRatingDescription;
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+exports.formatInterval = formatInterval;
+exports.parseDeckStats = parseDeckStats;
+const anki_types_1 = require("../types/anki.types");
+const anki_connect_client_1 = require("../clients/anki-connect.client");
+function cleanHtml(html) {
+    return html
+        .replace(/<[^>]*>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n\s*\n/g, "\n")
+        .trim();
+}
+function extractCardContent(fields) {
+    let front = "";
+    let back = "";
+    if (!fields) {
+        return { front, back };
+    }
+    const frontFieldNames = ["Front", "正面", "Question", "Text"];
+    const backFieldNames = ["Back", "背面", "Answer", "Extra", "Back Extra"];
+    for (const fieldName of frontFieldNames) {
+        if (fields[fieldName]) {
+            front = fields[fieldName].value;
+            break;
+        }
+    }
+    for (const fieldName of backFieldNames) {
+        if (fields[fieldName]) {
+            back = fields[fieldName].value;
+            break;
+        }
+    }
+    if (!front && !back) {
+        const fieldEntries = Object.entries(fields).sort((a, b) => a[1].order - b[1].order);
+        if (fieldEntries.length > 0) {
+            front = fieldEntries[0][1].value;
+        }
+        if (fieldEntries.length > 1) {
+            back = fieldEntries[1][1].value;
+        }
+    }
+    return {
+        front: cleanHtml(front),
+        back: cleanHtml(back),
+    };
+}
+function getCardType(type) {
+    switch (type) {
+        case anki_types_1.CardType.New:
+            return "new";
+        case anki_types_1.CardType.Learning:
+            return "learning";
+        case anki_types_1.CardType.Review:
+            return "review";
+        case anki_types_1.CardType.Relearning:
+            return "relearning";
+        default:
+            return "unknown";
+    }
+}
+function getNoteType(modelName) {
+    const lowerName = modelName.toLowerCase();
+    if (lowerName.includes("basic")) {
+        if (lowerName.includes("reverse")) {
+            return "Basic (and reversed card)";
+        }
+        return "Basic";
+    }
+    if (lowerName.includes("cloze")) {
+        return "Cloze";
+    }
+    return "Custom";
+}
+function getRatingDescription(rating) {
+    switch (rating) {
+        case anki_types_1.CardRating.Again:
+            return "Again (failed to recall)";
+        case anki_types_1.CardRating.Hard:
+            return "Hard (recalled with difficulty)";
+        case anki_types_1.CardRating.Good:
+            return "Good (recalled with some effort)";
+        case anki_types_1.CardRating.Easy:
+            return "Easy (recalled instantly)";
+        default:
+            return "Unknown";
+    }
+}
+function createSuccessResponse(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function createErrorResponse(error, context) {
+    const errorData = {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error occurred",
+    };
+    if (error instanceof anki_connect_client_1.AnkiConnectError) {
+        if (error.action) {
+            errorData.action = error.action;
+        }
+    }
+    if (context) {
+        Object.assign(errorData, context);
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(errorData, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+function formatInterval(days) {
+    if (days < 1) {
+        const hours = Math.round(days * 24);
+        return `${hours} hour${hours !== 1 ? "s" : ""}`;
+    }
+    if (days < 30) {
+        return `${Math.round(days)} day${days !== 1 ? "s" : ""}`;
+    }
+    if (days < 365) {
+        const months = Math.round(days / 30);
+        return `${months} month${months !== 1 ? "s" : ""}`;
+    }
+    const years = Math.round((days / 365) * 10) / 10;
+    return `${years} year${years !== 1 ? "s" : ""}`;
+}
+function parseDeckStats(stats) {
+    return {
+        new_count: stats.new_count || 0,
+        learn_count: stats.lrn_count || 0,
+        review_count: stats.rev_count || 0,
+        total_cards: stats.total || 0,
+    };
+}
+//# sourceMappingURL=anki.utils.js.map

package/dist/mcp/utils/anki.utils.js.map

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

package/dist/mcp/utils/markdown.utils.d.ts

@@ -0,0 +1,4 @@
+export interface MarkdownSections {
+    [heading: string]: string;
+}
+export declare function parseMarkdownSections(markdown: string): MarkdownSections;

package/dist/mcp/utils/markdown.utils.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMarkdownSections = parseMarkdownSections;
+const unified_1 = require("unified");
+const remark_parse_1 = __importDefault(require("remark-parse"));
+const unist_util_visit_1 = require("unist-util-visit");
+function nodeToString(node) {
+    if (node.type === "text") {
+        return node.value;
+    }
+    if (node.type === "inlineCode") {
+        return `\`${node.value}\``;
+    }
+    if ("children" in node && Array.isArray(node.children)) {
+        return node.children
+            .map((child) => nodeToString(child))
+            .join("");
+    }
+    if ("value" in node && typeof node.value === "string") {
+        return node.value;
+    }
+    return "";
+}
+function extractHeadingText(node) {
+    if ("children" in node && Array.isArray(node.children)) {
+        return node.children
+            .map((child) => nodeToString(child))
+            .join("");
+    }
+    return "";
+}
+function parseMarkdownSections(markdown) {
+    const tree = (0, unified_1.unified)().use(remark_parse_1.default).parse(markdown);
+    const sections = {};
+    let currentHeading = null;
+    let currentContent = [];
+    (0, unist_util_visit_1.visit)(tree, (node) => {
+        if (node.type === "heading" && node.depth === 1) {
+            if (currentHeading) {
+                sections[currentHeading] = currentContent.join("\n").trim();
+            }
+            currentHeading = extractHeadingText(node);
+            currentContent = [];
+        }
+        else if (currentHeading) {
+            const content = nodeToString(node);
+            if (content.trim()) {
+                currentContent.push(content.trim());
+            }
+        }
+    });
+    if (currentHeading) {
+        sections[currentHeading] = currentContent.join("\n").trim();
+    }
+    return sections;
+}
+//# sourceMappingURL=markdown.utils.js.map

package/dist/mcp/utils/markdown.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.utils.js","sourceRoot":"","sources":["../../../src/mcp/utils/markdown.utils.ts"],"names":[],"mappings":";;;;;AAsEA,sDAgCC;AAtGD,qCAAkC;AAClC,gEAAuC;AACvC,uDAAyC;AAezC,SAAS,YAAY,CAAC,IAAiB;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,QAAQ;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAoB,CAAC,CAAC;aAClD,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IACD,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAKD,SAAS,kBAAkB,CAAC,IAAiB;IAC3C,IAAI,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,QAAQ;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAoB,CAAC,CAAC;aAClD,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAyBD,SAAgB,qBAAqB,CAAC,QAAgB;IACpD,MAAM,IAAI,GAAG,IAAA,iBAAO,GAAE,CAAC,GAAG,CAAC,sBAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAS,CAAC;IAChE,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,cAAc,GAAa,EAAE,CAAC;IAElC,IAAA,wBAAK,EAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAEhD,IAAI,cAAc,EAAE,CAAC;gBACnB,QAAQ,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9D,CAAC;YAGD,cAAc,GAAG,kBAAkB,CAAC,IAAmB,CAAC,CAAC;YACzD,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;aAAM,IAAI,cAAc,EAAE,CAAC;YAE1B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAmB,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAGH,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/mcp/utils/mcpb-workarounds.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeMcpbConfigValue(value: string | undefined): string | undefined;

package/dist/mcp/utils/mcpb-workarounds.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeMcpbConfigValue = sanitizeMcpbConfigValue;
+function sanitizeMcpbConfigValue(value) {
+    if (!value || value.trim() === "") {
+        return undefined;
+    }
+    if (value.startsWith("${") && value.endsWith("}")) {
+        return undefined;
+    }
+    return value;
+}
+//# sourceMappingURL=mcpb-workarounds.js.map

package/dist/mcp/utils/mcpb-workarounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpb-workarounds.js","sourceRoot":"","sources":["../../../src/mcp/utils/mcpb-workarounds.ts"],"names":[],"mappings":";;AA0BA,0DAaC;AAbD,SAAgB,uBAAuB,CACrC,KAAyB;IAEzB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/services/ngrok.service.d.ts

@@ -0,0 +1,15 @@
+export interface NgrokTunnelInfo {
+    publicUrl: string;
+    apiUrl: string;
+}
+export declare class NgrokService {
+    private process;
+    private cleanupHandlersRegistered;
+    start(port: number): Promise<NgrokTunnelInfo>;
+    private isNgrokInstalled;
+    private waitForNgrok;
+    private getTunnelUrl;
+    private registerCleanupHandlers;
+    private cleanup;
+    getWebInterfaceUrl(): string;
+}

package/dist/services/ngrok.service.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NgrokService = void 0;
+const child_process_1 = require("child_process");
+const http_1 = __importDefault(require("http"));
+class NgrokService {
+    process = null;
+    cleanupHandlersRegistered = false;
+    async start(port) {
+        if (!(await this.isNgrokInstalled())) {
+            throw new Error("ngrok is not installed.\n" +
+                "Install it with: npm install -g ngrok\n" +
+                "Or download from: https://ngrok.com/download\n" +
+                "Then setup auth: ngrok config add-authtoken <your-token>");
+        }
+        this.process = (0, child_process_1.spawn)("ngrok", ["http", port.toString()], {
+            stdio: "pipe",
+        });
+        if (!this.cleanupHandlersRegistered) {
+            this.registerCleanupHandlers();
+            this.cleanupHandlersRegistered = true;
+        }
+        this.process.on("error", (err) => {
+            throw new Error(`Failed to start ngrok: ${err.message}`);
+        });
+        this.process.on("exit", (code, _signal) => {
+            if (code !== 0 && code !== null) {
+                console.error(`ngrok exited with code ${code}`);
+            }
+        });
+        await this.waitForNgrok();
+        const publicUrl = await this.getTunnelUrl();
+        return {
+            publicUrl,
+            apiUrl: "http://localhost:4040",
+        };
+    }
+    async isNgrokInstalled() {
+        return new Promise((resolve) => {
+            const check = (0, child_process_1.spawn)("which", ["ngrok"]);
+            check.on("close", (code) => resolve(code === 0));
+            check.on("error", () => resolve(false));
+        });
+    }
+    async waitForNgrok(maxAttempts = 20, delayMs = 500) {
+        for (let i = 0; i < maxAttempts; i++) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+            try {
+                await this.getTunnelUrl();
+                return;
+            }
+            catch {
+            }
+        }
+        throw new Error("ngrok failed to start in time.\n" +
+            "Make sure you have configured your auth token:\n" +
+            "ngrok config add-authtoken <your-token>");
+    }
+    async getTunnelUrl() {
+        return new Promise((resolve, reject) => {
+            http_1.default
+                .get("http://localhost:4040/api/tunnels", (res) => {
+                let data = "";
+                res.on("data", (chunk) => (data += chunk));
+                res.on("end", () => {
+                    try {
+                        const response = JSON.parse(data);
+                        const tunnel = response.tunnels?.find((t) => t.proto === "https");
+                        const publicUrl = tunnel?.public_url;
+                        if (publicUrl) {
+                            resolve(publicUrl);
+                        }
+                        else {
+                            reject(new Error("No HTTPS tunnel found in ngrok API response"));
+                        }
+                    }
+                    catch (err) {
+                        reject(new Error(`Failed to parse ngrok API response: ${err}`));
+                    }
+                });
+            })
+                .on("error", (err) => {
+                reject(new Error(`Failed to connect to ngrok API: ${err.message}`));
+            });
+        });
+    }
+    registerCleanupHandlers() {
+        process.on("SIGINT", () => {
+            console.log("\n\n🛑 Shutting down ngrok tunnel...");
+            this.cleanup();
+            process.exit(0);
+        });
+        process.on("SIGTERM", () => {
+            this.cleanup();
+            process.exit(0);
+        });
+        process.on("exit", () => {
+            this.cleanup();
+        });
+        process.on("uncaughtException", (err) => {
+            console.error("Uncaught exception:", err);
+            this.cleanup();
+            process.exit(1);
+        });
+    }
+    cleanup() {
+        if (this.process && !this.process.killed) {
+            this.process.kill("SIGTERM");
+            this.process = null;
+        }
+    }
+    getWebInterfaceUrl() {
+        return "http://localhost:4040";
+    }
+}
+exports.NgrokService = NgrokService;
+//# sourceMappingURL=ngrok.service.js.map

package/dist/services/ngrok.service.js.map

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