@mjquinlan2000/practicepanther-mcp 0.1.3 → 0.1.5

package/README.md

@@ -1,42 +1,42 @@
 # @mjquinlan2000/practicepanther-mcp
 
-MCP server for the [PracticePanther](https://www.practicepanther.com/) legal practice management API. Exposes PracticePanther's REST API as MCP tools so AI assistants (Claude Desktop, etc.) can read data from PracticePanther accounts.
+MCP server for the [PracticePanther](https://www.practicepanther.com/) legal practice management API. Exposes PracticePanther's REST API as read-only MCP tools so AI assistants (Claude Desktop, etc.) can read data from PracticePanther accounts.
 
-## Installation
+## Quick Start
 
 ```sh
-npm install @mjquinlan2000/practicepanther-mcp
-# or run directly
-npx @mjquinlan2000/practicepanther-mcp
+PP_ACCESS_TOKEN=your_token npx @mjquinlan2000/practicepanther-mcp
 ```
 
-## Setup
+## Authentication
 
-### 1. Obtain API credentials
+### Option 1: Access token (simplest)
 
-Register an OAuth2 application in PracticePanther to get a client ID and secret.
+If you already have a PracticePanther access token, set it as an environment variable:
 
-### 2. Set environment variables
+```sh
+export PP_ACCESS_TOKEN=your_token
+```
+
+### Option 2: OAuth flow
+
+If you have OAuth2 client credentials, you can use the built-in auth CLI to obtain tokens:
 
 ```sh
 export PP_CLIENT_ID=your_client_id
 export PP_CLIENT_SECRET=your_client_secret
 export PP_REDIRECT_URI=http://127.0.0.1:8080/callback
-```
 
-### 3. Authenticate
-
-```sh
-# Initial OAuth2 authorization (opens browser)
-yarn auth
+# Opens a browser for OAuth2 authorization
+npx @mjquinlan2000/practicepanther-mcp auth
 
 # Refresh an expired token
-yarn auth:refresh
+npx @mjquinlan2000/practicepanther-mcp auth refresh
 ```
 
-Tokens are persisted to `~/.config/practicepanther-mcp/tokens.json` and auto-refresh when the server runs.
+Tokens are saved to `~/.config/practicepanther-mcp/tokens` (encrypted). See [Token Encryption](../README.md#token-encryption) for setup.
 
-Alternatively, set `PP_ACCESS_TOKEN` directly to skip the OAuth flow.
+Tokens are automatically refreshed when they near expiration, as long as `PP_CLIENT_ID` and `PP_CLIENT_SECRET` are available.
 
 ## MCP Client Configuration
 
@@ -49,25 +49,8 @@ Add to your MCP client config (e.g. Claude Desktop `claude_desktop_config.json`)
       "command": "npx",
       "args": ["@mjquinlan2000/practicepanther-mcp"],
       "env": {
-        "PP_CLIENT_ID": "your_client_id",
-        "PP_CLIENT_SECRET": "your_client_secret"
-      }
-    }
-  }
-}
-```
-
-For local development with `tsx`:
-
-```json
-{
-  "mcpServers": {
-    "practicepanther": {
-      "command": "tsx",
-      "args": ["src/server.ts"],
-      "env": {
-        "PP_CLIENT_ID": "${PP_CLIENT_ID}",
-        "PP_CLIENT_SECRET": "${PP_CLIENT_SECRET}"
+        "PP_ACCESS_TOKEN": "your_token",
+        "NODE_MCP_SECRET_KEY": "your_64_char_hex_key"
       }
     }
   }
@@ -76,7 +59,7 @@ For local development with `tsx`:
 
 ## Available Tools
 
-The server registers tools for the following PracticePanther entities. Each entity has a `get_<entity>` (by ID) and `list_<entities>` tool unless noted otherwise.
+The server registers read-only tools for the following PracticePanther entities. Each entity has a `get_<entity>` (by ID) and `list_<entities>` tool unless noted otherwise.
 
 | Entity | Tools |
 |--------|-------|
@@ -103,28 +86,53 @@ The server registers tools for the following PracticePanther entities. Each enti
 | Time Entries | `get_time_entry`, `list_time_entries` |
 | Users | `get_me`, `get_user`, `list_users` |
 
-## Development
+## Local Development
 
 ```sh
-yarn start          # Run server locally (stdio transport)
-yarn build          # Bundle with tsup
-yarn typecheck      # Type-check with tsc --noEmit
-yarn spec:generate  # Fetch Swagger spec, convert to OpenAPI 3, regenerate typed client
+git clone https://github.com/mjquinlan2000/node-mcps.git
+cd node-mcps
+yarn install
+yarn build
+
+# Run the server locally
+yarn workspace @mjquinlan2000/practicepanther-mcp start
+
+# Run tests
+yarn workspace @mjquinlan2000/practicepanther-mcp test
+yarn workspace @mjquinlan2000/practicepanther-mcp test:watch
+
+# Regenerate typed client from API spec
+yarn workspace @mjquinlan2000/practicepanther-mcp spec:generate
+```
+
+For local dev with an MCP client, use `tsx` directly:
+
+```json
+{
+  "mcpServers": {
+    "practicepanther": {
+      "command": "tsx",
+      "args": ["/path/to/node-mcps/practicepanther-mcp/src/server.ts"],
+      "env": {
+        "PP_ACCESS_TOKEN": "your_token",
+        "NODE_MCP_SECRET_KEY": "your_64_char_hex_key"
+      }
+    }
+  }
+}
 ```
 
 ## Project Structure
 
 ```
 src/
-├── server.ts       # MCP server entry point — registers all tools
-├── schemas.ts      # Zod schemas for shaping API responses
-├── auth.ts         # OAuth2 config (delegates to shared oauth utility)
-├── pp.ts           # Configures generated HTTP client with base URL + auth
-└── client/         # Auto-generated typed API client (do not edit)
+├── server.ts              # Entry point — CLI dispatch (server vs auth)
+├── create-server.ts       # MCP server setup — registers all tools
+├── tool-handler.ts        # Generic tool handler factory
+├── helpers.ts             # Utility functions
+├── auth.ts                # OAuth2 config (delegates to shared oauth utility)
+├── pp.ts                  # Configures generated HTTP client with base URL + auth
+├── client/                # Auto-generated typed API client (do not edit)
+├── *.test.ts              # Tests
+└── ...
 ```
-
-## Adding a New Entity
-
-1. Import the SDK functions from `./client/index.js`
-2. Define a Zod schema in `schemas.ts`
-3. Register `get_` and `list_` tools in `server.ts`

package/dist/auth.js

@@ -1,7 +1,7 @@
 import {
   getAccessToken,
   runCli
-} from "./chunk-36GM5B5H.js";
+} from "./chunk-CNXDFCLN.js";
 export {
   getAccessToken,
   runCli

package/dist/{chunk-36GM5B5H.js → chunk-CNXDFCLN.js}

@@ -1,7 +1,7 @@
 // ../shared/dist/oauth.js
 import { execSync } from "child_process";
-import { randomBytes } from "crypto";
-import { mkdir, readFile, writeFile } from "fs/promises";
+import { createCipheriv, createDecipheriv, randomBytes } from "crypto";
+import { mkdir, readFile, unlink, writeFile } from "fs/promises";
 import { createServer } from "http";
 import { homedir } from "os";
 import { join } from "path";
@@ -10,18 +10,58 @@ function isRefreshable(tokens) {
 }
 function createAuth(config) {
   const configDir = join(process.env.MCP_CONFIG_DIR ?? join(homedir(), ".config"), config.name);
-  const tokensPath = join(configDir, "tokens.json");
+  const legacyTokensPath = join(configDir, "tokens.json");
+  const encryptedTokensPath = join(configDir, "tokens");
+  function getEncryptionKey() {
+    const key = process.env.NODE_MCP_SECRET_KEY;
+    if (!key) {
+      throw new Error("NODE_MCP_SECRET_KEY environment variable is required. Generate one with: openssl rand -hex 32");
+    }
+    const buf = Buffer.from(key, "hex");
+    if (buf.length !== 32) {
+      throw new Error("NODE_MCP_SECRET_KEY must be a 64-character hex string (32 bytes). Generate one with: openssl rand -hex 32");
+    }
+    return buf;
+  }
+  function encrypt(plaintext) {
+    const key = getEncryptionKey();
+    const iv = randomBytes(12);
+    const cipher = createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([
+      cipher.update(plaintext, "utf-8"),
+      cipher.final()
+    ]);
+    const authTag = cipher.getAuthTag();
+    return Buffer.concat([iv, authTag, encrypted]);
+  }
+  function decrypt(data) {
+    const key = getEncryptionKey();
+    const iv = data.subarray(0, 12);
+    const authTag = data.subarray(12, 28);
+    const ciphertext = data.subarray(28);
+    const decipher = createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(authTag);
+    return decipher.update(ciphertext, void 0, "utf-8") + decipher.final("utf-8");
+  }
   async function readTokens() {
     try {
-      const data = await readFile(tokensPath, "utf-8");
-      return JSON.parse(data);
+      const data = await readFile(encryptedTokensPath);
+      return JSON.parse(decrypt(data));
     } catch {
-      return null;
+      try {
+        const data = await readFile(legacyTokensPath, "utf-8");
+        const tokens = JSON.parse(data);
+        await writeTokens(tokens);
+        await unlink(legacyTokensPath);
+        return tokens;
+      } catch {
+        return null;
+      }
     }
   }
   async function writeTokens(tokens) {
     await mkdir(configDir, { recursive: true });
-    await writeFile(tokensPath, JSON.stringify(tokens, null, 2), {
+    await writeFile(encryptedTokensPath, encrypt(JSON.stringify(tokens)), {
       mode: 384
     });
   }
@@ -33,16 +73,25 @@ function createAuth(config) {
     }
   }
   async function exchangeCode(code, redirectUri, clientId, clientSecret) {
+    const useBasic = config.tokenAuthMethod === "basic";
+    const headers = {
+      "Content-Type": "application/x-www-form-urlencoded"
+    };
+    const bodyParams = {
+      grant_type: "authorization_code",
+      code,
+      redirect_uri: redirectUri
+    };
+    if (useBasic) {
+      headers.Authorization = `Basic ${btoa(`${clientId}:${clientSecret}`)}`;
+    } else {
+      bodyParams.client_id = clientId;
+      bodyParams.client_secret = clientSecret;
+    }
     const res = await fetch(config.tokenUrl, {
       method: "POST",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" },
-      body: new URLSearchParams({
-        grant_type: "authorization_code",
-        code,
-        redirect_uri: redirectUri,
-        client_id: clientId,
-        client_secret: clientSecret
-      })
+      headers,
+      body: new URLSearchParams(bodyParams)
     });
     if (!res.ok) {
       const text = await res.text();
@@ -60,15 +109,24 @@ function createAuth(config) {
     return { access_token: data.access_token };
   }
   async function refreshAccessToken(refreshToken, clientId, clientSecret) {
+    const useBasic = config.tokenAuthMethod === "basic";
+    const headers = {
+      "Content-Type": "application/x-www-form-urlencoded"
+    };
+    const bodyParams = {
+      grant_type: "refresh_token",
+      refresh_token: refreshToken
+    };
+    if (useBasic) {
+      headers.Authorization = `Basic ${btoa(`${clientId}:${clientSecret}`)}`;
+    } else {
+      bodyParams.client_id = clientId;
+      bodyParams.client_secret = clientSecret;
+    }
     const res = await fetch(config.tokenUrl, {
       method: "POST",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" },
-      body: new URLSearchParams({
-        grant_type: "refresh_token",
-        refresh_token: refreshToken,
-        client_id: clientId,
-        client_secret: clientSecret
-      })
+      headers,
+      body: new URLSearchParams(bodyParams)
     });
     if (!res.ok) {
       throw new Error("Run 'yarn auth' to re-authenticate.");
@@ -184,7 +242,7 @@ ${authorizeUrl}
       });
     });
     await writeTokens(tokens);
-    console.log(`Tokens saved to ${tokensPath}`);
+    console.log(`Tokens saved to ${encryptedTokensPath}`);
   }
   async function refresh() {
     const clientId = process.env[`${config.envPrefix}_CLIENT_ID`];
@@ -199,7 +257,7 @@ ${authorizeUrl}
     }
     const refreshed = await refreshAccessToken(tokens.refresh_token, clientId, clientSecret);
     await writeTokens(refreshed);
-    console.log(`Tokens refreshed and saved to ${tokensPath}`);
+    console.log(`Tokens refreshed and saved to ${encryptedTokensPath}`);
   }
   function runCli2(command) {
     const cmd = command ?? process.argv[2];
@@ -234,4 +292,4 @@ export {
   getAccessToken,
   runCli
 };
-//# sourceMappingURL=chunk-36GM5B5H.js.map
+//# sourceMappingURL=chunk-CNXDFCLN.js.map

package/dist/chunk-CNXDFCLN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../shared/src/oauth.ts","../src/auth.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { createCipheriv, createDecipheriv, randomBytes } from \"node:crypto\";\nimport { mkdir, readFile, unlink, writeFile } from \"node:fs/promises\";\nimport {\n  createServer,\n  type IncomingMessage,\n  type ServerResponse,\n} from \"node:http\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface OAuthConfig {\n  name: string;\n  authorizeUrl: string;\n  tokenUrl: string;\n  envPrefix: string;\n  scope?: string;\n  supportsRefresh: boolean;\n  tokenAuthMethod?: \"body\" | \"basic\";\n}\n\ninterface BaseTokens {\n  access_token: string;\n}\n\ninterface RefreshableTokens extends BaseTokens {\n  refresh_token: string;\n  expires_at: number;\n}\n\ntype StoredTokens = BaseTokens | RefreshableTokens;\n\nfunction isRefreshable(tokens: StoredTokens): tokens is RefreshableTokens {\n  return \"refresh_token\" in tokens;\n}\n\ninterface RefreshableTokenResponse {\n  access_token: string;\n  refresh_token: string;\n  expires_in: number;\n}\n\nexport function createAuth(config: OAuthConfig): {\n  getAccessToken: () => Promise<string>;\n  runCli: (command?: string) => void;\n} {\n  const configDir = join(\n    process.env.MCP_CONFIG_DIR ?? join(homedir(), \".config\"),\n    config.name,\n  );\n  const legacyTokensPath = join(configDir, \"tokens.json\");\n  const encryptedTokensPath = join(configDir, \"tokens\");\n\n  function getEncryptionKey(): Buffer {\n    const key = process.env.NODE_MCP_SECRET_KEY;\n    if (!key) {\n      throw new Error(\n        \"NODE_MCP_SECRET_KEY environment variable is required. \" +\n          \"Generate one with: openssl rand -hex 32\",\n      );\n    }\n    const buf = Buffer.from(key, \"hex\");\n    if (buf.length !== 32) {\n      throw new Error(\n        \"NODE_MCP_SECRET_KEY must be a 64-character hex string (32 bytes). \" +\n          \"Generate one with: openssl rand -hex 32\",\n      );\n    }\n    return buf;\n  }\n\n  function encrypt(plaintext: string): Buffer {\n    const key = getEncryptionKey();\n    const iv = randomBytes(12);\n    const cipher = createCipheriv(\"aes-256-gcm\", key, iv);\n    const encrypted = Buffer.concat([\n      cipher.update(plaintext, \"utf-8\"),\n      cipher.final(),\n    ]);\n    const authTag = cipher.getAuthTag();\n    return Buffer.concat([iv, authTag, encrypted]);\n  }\n\n  function decrypt(data: Buffer): string {\n    const key = getEncryptionKey();\n    const iv = data.subarray(0, 12);\n    const authTag = data.subarray(12, 28);\n    const ciphertext = data.subarray(28);\n    const decipher = createDecipheriv(\"aes-256-gcm\", key, iv);\n    decipher.setAuthTag(authTag);\n    return (\n      decipher.update(ciphertext, undefined, \"utf-8\") + decipher.final(\"utf-8\")\n    );\n  }\n\n  async function readTokens(): Promise<StoredTokens | null> {\n    try {\n      const data = await readFile(encryptedTokensPath);\n      return JSON.parse(decrypt(data)) as StoredTokens;\n    } catch {\n      // Fall back to legacy plaintext tokens.json\n      try {\n        const data = await readFile(legacyTokensPath, \"utf-8\");\n        const tokens = JSON.parse(data) as StoredTokens;\n        await writeTokens(tokens);\n        await unlink(legacyTokensPath);\n        return tokens;\n      } catch {\n        return null;\n      }\n    }\n  }\n\n  async function writeTokens(tokens: StoredTokens): Promise<void> {\n    await mkdir(configDir, { recursive: true });\n    await writeFile(encryptedTokensPath, encrypt(JSON.stringify(tokens)), {\n      mode: 0o600,\n    });\n  }\n\n  function openBrowser(url: string): void {\n    const cmd =\n      process.platform === \"darwin\"\n        ? \"open\"\n        : process.platform === \"win32\"\n          ? \"start\"\n          : \"xdg-open\";\n    try {\n      execSync(`${cmd} '${url}'`, { stdio: \"ignore\" });\n    } catch {\n      // No browser available (e.g. headless server) — URL is already printed to console\n    }\n  }\n\n  async function exchangeCode(\n    code: string,\n    redirectUri: string,\n    clientId: string,\n    clientSecret: string,\n  ): Promise<StoredTokens> {\n    const useBasic = config.tokenAuthMethod === \"basic\";\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/x-www-form-urlencoded\",\n    };\n    const bodyParams: Record<string, string> = {\n      grant_type: \"authorization_code\",\n      code,\n      redirect_uri: redirectUri,\n    };\n    if (useBasic) {\n      headers.Authorization = `Basic ${btoa(`${clientId}:${clientSecret}`)}`;\n    } else {\n      bodyParams.client_id = clientId;\n      bodyParams.client_secret = clientSecret;\n    }\n    const res = await fetch(config.tokenUrl, {\n      method: \"POST\",\n      headers,\n      body: new URLSearchParams(bodyParams),\n    });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`Token exchange failed (${res.status}): ${text}`);\n    }\n    if (config.supportsRefresh) {\n      const data = (await res.json()) as RefreshableTokenResponse;\n      return {\n        access_token: data.access_token,\n        refresh_token: data.refresh_token,\n        expires_at: Date.now() + data.expires_in * 1000,\n      };\n    }\n    const data = (await res.json()) as { access_token: string };\n    return { access_token: data.access_token };\n  }\n\n  async function refreshAccessToken(\n    refreshToken: string,\n    clientId: string,\n    clientSecret: string,\n  ): Promise<RefreshableTokens> {\n    const useBasic = config.tokenAuthMethod === \"basic\";\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/x-www-form-urlencoded\",\n    };\n    const bodyParams: Record<string, string> = {\n      grant_type: \"refresh_token\",\n      refresh_token: refreshToken,\n    };\n    if (useBasic) {\n      headers.Authorization = `Basic ${btoa(`${clientId}:${clientSecret}`)}`;\n    } else {\n      bodyParams.client_id = clientId;\n      bodyParams.client_secret = clientSecret;\n    }\n    const res = await fetch(config.tokenUrl, {\n      method: \"POST\",\n      headers,\n      body: new URLSearchParams(bodyParams),\n    });\n    if (!res.ok) {\n      throw new Error(\"Run 'yarn auth' to re-authenticate.\");\n    }\n    const data = (await res.json()) as RefreshableTokenResponse;\n    return {\n      access_token: data.access_token,\n      refresh_token: data.refresh_token,\n      expires_at: Date.now() + data.expires_in * 1000,\n    };\n  }\n\n  async function getAccessToken(): Promise<string> {\n    const envToken = process.env[`${config.envPrefix}_ACCESS_TOKEN`];\n    if (envToken) return envToken;\n\n    const tokens = await readTokens();\n    if (!tokens) {\n      throw new Error(\n        `No access token available. Set ${config.envPrefix}_ACCESS_TOKEN or run 'yarn auth'.`,\n      );\n    }\n\n    if (config.supportsRefresh && isRefreshable(tokens)) {\n      const fiveMinutes = 5 * 60 * 1000;\n      if (tokens.expires_at - Date.now() < fiveMinutes) {\n        const clientId = process.env[`${config.envPrefix}_CLIENT_ID`];\n        const clientSecret = process.env[`${config.envPrefix}_CLIENT_SECRET`];\n        if (!clientId || !clientSecret) {\n          throw new Error(\n            `Token is expiring and ${config.envPrefix}_CLIENT_ID/${config.envPrefix}_CLIENT_SECRET are not set for refresh. Run 'yarn auth'.`,\n          );\n        }\n        const refreshed = await refreshAccessToken(\n          tokens.refresh_token,\n          clientId,\n          clientSecret,\n        );\n        await writeTokens(refreshed);\n        return refreshed.access_token;\n      }\n    }\n\n    return tokens.access_token;\n  }\n\n  async function authorize(): Promise<void> {\n    const clientId = process.env[`${config.envPrefix}_CLIENT_ID`];\n    const clientSecret = process.env[`${config.envPrefix}_CLIENT_SECRET`];\n    if (!clientId)\n      throw new Error(\n        `${config.envPrefix}_CLIENT_ID environment variable is required.`,\n      );\n    if (!clientSecret)\n      throw new Error(\n        `${config.envPrefix}_CLIENT_SECRET environment variable is required.`,\n      );\n\n    const redirectUri = process.env[`${config.envPrefix}_REDIRECT_URI`];\n    if (!redirectUri)\n      throw new Error(\n        `${config.envPrefix}_REDIRECT_URI environment variable is required.`,\n      );\n\n    const redirectUrl = new URL(redirectUri);\n    const port =\n      Number(redirectUrl.port) ||\n      (redirectUrl.protocol === \"https:\" ? 443 : 80);\n    const callbackPath = redirectUrl.pathname;\n    const state = randomBytes(16).toString(\"hex\");\n\n    const { tokens } = await new Promise<{\n      tokens: StoredTokens;\n    }>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        server.close();\n        reject(new Error(\"Authorization timed out after 120 seconds.\"));\n      }, 120_000);\n\n      const server = createServer(\n        async (req: IncomingMessage, res: ServerResponse) => {\n          const url = new URL(req.url ?? \"/\", `http://${req.headers.host}`);\n          if (url.pathname !== callbackPath) {\n            res.writeHead(404);\n            res.end(\"Not found\");\n            return;\n          }\n\n          const returnedState = url.searchParams.get(\"state\");\n          const code = url.searchParams.get(\"code\");\n          const error = url.searchParams.get(\"error\");\n\n          if (error) {\n            res.writeHead(400);\n            res.end(`Authorization error: ${error}`);\n            clearTimeout(timeout);\n            server.close();\n            reject(new Error(`Authorization denied: ${error}`));\n            return;\n          }\n\n          if (returnedState !== state) {\n            res.writeHead(400);\n            res.end(\"State mismatch — possible CSRF attack.\");\n            return;\n          }\n\n          if (!code) {\n            res.writeHead(400);\n            res.end(\"Missing authorization code.\");\n            return;\n          }\n\n          try {\n            const exchangedTokens = await exchangeCode(\n              code,\n              redirectUri,\n              clientId,\n              clientSecret,\n            );\n            res.writeHead(200, { \"Content-Type\": \"text/html\" });\n            res.end(\n              \"<h1>Authorization successful!</h1><p>You can close this tab.</p>\",\n            );\n            clearTimeout(timeout);\n            server.close();\n            resolve({ tokens: exchangedTokens });\n          } catch (err) {\n            res.writeHead(500);\n            res.end(\"Token exchange failed.\");\n            clearTimeout(timeout);\n            server.close();\n            reject(err);\n          }\n        },\n      );\n\n      const params: Record<string, string> = {\n        response_type: \"code\",\n        client_id: clientId,\n        redirect_uri: redirectUri,\n        state,\n      };\n      if (config.scope) {\n        params.scope = config.scope;\n      }\n\n      server.listen(port, \"127.0.0.1\", () => {\n        const authorizeUrl = `${config.authorizeUrl}?${new URLSearchParams(params)}`;\n\n        console.log(\"Opening browser for authorization...\");\n        console.log(`If the browser doesn't open, visit:\\n${authorizeUrl}\\n`);\n        openBrowser(authorizeUrl);\n      });\n    });\n\n    await writeTokens(tokens);\n    console.log(`Tokens saved to ${encryptedTokensPath}`);\n  }\n\n  async function refresh(): Promise<void> {\n    const clientId = process.env[`${config.envPrefix}_CLIENT_ID`];\n    const clientSecret = process.env[`${config.envPrefix}_CLIENT_SECRET`];\n    if (!clientId)\n      throw new Error(\n        `${config.envPrefix}_CLIENT_ID environment variable is required.`,\n      );\n    if (!clientSecret)\n      throw new Error(\n        `${config.envPrefix}_CLIENT_SECRET environment variable is required.`,\n      );\n\n    const tokens = await readTokens();\n    if (!tokens || !isRefreshable(tokens)) {\n      throw new Error(\n        \"No tokens found. Run 'yarn auth' first to authenticate.\",\n      );\n    }\n\n    const refreshed = await refreshAccessToken(\n      tokens.refresh_token,\n      clientId,\n      clientSecret,\n    );\n    await writeTokens(refreshed);\n    console.log(`Tokens refreshed and saved to ${encryptedTokensPath}`);\n  }\n\n  function runCli(command?: string): void {\n    const cmd = command ?? process.argv[2];\n    let run: () => Promise<void>;\n    if (cmd === \"refresh\" && config.supportsRefresh) {\n      run = refresh;\n    } else {\n      run = authorize;\n    }\n    run().catch((err) => {\n      console.error(err.message ?? err);\n      process.exit(1);\n    });\n  }\n\n  return { getAccessToken, runCli };\n}\n","import { createAuth } from \"@mjquinlan2000/shared/oauth.js\";\n\nconst { getAccessToken, runCli } = createAuth({\n  name: \"practicepanther-mcp\",\n  authorizeUrl: \"https://app.practicepanther.com/OAuth/Authorize\",\n  tokenUrl: \"https://app.practicepanther.com/OAuth/Token\",\n  envPrefix: \"PP\",\n  scope: \"full\",\n  supportsRefresh: true,\n});\n\nexport { getAccessToken, runCli };\n\nif (process.argv[1] && import.meta.filename === process.argv[1]) {\n  runCli();\n}\n"],"mappings":"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","names":["data","getAccessToken","runCli"]}