lemonsqueezy-mcp-server 1.0.0

package/ENV_EXAMPLE.md

@@ -0,0 +1,83 @@
+# Environment Variables Example
+
+Create a `.env` file in the project root with the following variables:
+
+```bash
+# Lemon Squeezy API Keys
+# Get your API keys from: https://app.lemonsqueezy.com/settings/api
+#
+# For testing (recommended to start):
+LEMONSQUEEZY_TEST_API_KEY=your_test_api_key_here
+#
+# For production (use when ready):
+# LEMONSQUEEZY_API_KEY=your_production_api_key_here
+#
+# Note: If both are set, production key takes priority
+
+# Salesforce Integration (Optional - Bonus Feature)
+# Get your credentials from: https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm
+#
+# Option 1: AWS Secrets Manager (Recommended for Production)
+# Store your Salesforce credentials in AWS Secrets Manager as a JSON secret:
+# {
+#   "username": "your_salesforce_username@example.com",
+#   "password": "your_salesforce_password",
+#   "securityToken": "your_security_token"
+# }
+# Or for JWT authentication:
+# {
+#   "client_id": "your_connected_app_client_id",
+#   "username": "your_username@example.com",
+#   "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
+# }
+# Or as plain text key=value pairs:
+# username=your_salesforce_username@example.com
+# password=your_salesforce_password
+# securityToken=your_security_token
+#
+# Example configuration:
+# AWS_SALESFORCE_SECRET_NAME=your-project/salesforce-credentials
+# AWS_REGION=us-west-2  # Your AWS region (us-east-1, us-west-2, eu-west-1, etc.)
+#
+# SECURITY BEST PRACTICE: Do NOT set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY here.
+# Instead, use AWS CLI to configure credentials: `aws configure`
+# This stores credentials securely in ~/.aws/credentials (encrypted by OS).
+# See README.md for full instructions.
+#
+# Note: Use your own secret name and region. The secret name should match
+# exactly what you created in AWS Secrets Manager.
+#
+# Option 2: Environment Variables (For Local Development)
+# SALESFORCE_USERNAME=your_salesforce_username@example.com
+# SALESFORCE_PASSWORD=your_salesforce_password
+# SALESFORCE_TOKEN=your_security_token
+#
+# Optional: Custom login URL (defaults to https://login.salesforce.com)
+# SALESFORCE_LOGIN_URL=https://login.salesforce.com
+#
+# Note: Salesforce integration is optional. The server works perfectly without it.
+# If AWS_SALESFORCE_SECRET_NAME is set, it will use AWS Secrets Manager.
+# Otherwise, it falls back to environment variables.
+
+# Proactive Context (Optional - Advanced Feature)
+# Enable Resources capability for proactive AI context
+#
+# ENABLE_RESOURCES=true
+# POLL_FAILED_PAYMENTS=true
+# POLL_INTERVAL_MINUTES=5
+# WEBHOOK_LOG_PATH=/path/to/webhook.log
+
+# Webhook Listener (Sprint 2 - Event Engine)
+# Real-time webhook processing replaces file watching
+#
+# WEBHOOK_PORT=3000
+# LEMONSQUEEZY_WEBHOOK_SECRET=your_webhook_signing_secret_here
+# ENABLE_NGROK=true
+#
+# Note: If ENABLE_NGROK=true, ngrok will create a public tunnel.
+# The public URL will be logged on startup - use it to configure your Lemon Squeezy webhook.
+```
+
+**Note:** Copy this content to a `.env` file (not `.env.example`) for local development. The `.env` file is already in `.gitignore` and won't be committed.
+
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# Lemon Squeezy MCP Server
+
+![Demo GIF showing the MCP server in action](./demo.gif)
+
+## 📖 About
+**Give your AI assistant direct access to your payment and subscription data.**
+
+This server acts as a bridge between your AI assistant (like VS Code, Claude Desktop, or any MCP-compatible client) and your Lemon Squeezy account. Instead of manually logging into dashboards, searching for orders, and copy-pasting details, you can simply ask your AI questions like:
+- *"What was the last sale?"*
+- *"Is subscription #12345 still active?"*
+- *"Find all customers named 'Alice'"*
+
+Your AI will query the data securely and give you an instant answer, right in your code editor.
+
+---
+
+## 🌱 Beginner Level: Getting Started
+
+**Who is this for?** You are new to CLI tools or just want to get this running quickly with minimal fuss.
+
+### 1. Prerequisites
+Before you start, make sure you have these two things installed on your computer:
+*   **Node.js (Version 18 or higher):** This is the software that runs the server. [Download Node.js here](https://nodejs.org/).
+*   **A Lemon Squeezy Account:** You need an account to get the data. [Sign up here](https://lemonsqueezy.com).
+
+### 2. Get Your API Key
+Think of this as your password for the server.
+1.  Log in to your [Lemon Squeezy Dashboard](https://app.lemonsqueezy.com/settings/api).
+2.  Go to **Settings** -> **API**.
+3.  Click **Create API Key**.
+4.  Copy the key (it starts with `ls_...`). **Keep this safe!**
+
+### 3. Quick Installation
+Open your terminal (Command Prompt on Windows, Terminal on Mac) and run these commands one by one:
+
+```bash
+# 1. Download the project
+git clone https://github.com/MichaelWeed/lemonsqueezy-mcp-server.git
+cd lemonsqueezy-mcp-server
+
+# 2. Install the necessary files
+npm install
+
+# 3. Build the server
+npm run build
+```
+
+### 4. Connect to Your AI Editor
+The exact steps depend on which AI editor you're using. Here are the most common:
+
+**One-copy-paste setup (Claude Desktop / Cursor / npx):**  
+Add this to your MCP config file (e.g. `claude_desktop_config.json` or Cursor MCP settings). Replace `YOUR_KEY_HERE` with your Lemon Squeezy API key.
+
+```json
+"mcpServers": {
+  "lemonsqueezy": {
+    "command": "npx",
+    "args": ["-y", "lemonsqueezy-mcp-server"],
+    "env": {
+      "LEMONSQUEEZY_API_KEY": "YOUR_KEY_HERE"
+    }
+  }
+}
+```
+
+*(Requires the package to be [published on npm](https://www.npmjs.com/package/lemonsqueezy-mcp-server). For local development, use the path-based config below.)*
+
+**For VS Code (local path):**
+1.  Open VS Code Settings
+2.  Go to Extensions → MCP
+3.  Add a new MCP server with:
+    *   **Command:** `node`
+    *   **Args:** `["/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js"]`
+    *   **Env:** `{"LEMONSQUEEZY_API_KEY": "your_api_key_here"}`
+
+**For Claude Desktop (local path):**
+1.  Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+2.  Add the same configuration as above (command `node`, args with full path to `dist/index.js`)
+3.  Restart Claude Desktop
+
+**For Other MCP Clients:**
+Refer to your client's documentation for adding MCP servers. The server runs via `node /path/to/dist/index.js` with the `LEMONSQUEEZY_API_KEY` environment variable set.
+
+After configuring, restart your AI editor and try asking: *"Show me my last 5 orders."*
+
+---
+
+## 🚀 Medium User Level: Basic Usage & Configuration
+
+**Who is this for?** You are comfortable with config files, environment variables, and want to customize how the server works.
+
+### Philosophy: "Sensible Defaults"
+This server is designed to work out of the box with just **one** required setting: your `LEMONSQUEEZY_API_KEY`. Everything else is optional and has pre-configured defaults that work for 90% of users.
+
+### Configuration Options
+You can configure the server using Environment Variables in your MCP settings or a `.env` file.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LEMONSQUEEZY_API_KEY` | **Required.** Your live API key. | - |
+| `LEMONSQUEEZY_TEST_API_KEY` | Optional. Use for testing without affecting real data. | - |
+| `ENABLE_RESOURCES` | Set to `true` to let the AI see "active context" like failed payments automatically. | `false` |
+| `POLL_FAILED_PAYMENTS` | Set to `true` to check for failed payments every few minutes. | `false` |
+
+### Common Tasks
+
+**1. Using Test Mode**
+If you want to develop without touching real money, generate a "Test API Key" in Lemon Squeezy and use `LEMONSQUEEZY_TEST_API_KEY`. The server will automatically prioritize the live key if both are present, so remove the live key to force test mode.
+
+**2. Enabling Salesforce Integration (Bonus)**
+Want to sync customers to your CRM?
+Add these variables:
+- `SALESFORCE_USERNAME`
+- `SALESFORCE_PASSWORD`
+- `SALESFORCE_TOKEN` (Security Token)
+
+The tools for Salesforce (like `sync_customer_to_crm`) will automatically appear in your AI's toolkit.
+
+### Troubleshooting
+*   **"Command not found":** Ensure you ran `npm run build` after installing.
+*   **"Authentication Error":** Double-check your API key. Did you copy an extra space?
+*   **Logs:** The server outputs logs to the "MCP Log" window in your editor. Check there for specific error messages.
+
+---
+
+## 🛠️ Advanced User Level: Technical Documentation
+
+**Who is this for?** Developers, Architects, and DevOps engineers looking for deep technical details, architecture diagrams, security compliance, and deployment strategies.
+
+**Containers:** This repo has both a **Containerfile** and a **Dockerfile** with the same build. The Dockerfile exists so registries (e.g. Smithery) and CI that look for the filename `Dockerfile` can discover and build the image. You can build with Podman or Docker; see **[CONTAINERS.md](./CONTAINERS.md)** for why both exist and how to build.
+
+For a comprehensive breakdown of the system architecture, code modules, security protocols, and enterprise deployment guides, please refer to the:
+
+👉 **[Technical Solution Design Document (TSD)](./TECHNICAL_SOLUTION_DESIGN.md)**
+
+The TSD covers:
+*   **System Architecture & Diagrams**
+*   **Module Interflows & Data Paths**
+*   **Security & Compliance (AWS Secrets Manager, etc.)**
+*   **Deployment (Docker/OCI Containers)**
+*   **Risk Mitigation Strategies**

package/SETUP.md

@@ -0,0 +1,244 @@
+# Quick Setup Checklist
+
+Follow these steps to get your Lemon Squeezy MCP Server running:
+
+## ✅ Pre-Flight Checklist
+
+- [ ] Node.js 18+ installed (`node --version`)
+- [ ] Lemon Squeezy account created
+- [ ] API key obtained from Lemon Squeezy dashboard
+
+## 📦 Installation Steps
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Build the project:**
+   ```bash
+   npm run build
+   ```
+
+3. **Verify build succeeded:**
+   ```bash
+   ls dist/index.js
+   ```
+   (Should show the file exists)
+
+## 🔑 Configuration Steps
+
+1. **Get your API key:**
+   - Go to https://app.lemonsqueezy.com/settings/api
+   - Create a new API key (start with Test key)
+   - Copy it
+
+2. **Configure your AI client:**
+   - **VS Code:** Settings → Extensions → MCP
+   - **Claude Desktop:** Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+   - **Other MCP clients:** Refer to your client's documentation for MCP server configuration
+
+3. **Add this configuration:**
+
+   **Option A — One-copy-paste (npx, after npm publish):**
+   ```json
+   {
+     "mcpServers": {
+       "lemonsqueezy": {
+         "command": "npx",
+         "args": ["-y", "lemonsqueezy-mcp-server"],
+         "env": {
+           "LEMONSQUEEZY_API_KEY": "paste_your_key_here"
+         }
+       }
+     }
+   }
+   ```
+
+   **Option B — Local path (development):**
+   ```json
+   {
+     "mcpServers": {
+       "lemonsqueezy": {
+         "command": "node",
+         "args": ["/FULL/PATH/TO/THIS/PROJECT/dist/index.js"],
+         "env": {
+           "LEMONSQUEEZY_TEST_API_KEY": "paste_your_key_here"
+         }
+       }
+     }
+   }
+   ```
+
+4. **Important:**
+   - Replace `/FULL/PATH/TO/THIS/PROJECT` with your actual path
+   - Use absolute path (full path from root), not relative
+   - Save the file
+   - Restart your AI client completely
+
+## 🧪 Testing
+
+After restarting, ask your AI:
+
+> "What was the last successful payment from Lemon Squeezy?"
+
+If it works, you're done! 🎉
+
+## 🆘 Common Issues
+
+**"Tools not showing up"**
+- Did you save the config file?
+- Did you restart your AI client?
+- Check the path is absolute and correct
+
+**"Server not found"**
+- Run `npm run build` again
+- Verify `dist/index.js` exists
+- Check the path in your config
+
+**"API errors"**
+- Verify your API key is correct
+- Make sure you copied the full key
+- Check key hasn't expired in Lemon Squeezy dashboard
+
+## 📍 Finding Your Path
+
+**Mac/Linux:**
+```bash
+pwd
+# Copy the output and use it in your config
+```
+
+**Windows:**
+```cmd
+cd
+# Copy the output and use it in your config (use forward slashes or double backslashes)
+```
+
+## 🎯 Next Steps
+
+Once it's working:
+- Try different queries (see README examples)
+- Switch to production API key when ready
+- Explore all 45+ available tools
+
+---
+
+## 🔐 Adding Salesforce Integration with AWS Secrets Manager (Optional)
+
+If you want to add Salesforce CRM integration later using AWS Secrets Manager:
+
+### Step 1: Create Secret in AWS Secrets Manager
+
+1. Go to [AWS Secrets Manager Console](https://console.aws.amazon.com/secretsmanager/)
+2. Click "Store a new secret"
+3. Choose "Other type of secret"
+4. Select "Plaintext" or "JSON"
+5. **For JSON format**, enter:
+   ```json
+   {
+     "username": "your_salesforce_username@example.com",
+     "password": "your_salesforce_password",
+     "securityToken": "your_security_token"
+   }
+   ```
+6. **For plain text**, enter:
+   ```
+   username=your_salesforce_username@example.com
+   password=your_salesforce_password
+   securityToken=your_security_token
+   ```
+7. Name your secret (e.g., `your-project/salesforce-credentials` or `prod/salesforce-auth`)
+8. Note your AWS region (e.g., `us-west-2`, `us-east-1`)
+
+### Step 2: Update Your MCP Configuration
+
+Add these environment variables to your MCP config file (location depends on your AI client):
+
+```json
+{
+  "mcpServers": {
+    "lemonsqueezy": {
+      "command": "node",
+      "args": ["/absolute/path/to/TypeScript-MCP-Server/dist/index.js"],
+      "env": {
+        "LEMONSQUEEZY_TEST_API_KEY": "your_test_api_key_here",
+        "AWS_SALESFORCE_SECRET_NAME": "your-project/salesforce-credentials",
+        "AWS_REGION": "us-west-2"
+      }
+    }
+  }
+}
+```
+
+**Do NOT include:**
+- ❌ `AWS_ACCESS_KEY_ID`
+- ❌ `AWS_SECRET_ACCESS_KEY`
+
+**Important:** 
+- Replace `your-project/salesforce-credentials` with **your own secret name** from AWS Secrets Manager
+- Replace `us-east-1` with **your AWS region** where the secret is stored
+- Use your own naming convention (e.g., `your-project/salesforce-credentials`, `prod/salesforce-auth`)
+
+### Step 3: Configure AWS Credentials (IMPORTANT - Security Best Practice)
+
+**DO NOT store AWS credentials directly in mcp.json.** Instead, use AWS CLI to configure credentials securely.
+
+**Recommended Setup (AWS CLI Method):**
+
+1. **Install AWS CLI** (if not already installed):
+   ```bash
+   brew install awscli  # macOS
+   # or download from https://aws.amazon.com/cli/
+   ```
+
+2. **Configure AWS credentials:**
+   ```bash
+   aws configure
+   ```
+   
+   Enter when prompted:
+   - **AWS Access Key ID:** `AKIA...` (from AWS IAM Console)
+   - **AWS Secret Access Key:** `...` (from AWS IAM Console)
+   - **Default region:** `us-west-2` (or your region)
+   - **Output format:** `json` (or press Enter)
+
+3. **Validation:**
+   
+   Test AWS credentials are working:
+   ```bash
+   aws secretsmanager get-secret-value --secret-id your-project/salesforce-credentials --region us-west-2
+   ```
+   
+   If successful, your MCP server will automatically use these credentials.
+
+**Why this is better:**
+- ✅ More secure (credentials not in plain text config files)
+- ✅ AWS best practice
+- ✅ Credentials stored in `~/.aws/credentials` (encrypted by OS)
+- ✅ Works across all AWS tools automatically
+- ✅ Easier credential rotation
+
+**Note:** The server uses AWS SDK's default credential chain, which will automatically use credentials from `~/.aws/credentials` configured via `aws configure`.
+
+### Step 4: Set IAM Permissions
+
+Ensure your AWS credentials have permission to read the secret:
+
+```json
+{
+  "Effect": "Allow",
+  "Action": ["secretsmanager:GetSecretValue"],
+  "Resource": "arn:aws:secretsmanager:us-east-1:account:secret:your-project/salesforce-credentials-*"
+}
+```
+
+Replace `us-east-1` with your region, `account` with your AWS account ID, and `your-project/salesforce-credentials` with your secret name.
+
+### Step 5: Restart Your AI Client
+
+Save the MCP config file and restart your AI client completely.
+
+**That's it!** The server will automatically fetch credentials from AWS Secrets Manager when you use Salesforce tools.
+
+

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+export interface Config {
+    apiKey: string;
+    enableResources: boolean;
+    awsRegion: string;
+    awsSalesforceSecretName?: string;
+    awsFirebaseSecretName?: string;
+    salesforceUsername?: string;
+    salesforcePassword?: string;
+    salesforceToken?: string;
+    salesforceClientId?: string;
+    salesforcePrivateKey?: string;
+    salesforceLoginUrl?: string;
+    firebaseServiceAccountKey?: string;
+    firebaseProjectId?: string;
+    lemonSqueezyStoreId?: string;
+    pollFailedPayments: boolean;
+    pollIntervalMinutes: number;
+    webhookLogPath?: string;
+    webhookPort: number;
+    webhookSecret?: string;
+    enableNgrok: boolean;
+}
+export declare const config: Config;
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAkED,eAAO,MAAM,MAAM,EAAE,MAKjB,CAAC;AAGL,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/dist/config.js

@@ -0,0 +1,80 @@
+import * as dotenv from "dotenv";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { lemonSqueezySetup } from "@lemonsqueezy/lemonsqueezy.js";
+import { logger } from "./utils/logger.js";
+// Load .env relative to script location
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.resolve(__dirname, "..");
+dotenv.config({ path: path.join(rootDir, ".env") });
+// Validate and initialize Lemon Squeezy SDK
+// Priority: LEMONSQUEEZY_API_KEY (production) > LEMONSQUEEZY_TEST_API_KEY (test)
+function getApiKey() {
+    const apiKey = process.env.LEMONSQUEEZY_API_KEY ||
+        process.env.LEMON_SQUEEZY_API_KEY ||
+        process.env.LEMONSQUEEZY_TEST_API_KEY ||
+        process.env.LEMON_SQUEEZY_TEST_API_KEY;
+    if (!apiKey) {
+        const error = new Error("LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_TEST_API_KEY must be set");
+        logger.fatal({
+            cwd: process.cwd(),
+            envPath: path.join(rootDir, ".env"),
+            envKeys: Object.keys(process.env).filter(k => k.includes("LEMONSQUEEZY"))
+        }, "API Key missing");
+        throw error;
+    }
+    return apiKey;
+}
+function initializeLemonSqueezy(apiKey) {
+    lemonSqueezySetup({
+        apiKey: apiKey,
+        onError: (error) => logger.error({ error }, "Lemon Squeezy Error"),
+    });
+}
+// Lazy initialization - only initialize SDK when config is accessed
+let configInstance = null;
+let sdkInitialized = false;
+function createConfig() {
+    const apiKey = getApiKey();
+    // Initialize SDK only once
+    if (!sdkInitialized) {
+        initializeLemonSqueezy(apiKey);
+        sdkInitialized = true;
+    }
+    return {
+        apiKey,
+        enableResources: process.env.ENABLE_RESOURCES === "true",
+        awsRegion: process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION || "us-east-1",
+        awsSalesforceSecretName: process.env.AWS_SALESFORCE_SECRET_NAME,
+        awsFirebaseSecretName: process.env.AWS_FIREBASE_SECRET_NAME,
+        salesforceUsername: process.env.SALESFORCE_USERNAME,
+        salesforcePassword: process.env.SALESFORCE_PASSWORD,
+        salesforceToken: process.env.SALESFORCE_TOKEN,
+        salesforceClientId: process.env.SALESFORCE_CLIENT_ID,
+        salesforcePrivateKey: process.env.SALESFORCE_PRIVATE_KEY,
+        salesforceLoginUrl: process.env.SALESFORCE_LOGIN_URL,
+        firebaseServiceAccountKey: process.env.FIREBASE_SERVICE_ACCOUNT_KEY,
+        firebaseProjectId: process.env.FIREBASE_PROJECT_ID,
+        lemonSqueezyStoreId: process.env.LEMON_SQUEEZY_STORE_ID,
+        pollFailedPayments: process.env.POLL_FAILED_PAYMENTS === "true",
+        pollIntervalMinutes: parseInt(process.env.POLL_INTERVAL_MINUTES || "5", 10),
+        webhookLogPath: process.env.WEBHOOK_LOG_PATH,
+        webhookPort: parseInt(process.env.WEBHOOK_PORT || "3000", 10),
+        webhookSecret: process.env.LEMONSQUEEZY_WEBHOOK_SECRET,
+        enableNgrok: process.env.ENABLE_NGROK === "true",
+    };
+}
+// Export config getter - throws error if API key is missing
+export const config = (() => {
+    if (!configInstance) {
+        configInstance = createConfig();
+    }
+    return configInstance;
+})();
+// Export function for testing that allows overriding
+export function resetConfig() {
+    configInstance = null;
+    sdkInitialized = false;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { resetConfig } from "./config.js";
+describe("Config", () => {
+    beforeEach(() => {
+        // Reset config state before each test
+        resetConfig();
+        // Clear environment variables
+        delete process.env.LEMONSQUEEZY_API_KEY;
+        delete process.env.LEMONSQUEEZY_TEST_API_KEY;
+    });
+    it("should throw error when API key is missing", () => {
+        expect(() => {
+            // Access config to trigger initialization
+            const { config } = require("./config.js");
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            config.apiKey;
+        }).toThrow("LEMONSQUEEZY_API_KEY or LEMONSQUEEZY_TEST_API_KEY must be set");
+    });
+    it("should use test API key when provided", () => {
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key_123";
+        const { config } = require("./config.js");
+        expect(config.apiKey).toBe("test_key_123");
+    });
+    it("should prefer production API key over test key", () => {
+        process.env.LEMONSQUEEZY_API_KEY = "prod_key_123";
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key_123";
+        const { config } = require("./config.js");
+        expect(config.apiKey).toBe("prod_key_123");
+    });
+    it("should parse webhook port from environment", () => {
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key";
+        process.env.WEBHOOK_PORT = "8080";
+        const { config } = require("./config.js");
+        expect(config.webhookPort).toBe(8080);
+    });
+    it("should default webhook port to 3000", () => {
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key";
+        delete process.env.WEBHOOK_PORT;
+        const { config } = require("./config.js");
+        expect(config.webhookPort).toBe(3000);
+    });
+    it("should parse poll interval minutes", () => {
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key";
+        process.env.POLL_INTERVAL_MINUTES = "10";
+        const { config } = require("./config.js");
+        expect(config.pollIntervalMinutes).toBe(10);
+    });
+    it("should default poll interval to 5 minutes", () => {
+        process.env.LEMONSQUEEZY_TEST_API_KEY = "test_key";
+        delete process.env.POLL_INTERVAL_MINUTES;
+        const { config } = require("./config.js");
+        expect(config.pollIntervalMinutes).toBe(5);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

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