fetchpet-mcp-server 0.1.0

package/shared/server.d.ts

@@ -0,0 +1,135 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { FetchPetConfig, Claim, ClaimDetails, ClaimSubmissionData, ClaimSubmissionResult } from './types.js';
+/**
+ * Fetch Pet client interface
+ * Defines all methods for interacting with the Fetch Pet insurance portal
+ */
+export interface IFetchPetClient {
+    /**
+     * Initialize the browser and log in to Fetch Pet
+     * Must be called before using other methods
+     */
+    initialize(): Promise<void>;
+    /**
+     * Prepare a claim for submission by filling out the form
+     * Does NOT submit - just validates and returns what would be submitted
+     */
+    prepareClaimToSubmit(petName: string, invoiceDate: string, invoiceAmount: string, providerName: string, claimDescription: string, invoiceFilePath?: string, medicalRecordsPath?: string): Promise<ClaimSubmissionData>;
+    /**
+     * Actually submit a prepared claim
+     * Requires user confirmation via token from prepareClaimToSubmit
+     */
+    submitClaim(confirmationToken: string): Promise<ClaimSubmissionResult>;
+    /**
+     * Get all claims (both active and historical)
+     */
+    getClaims(): Promise<Claim[]>;
+    /**
+     * Get detailed information about a specific claim
+     * Including EOB, invoice summaries, and downloads
+     */
+    getClaimDetails(claimId: string): Promise<ClaimDetails>;
+    /**
+     * Get the current page URL
+     */
+    getCurrentUrl(): Promise<string>;
+    /**
+     * Close the browser
+     */
+    close(): Promise<void>;
+    /**
+     * Get the configuration
+     */
+    getConfig(): FetchPetConfig;
+}
+/**
+ * Fetch Pet client implementation using Playwright
+ */
+export declare class FetchPetClient implements IFetchPetClient {
+    private browser;
+    private context;
+    private page;
+    private config;
+    private isInitialized;
+    private pendingClaimData;
+    private pendingConfirmationToken;
+    private pendingTokenCreatedAt;
+    private static readonly TOKEN_EXPIRY_MS;
+    constructor(config: FetchPetConfig);
+    private ensureBrowser;
+    /**
+     * Extract claim data from active claim cards on the current page.
+     * The history tab uses extractHistoricalClaimsFromPage instead,
+     * due to a completely different DOM structure.
+     */
+    private extractClaimsFromPage;
+    initialize(): Promise<void>;
+    prepareClaimToSubmit(petName: string, invoiceDate: string, invoiceAmount: string, providerName: string, claimDescription: string, invoiceFilePath?: string, medicalRecordsPath?: string): Promise<ClaimSubmissionData>;
+    private buildClaimResult;
+    submitClaim(confirmationToken: string): Promise<ClaimSubmissionResult>;
+    getClaims(): Promise<Claim[]>;
+    /**
+     * Extract claims from the History tab's table layout.
+     * History uses .claim-number-closed, .closed-claim-price, .claims-history-title
+     * which is completely different from the Active tab's .claim-card-data-list structure.
+     */
+    private extractHistoricalClaimsFromPage;
+    /**
+     * Download a document by clicking its link, which opens a popup with a blob: iframe.
+     * Fetches the blob data from the popup and saves it to disk.
+     */
+    private downloadDocumentFromPopup;
+    getClaimDetails(claimId: string): Promise<ClaimDetails>;
+    getCurrentUrl(): Promise<string>;
+    close(): Promise<void>;
+    getConfig(): FetchPetConfig;
+}
+export type ClientFactory = () => IFetchPetClient;
+/**
+ * Callback invoked when background login fails
+ * @param error The error that caused login to fail
+ */
+export type LoginFailedCallback = (error: Error) => void;
+export interface CreateMCPServerOptions {
+    version: string;
+}
+export declare function createMCPServer(options: CreateMCPServerOptions): {
+    server: Server<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    registerHandlers: (server: Server, clientFactory?: ClientFactory) => Promise<void>;
+    cleanup: () => Promise<void>;
+    startBackgroundLogin: (onFailed?: LoginFailedCallback) => void;
+};
+//# sourceMappingURL=server.d.ts.map