pcbway-mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nabheet
+
+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,322 @@
+# pcbway-mcp-server
+
+**MCP server for the PCBWay Partner API.** Full coverage of the PCBWay API — PCB/SMT quotes, order lifecycle (place, confirm, cancel, status), shipping, account, and address lookup — from any MCP-compatible client (Claude Desktop, etc.).
+
+## Features
+
+- **PCB Quote** — Instant PCB manufacturing pricing with turn time options
+- **SMT Quote** — SMT assembly pricing by part counts
+- **Order Lifecycle** — Place, confirm, cancel orders; query fabrication status & details
+- **Order Package Management** — Check, pay, and cancel awaiting-payment packages; inspect confirmed packages
+- **Shipping** — Pre-payment freight cost estimate
+- **Account** — Balance, coupon value, reward points
+- **Address Lookup** — Countries, states/provinces, cities with postal codes
+- **16 MCP tools** covering all documented PCBWay Partner API endpoints
+
+## Requirements
+
+- Node.js >= 18
+- A PCBWay Partner account with an **API Key**
+
+## Setup
+
+### 1. Get API Credentials
+
+Log in to your [PCBWay Partner Dashboard](https://www.pcbway.com) to obtain your **API Key**.
+
+### 2. Install
+
+```bash
+npm install -g pcbway-mcp-server
+```
+
+Or run directly:
+
+```bash
+npx pcbway-mcp-server
+```
+
+### 3. Configure Environment
+
+```bash
+# Required:
+export PCBWAY_API_KEY=your_api_key
+
+# Optional overrides:
+export PCBWAY_BASE_URL=https://api-partner.pcbway.com   # API base
+export PCBWAY_MAX_RETRIES=3                               # Max retries for transient failures
+export PCBWAY_BASE_DELAY_MS=500                           # Base exponential-backoff delay (ms)
+export PCBWAY_TIMEOUT_MS=30000                            # Request timeout (ms)
+```
+
+**Note:** The PCBWay Partner API uses a single `api-key` header for authentication. There is no App ID, HMAC signing, or timestamp required.
+
+### 4. Run
+
+```bash
+npx pcbway-mcp-server
+```
+
+## MCP Client Configuration
+
+```json
+{
+  "mcpServers": {
+    "pcbway": {
+      "command": "npx",
+      "args": ["-y", "pcbway-mcp-server"],
+      "env": {
+        "PCBWAY_API_KEY": "your_api_key"
+        // Optional: PCBWAY_MAX_RETRIES, PCBWAY_BASE_DELAY_MS, PCBWAY_TIMEOUT_MS, PCBWAY_BASE_URL
+      }
+    }
+  }
+}
+```
+
+**Never hardcode credentials in configs that are shared or committed.**
+
+## Available Tools
+
+### `pcb_quote`
+
+PCB manufacturing price quote. Requires shipping destination and board parameters.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `Country` | string | ✓ | Country name (e.g. "UNITED STATES OF AMERICA") |
+| `CountryCode` | string | ✓ | ISO country code (e.g. "US") |
+| `ShipType` | number | ✓ | Carrier: 1=DHL, 10=FedEx IP, 4=SF Express, 6=EMS, 7=E-packet, 9=China Post, 35=Global Standard |
+| `Postalcode` | string | ✓ | Postal / ZIP code |
+| `City` | string | ✓ | City |
+| `Length` | number | ✓ | Board length in mm |
+| `Width` | number | ✓ | Board width in mm |
+| `Qty` | number | ✓ | Quantity (5–10000) |
+| `Layers` | number | ✓ | Layer count: 1, 2, 4, 6, 8, 10, 12, 14 |
+
+Returns pricing by build speed (Standard / Express) with shipping cost.
+
+### `smt_quote`
+
+SMT assembly price quote. Uses simple part counts (not a full BOM).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `Country` | string | ✓ | Country name |
+| `CountryCode` | string | ✓ | ISO country code |
+| `ShipType` | number | ✓ | Carrier ID |
+| `Postalcode` | string | ✓ | Postal code |
+| `City` | string | ✓ | City |
+| `FlexibleOption` | string | ✓ | "Turnkey", "Kitted or Consigned", "Combo" |
+| `BoardType` | string | ✓ | "Single pieces" or "Panelized PCBs" |
+| `AssemblySide` | string | ✓ | "Top side", "Bottom side", or "Both sides" |
+| `Qty` | number | ✓ | Quantity to assemble |
+| `UniqueParts` | number | | Number of unique parts (default 0) |
+| `SMTParts` | number | | Number of SMT parts (default 0) |
+| `HoleParts` | number | | Number of through-hole parts (default 0) |
+
+### `order_process`
+
+Get fabrication status — shows all required processes and which are completed.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `OrderNo` | string | ✓ | PCBWay order number (e.g. "W0002AS1") |
+
+### `order_details`
+
+Get full order details including all PCB parameters (dimensions, material, finish, audit result, delivery date, etc.)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `OrderNo` | string | ✓ | PCBWay order number |
+
+### `shipping_freight`
+
+Get shipping cost before payment (call after placing order, before confirming).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `OrderNo` | string | ✓ | Order number (comma-separated for joint shipment) |
+| `ShipType` | number | ✓ | Carrier ID |
+| `Country` | string | ✓ | Country name |
+| `CountryCode` | string | ✓ | ISO country code |
+| `Postalcode` | string | ✓ | Postal code |
+| `City` | string | ✓ | City |
+| `State` | string | | State / Province (optional) |
+| `AddGroupNo` | string | | Order package number when adding to package (optional) |
+
+### `account_balance`
+
+Query PCBWay account balance, coupon value, and reward points. No parameters required.
+
+### `place_order`
+
+Add a PCB order to your cart. Requires PCB file and all board parameters.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `PcbFileName` | string | ✓ | PCB file name |
+| `BuildDays` | number | ✓ | Production cycle from quote response |
+| `Length` | number | ✓ | Board length in mm |
+| `Width` | number | ✓ | Board width in mm |
+| `Qty` | number | ✓ | Quantity |
+| `Layers` | number | ✓ | Layer count |
+| `BoardType` | string | | "Single PCB" (default), "Panel PCB as design", "Panel PCB by Supplier" |
+| `Material` | string | | "FR-4" (default) |
+| `Thickness` | number | | Board thickness in mm (default 1.6) |
+| `SolderMask` | string | | "Green" (default) |
+| `Silkscreen` | string | | "White" (default) |
+| `SurfaceFinish` | string | | "HASL with lead" (default) |
+| `PcbFileUrl` | string | | URL to PCB Gerber zip file |
+| `Note` | string | | Order notes (optional) |
+| `BuyerEmail` | string | | Email for contact |
+
+### `confirm_order`
+
+Confirm orders and make payment. Can confirm single or multiple orders together.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `OrderNo` | string | ✓ | Order number(s), comma-separated for multiple |
+| `PayType` | number | ✓ | Payment method: 1=AccountPay, 2=PCBWayWebPay |
+| `ShipType` | number | | Carrier (required unless adding to package) |
+| `Country` | string | | Country name (required unless adding to package) |
+| `CountryCode` | string | | ISO country code (required unless adding to package) |
+| `City` | string | | City (required unless adding to package) |
+| `Addr` | string | | Delivery address (required unless adding to package) |
+| `Tel` | string | | Phone number (required unless adding to package) |
+| `AddGroupNo` | string | | Order package number when adding to existing package |
+| `State` | string | | State / Province |
+| `Postalcode` | string | | Postal code |
+| `ContactName` | string | | Contact person |
+| `CompanyName` | string | | Company name |
+| `BuyerEmail` | string | | Email for contact |
+| `Tax` | string | | Tax ID |
+
+### `cancel_order`
+
+Cancel an existing PCBWay order.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `OrderNo` | string | ✓ | Order number to cancel |
+
+### `check_tgroup_order`
+
+Check awaiting-payment order package details.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `TGroupNo` | string | ✓ | Awaiting-payment package number |
+
+### `pay_tgroup_order`
+
+Pay for an awaiting-payment order package.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `TGroupNo` | string | ✓ | Awaiting-payment package number |
+| `PayType` | number | ✓ | 1=AccountPay, 2=PCBWayWebPay |
+
+### `cancel_tgroup_order`
+
+Cancel an awaiting-payment order package.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `TGroupNo` | string | ✓ | Awaiting-payment package number to cancel |
+
+### `check_group_order`
+
+Check a confirmed (paid) order package details.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `GroupNo` | string | ✓ | Confirmed order package number |
+
+### `get_countries`
+
+List all supported countries for PCBWay ordering. No parameters required.
+
+### `get_states`
+
+List states/provinces for a country.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `Country` | string | ✓ | Country name (e.g. "UNITED STATES OF AMERICA") |
+| `CountryCode` | string | ✓ | ISO country code (e.g. "US") |
+
+### `get_cities`
+
+List cities with postal codes for a country/state.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `Country` | string | ✓ | Country name |
+| `CountryCode` | string | ✓ | ISO country code |
+| `State` | string | | State/Province to filter by (optional) |
+
+## Development
+
+```bash
+git clone https://github.com/nabheet/pcbway-mcp-server.git
+cd pcbway-mcp-server
+npm install
+npm run build
+```
+
+## Architecture
+
+```
+src/
+├── index.ts                  # MCP server entry point + tool registry
+├── config.ts                 # Environment variable loading (PCBWAY_API_KEY only)
+├── client.ts                 # Simple api-key auth, POST-only client
+├── types.ts                  # Full TypeScript interfaces matching PCBWay API
+└── resources/
+    ├── PcbQuote.ts           # POST /api/Pcb/PcbQuotation
+    ├── SmtQuote.ts           # POST /api/SMT/SMTQuotation
+    ├── OrderProcess.ts       # POST /api/Pcb/QueryOrderProcess
+    ├── OrderDetails.ts       # POST /api/Pcb/CheckOrderDetails
+    ├── Shipping.ts           # POST /api/Pcb/GetFreightByOrder
+    ├── Account.ts            # POST /api/Account/QueryBalance
+    ├── PlaceOrder.ts         # POST /api/Pcb/PlaceOrder
+    ├── ConfirmOrder.ts       # POST /api/Pcb/ConfirmOrder
+    ├── CancelOrder.ts        # POST /api/Pcb/CancelOrder
+    ├── CheckTGroupOrder.ts   # POST /api/Pcb/CheckTGroupOrder
+    ├── PayTGroupOrder.ts     # POST /api/Pcb/PayTGroupOrder
+    ├── CancelTGroupOrder.ts  # POST /api/Pcb/CancelTGroupOrder
+    ├── CheckGroupOrder.ts    # POST /api/Pcb/CheckGroupOrder
+    ├── GetCountries.ts       # POST /api/Address/GetCountry
+    ├── GetStates.ts          # POST /api/Address/GetState
+    └── GetCities.ts          # POST /api/Address/GetCity
+```
+
+One class per resource. Input validation via Zod schemas. All endpoints use POST with JSON body and `api-key` header authentication.
+
+## API Endpoint Coverage
+
+| MCP Tool | PCBWay API Endpoint | Status |
+|---|---|---|
+| `pcb_quote` | `POST /api/Pcb/PcbQuotation` | ✅ |
+| `smt_quote` | `POST /api/SMT/SMTQuotation` | ✅ |
+| `order_process` | `POST /api/Pcb/QueryOrderProcess` | ✅ |
+| `order_details` | `POST /api/Pcb/CheckOrderDetails` | ✅ |
+| `shipping_freight` | `POST /api/Pcb/GetFreightByOrder` | ✅ |
+| `place_order` | `POST /api/Pcb/PlaceOrder` | ✅ |
+| `confirm_order` | `POST /api/Pcb/ConfirmOrder` | ✅ |
+| `cancel_order` | `POST /api/Pcb/CancelOrder` | ✅ |
+| `check_tgroup_order` | `POST /api/Pcb/CheckTGroupOrder` | ✅ |
+| `pay_tgroup_order` | `POST /api/Pcb/PayTGroupOrder` | ✅ |
+| `cancel_tgroup_order` | `POST /api/Pcb/CancelTGroupOrder` | ✅ |
+| `check_group_order` | `POST /api/Pcb/CheckGroupOrder` | ✅ |
+| `account_balance` | `POST /api/Account/QueryBalance` | ✅ |
+| `get_countries` | `POST /api/Address/GetCountry` | ✅ |
+| `get_states` | `POST /api/Address/GetState` | ✅ |
+| `get_cities` | `POST /api/Address/GetCity` | ✅ |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+import { type Config } from './config.js';
+/**
+ * Thrown when the PCBWay API returns `Status: "error"`.
+ * Preserves the API's error message and code.
+ */
+export declare class PcbWayApiError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+/**
+ * Thrown on network failures, timeouts, or non-200 HTTP responses.
+ */
+export declare class PcbWayNetworkError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * PCBWay Partner API client.
+ * Auth is a single `api-key` header (no HMAC, no appid, no timestamp).
+ * All endpoints are POST with JSON body.
+ */
+export declare class PcbWayClient {
+    private config;
+    constructor(config?: Config);
+    /**
+     * Perform an authenticated POST request with timeout and retry.
+     *
+     * Retries on:
+     *  - Network errors (fetch throws)
+     *  - HTTP 5xx and 429 (rate limit)
+     *  Does NOT retry on 4xx except 429 — those are client errors.
+     */
+    request<T>(path: string, body: Record<string, unknown>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAItD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,MAAM,CAAC,EAAE,MAAM;gBAD/B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC;AAsBD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAI3B;;;;;;;OAOG;IACG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA2F1E"}

package/dist/client.js

@@ -0,0 +1,135 @@
+import { loadConfig } from './config.js';
+// ── Typed error ──────────────────────────────────────────────────
+/**
+ * Thrown when the PCBWay API returns `Status: "error"`.
+ * Preserves the API's error message and code.
+ */
+export class PcbWayApiError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'PcbWayApiError';
+    }
+}
+/**
+ * Thrown on network failures, timeouts, or non-200 HTTP responses.
+ */
+export class PcbWayNetworkError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'PcbWayNetworkError';
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────
+/** Sleep for `ms` milliseconds. */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Calculate delay with jitter for retry `attempt` (0-indexed). */
+function backoffDelay(baseDelayMs, attempt) {
+    const delay = baseDelayMs * 2 ** attempt; // 500, 1000, 2000, …
+    const jitter = Math.random() * delay * 0.3; // ±30%
+    return Math.round(delay + jitter);
+}
+/** Returns true for status codes that are safe to retry. */
+function isRetryable(status) {
+    return status >= 500 || status === 429;
+}
+// ── Client ───────────────────────────────────────────────────────
+/**
+ * PCBWay Partner API client.
+ * Auth is a single `api-key` header (no HMAC, no appid, no timestamp).
+ * All endpoints are POST with JSON body.
+ */
+export class PcbWayClient {
+    config;
+    constructor(config) {
+        this.config = config ?? loadConfig();
+    }
+    /**
+     * Perform an authenticated POST request with timeout and retry.
+     *
+     * Retries on:
+     *  - Network errors (fetch throws)
+     *  - HTTP 5xx and 429 (rate limit)
+     *  Does NOT retry on 4xx except 429 — those are client errors.
+     */
+    async request(path, body) {
+        const url = `${this.config.baseUrl}${path}`;
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs);
+                let response;
+                try {
+                    response = await fetch(url, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'api-key': this.config.apiKey,
+                        },
+                        body: JSON.stringify(body),
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeout);
+                }
+                // Read body once (text, so we can include it in errors)
+                const text = await response.text();
+                if (!response.ok) {
+                    // Retry on 5xx / 429, bail on 4xx
+                    if (isRetryable(response.status) && attempt < this.config.maxRetries) {
+                        const delay = backoffDelay(this.config.baseDelayMs, attempt);
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new PcbWayNetworkError(`HTTP ${response.status} ${response.statusText}${text ? ` — ${text}` : ''}`, response.status);
+                }
+                // Parse JSON
+                const data = JSON.parse(text);
+                // Check API-level error status if the response type has it
+                // We do a safe check on the envelope fields
+                const envelope = data;
+                if (envelope.Status === 'error') {
+                    const errText = typeof envelope.ErrorText === 'string' ? envelope.ErrorText : null;
+                    const code = typeof envelope.Code === 'number' ? envelope.Code : 0;
+                    throw new PcbWayApiError(errText ?? 'Unknown API error', code);
+                }
+                return data;
+            }
+            catch (err) {
+                // If it's already our typed error, re-throw immediately (no retry for API errors)
+                if (err instanceof PcbWayApiError) {
+                    throw err;
+                }
+                // AbortError (timeout) — retry
+                if (err instanceof Error && err.name === 'AbortError') {
+                    if (attempt < this.config.maxRetries) {
+                        const delay = backoffDelay(this.config.baseDelayMs, attempt);
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new PcbWayNetworkError('Request timed out');
+                }
+                // Fetch network error — retry
+                if (err instanceof TypeError || (err instanceof Error && 'code' in err)) {
+                    lastError = err;
+                    if (attempt < this.config.maxRetries) {
+                        const delay = backoffDelay(this.config.baseDelayMs, attempt);
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new PcbWayNetworkError(`Network error after ${this.config.maxRetries + 1} attempts: ${err.message}`);
+                }
+                // Unknown — re-throw immediately
+                throw err;
+            }
+        }
+        // Should not reach here, but satisfy types
+        throw lastError ?? new PcbWayNetworkError('Request failed');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Configuration loaded from environment variables.
+ * PCBWay Partner API uses a single api-key header — no app ID, no HMAC.
+ *
+ * Loads .env file automatically via dotenv (if present).
+ */
+import 'dotenv/config';
+export interface Config {
+    apiKey: string;
+    baseUrl: string;
+    /** Max retries for transient failures (network blips, 5xx). Default 3. */
+    maxRetries: number;
+    /** Base delay in ms for exponential backoff. Default 500. */
+    baseDelayMs: number;
+    /** Request timeout in ms. Default 30_000. */
+    timeoutMs: number;
+}
+/**
+ * Load config from process.env.
+ * Throws clearly if PCBWAY_API_KEY is missing.
+ */
+export declare function loadConfig(): Config;
+//# 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":"AAAA;;;;;GAKG;AACH,OAAO,eAAe,CAAC;AAEvB,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAgBnC"}

package/dist/config.js

@@ -0,0 +1,24 @@
+/**
+ * Configuration loaded from environment variables.
+ * PCBWay Partner API uses a single api-key header — no app ID, no HMAC.
+ *
+ * Loads .env file automatically via dotenv (if present).
+ */
+import 'dotenv/config';
+/**
+ * Load config from process.env.
+ * Throws clearly if PCBWAY_API_KEY is missing.
+ */
+export function loadConfig() {
+    const apiKey = process.env.PCBWAY_API_KEY;
+    const baseUrl = process.env.PCBWAY_BASE_URL ?? 'https://api-partner.pcbway.com';
+    const maxRetries = parseInt(process.env.PCBWAY_MAX_RETRIES ?? '', 10) || 3;
+    const baseDelayMs = parseInt(process.env.PCBWAY_BASE_DELAY_MS ?? '', 10) || 500;
+    const timeoutMs = parseInt(process.env.PCBWAY_TIMEOUT_MS ?? '', 10) || 30_000;
+    if (!apiKey) {
+        throw new Error('Missing PCBWAY_API_KEY environment variable. ' +
+            'Set it to your PCBWay Partner API Key.');
+    }
+    return { apiKey, baseUrl, maxRetries, baseDelayMs, timeoutMs };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,eAAe,CAAC;AAavB;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gCAAgC,CAAC;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAChF,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC;IAE9E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,wCAAwC,CAC3C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC"}

package/dist/enums.d.ts

@@ -0,0 +1,20 @@
+/** Freight_ShipType values */
+export declare const SHIP_TYPES: {
+    readonly DHL: 1;
+    readonly FedEx_IP: 10;
+    readonly FedExFICP: 25;
+    readonly SF_Express: 4;
+    readonly Freight_Collect_Account: 5;
+    readonly EMS: 6;
+    readonly E_packet: 7;
+    readonly China_Post: 9;
+    readonly Global_Standard_Shipping: 35;
+};
+export type ShipType = (typeof SHIP_TYPES)[keyof typeof SHIP_TYPES];
+/** Pcb_PayType values */
+export declare const PAY_TYPES: {
+    readonly AccountPay: 1;
+    readonly PCBWayWebPay: 2;
+};
+export type PayType = (typeof PAY_TYPES)[keyof typeof PAY_TYPES];
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAEA,8BAA8B;AAC9B,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAIpE,yBAAyB;AACzB,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/enums.js

@@ -0,0 +1,20 @@
+// ── ShipType ──────────────────────────────────────────────────────
+/** Freight_ShipType values */
+export const SHIP_TYPES = {
+    DHL: 1,
+    FedEx_IP: 10,
+    FedExFICP: 25,
+    SF_Express: 4,
+    Freight_Collect_Account: 5,
+    EMS: 6,
+    E_packet: 7,
+    China_Post: 9,
+    Global_Standard_Shipping: 35,
+};
+// ── PayType ──────────────────────────────────────────────────────
+/** Pcb_PayType values */
+export const PAY_TYPES = {
+    AccountPay: 1,
+    PCBWayWebPay: 2,
+};
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,CAAC;IACb,uBAAuB,EAAE,CAAC;IAC1B,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,wBAAwB,EAAE,EAAE;CACpB,CAAC;AAIX,oEAAoE;AAEpE,yBAAyB;AACzB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;CACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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