shopline-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Asgard AI Platform
+
+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,87 @@
+# Shopline MCP Server
+
+An MCP server for the Shopline Open API, published as `shopline-mcp`.
+
+It exposes 143 AI-callable tools for Shopline store analysis and operations:
+
+- 75 read tools for orders, products, inventory, customers, promotions, analytics, reviews, conversations, and store settings
+- 68 write tools for creating, updating, and deleting Shopline resources
+- stdio transport for Claude Code, Claude Desktop, Codex, and other MCP-compatible clients
+
+## Links
+
+- Repository: [slinedev/shopline-mcp](https://github.com/slinedev/shopline-mcp)
+- Official website: [https://sline.dev/shopline-mcp/](https://sline.dev/shopline-mcp/)
+
+## Requirements
+
+- Node.js 24 or newer
+- A Shopline Open API access token
+
+Set your token before running the server:
+
+```bash
+export SHOPLINE_API_TOKEN=your_token_here
+```
+
+## Install
+
+```bash
+npm install shopline-mcp
+```
+
+Or run it directly:
+
+```bash
+npx shopline-mcp
+```
+
+The executable command is:
+
+```bash
+shopline-mcp
+```
+
+## Claude Code
+
+```bash
+claude mcp add --transport stdio shopline -e SHOPLINE_API_TOKEN=your_token_here -- npx shopline-mcp
+```
+
+## Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "shopline": {
+      "command": "npx",
+      "args": ["shopline-mcp"],
+      "env": {
+        "SHOPLINE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Write Tools
+
+This server includes write tools that can create, update, or delete data in your Shopline store.
+
+Write tools are marked with `[WRITE]` in their descriptions and include a side-effect section. Use a token with the narrowest permissions needed.
+
+## API Notes
+
+- Base URL: `https://open.shopline.io`
+- Auth: `Authorization: Bearer <SHOPLINE_API_TOKEN>`
+- Pagination: `page` + `per_page`, max `per_page` 50
+- Large order searches are paginated internally
+- Online revenue orders use `confirmed`; POS revenue orders use `completed`
+- Channel source: `created_from = "shop"` for online and `"pos"` for POS
+- Money values are returned as TWD numbers by extracting Shopline money object `dollars`
+
+## Package Name
+
+Use `shopline-mcp` for npm registry installs.
+
+`shopline/mcp` without `@` is not an npm package name. npm treats that form as a GitHub repository shorthand.

package/README.zh-TW.md

@@ -0,0 +1,87 @@
+# Shopline MCP Server
+
+Shopline Open API 的 MCP server，npm 套件名稱為 `shopline-mcp`。
+
+此 server 提供 143 個可供 AI Agent 呼叫的 Shopline 工具：
+
+- 75 個讀取工具：訂單、商品、庫存、客戶、促銷、分析、評論、對話、商店設定
+- 68 個寫入工具：建立、更新、刪除 Shopline 資源
+- 使用 stdio transport，可接 Claude Code、Claude Desktop、Codex 與其他 MCP client
+
+## 連結
+
+- 倉庫地址：[slinedev/shopline-mcp](https://github.com/slinedev/shopline-mcp)
+- 官方網站：[https://sline.dev/shopline-mcp/](https://sline.dev/shopline-mcp/)
+
+## 環境需求
+
+- Node.js 24 或更新版本
+- Shopline Open API access token
+
+執行前先設定 token：
+
+```bash
+export SHOPLINE_API_TOKEN=your_token_here
+```
+
+## 安裝
+
+```bash
+npm install shopline-mcp
+```
+
+或直接執行：
+
+```bash
+npx shopline-mcp
+```
+
+安裝後的命令為：
+
+```bash
+shopline-mcp
+```
+
+## Claude Code
+
+```bash
+claude mcp add --transport stdio shopline -e SHOPLINE_API_TOKEN=your_token_here -- npx shopline-mcp
+```
+
+## Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "shopline": {
+      "command": "npx",
+      "args": ["shopline-mcp"],
+      "env": {
+        "SHOPLINE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## 寫入工具
+
+此 server 包含會建立、更新或刪除 Shopline 資料的寫入工具。
+
+寫入工具的描述都以 `[WRITE]` 開頭，並包含副作用說明。請使用權限最小化的 API token。
+
+## API 注意事項
+
+- Base URL：`https://open.shopline.io`
+- 認證：`Authorization: Bearer <SHOPLINE_API_TOKEN>`
+- 分頁：`page` + `per_page`，`per_page` 上限 50
+- 大量訂單查詢會在工具內部分頁處理
+- 線上有效營收訂單狀態為 `confirmed`，POS 有效營收訂單狀態為 `completed`
+- 通路來源：`created_from = "shop"` 表示線上，`"pos"` 表示 POS
+- 金額以 TWD 數字回傳，來源是 Shopline money object 的 `dollars`
+
+## 套件名稱
+
+npm registry 安裝請使用 `shopline-mcp`。
+
+沒有 `@` 的 `shopline/mcp` 不是 npm 套件名稱，npm 會把它當成 GitHub repository shorthand。

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export interface ApiRequestOptions {
+    readonly jsonBody?: unknown;
+    readonly params?: Record<string, unknown>;
+    readonly pathParams?: Record<string, unknown>;
+    readonly retries?: number;
+    readonly retryOnClientError?: boolean;
+}
+export declare class ShoplineAPIError extends Error {
+    readonly statusCode: number;
+    readonly messageText: string;
+    readonly endpoint: string;
+    constructor(statusCode: number, messageText: string, endpoint: string);
+}
+type FetchLike = typeof fetch;
+export declare function setFetchImplementation(fetchLike: FetchLike): void;
+export declare function resetFetchImplementation(): void;
+export declare function apiRequest(method: HttpMethod, endpointKey: string, options?: ApiRequestOptions): Promise<Record<string, unknown>>;
+export declare function apiGet(endpointKey: string, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, retries?: number): Promise<Record<string, unknown>>;
+export declare function apiPost(endpointKey: string, jsonBody?: unknown, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, retries?: number): Promise<Record<string, unknown>>;
+export declare function apiPut(endpointKey: string, jsonBody?: unknown, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, retries?: number): Promise<Record<string, unknown>>;
+export declare function apiPatch(endpointKey: string, jsonBody?: unknown, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, retries?: number): Promise<Record<string, unknown>>;
+export declare function apiDelete(endpointKey: string, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, jsonBody?: unknown, retries?: number): Promise<Record<string, unknown>>;
+export declare function fetchAllPages(endpointKey: string, params?: Record<string, unknown>, pathParams?: Record<string, unknown>, maxPages?: number): Promise<Record<string, unknown>[]>;
+export declare function fetchAllPagesByDateSegments(endpointKey: string, startDate: string, endDate: string, params?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+export {};

package/dist/client.js

@@ -0,0 +1,144 @@
+import { DEFAULT_PER_PAGE, DEFAULT_SORT, getHeaders, getUrl } from "./config.js";
+import { sleep } from "./shared/helpers.js";
+export class ShoplineAPIError extends Error {
+    statusCode;
+    messageText;
+    endpoint;
+    constructor(statusCode, messageText, endpoint) {
+        super(`[${statusCode}] ${endpoint}: ${messageText}`);
+        this.statusCode = statusCode;
+        this.messageText = messageText;
+        this.endpoint = endpoint;
+    }
+}
+let fetchImplementation = (...args) => globalThis.fetch(...args);
+export function setFetchImplementation(fetchLike) {
+    fetchImplementation = fetchLike;
+}
+export function resetFetchImplementation() {
+    fetchImplementation = (...args) => globalThis.fetch(...args);
+}
+function appendParams(url, params) {
+    if (!params)
+        return;
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === "")
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(key, String(item));
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+}
+async function readJsonOrText(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export async function apiRequest(method, endpointKey, options = {}) {
+    const retries = options.retries ?? 3;
+    const retryOnClientError = options.retryOnClientError ?? method === "GET";
+    const url = new URL(getUrl(endpointKey, options.pathParams));
+    appendParams(url, options.params);
+    for (let attempt = 0; attempt < retries; attempt += 1) {
+        try {
+            const response = await fetchImplementation(url, {
+                method,
+                headers: getHeaders(),
+                body: options.jsonBody === undefined ? undefined : JSON.stringify(options.jsonBody),
+                signal: AbortSignal.timeout(60_000),
+            });
+            if (response.status === 204)
+                return {};
+            if (response.status === 200 || response.status === 201) {
+                const data = await readJsonOrText(response);
+                return data && typeof data === "object" && !Array.isArray(data) ? data : { result: data };
+            }
+            const text = String(await readJsonOrText(response)).slice(0, 500);
+            const isClientError = response.status >= 400 && response.status < 500;
+            const isServerError = response.status >= 500;
+            if (isClientError && !retryOnClientError) {
+                throw new ShoplineAPIError(response.status, text, url.toString());
+            }
+            if ((isServerError || (isClientError && retryOnClientError)) && attempt < retries - 1) {
+                await sleep(2 ** attempt * 1000);
+                continue;
+            }
+            throw new ShoplineAPIError(response.status, text, url.toString());
+        }
+        catch (error) {
+            if (error instanceof ShoplineAPIError)
+                throw error;
+            if (attempt < retries - 1) {
+                await sleep(2 ** attempt * 1000);
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw new Error(`Shopline request failed after ${retries} retries`);
+}
+export function apiGet(endpointKey, params, pathParams, retries = 3) {
+    return apiRequest("GET", endpointKey, { params, pathParams, retries, retryOnClientError: true });
+}
+export function apiPost(endpointKey, jsonBody, params, pathParams, retries = 3) {
+    return apiRequest("POST", endpointKey, { jsonBody, params, pathParams, retries, retryOnClientError: false });
+}
+export function apiPut(endpointKey, jsonBody, params, pathParams, retries = 3) {
+    return apiRequest("PUT", endpointKey, { jsonBody, params, pathParams, retries, retryOnClientError: false });
+}
+export function apiPatch(endpointKey, jsonBody, params, pathParams, retries = 3) {
+    return apiRequest("PATCH", endpointKey, { jsonBody, params, pathParams, retries, retryOnClientError: false });
+}
+export function apiDelete(endpointKey, params, pathParams, jsonBody, retries = 3) {
+    return apiRequest("DELETE", endpointKey, { jsonBody, params, pathParams, retries, retryOnClientError: false });
+}
+export async function fetchAllPages(endpointKey, params = {}, pathParams, maxPages) {
+    const requestParams = { ...params };
+    requestParams.per_page ??= DEFAULT_PER_PAGE;
+    if (!endpointKey.includes("search"))
+        requestParams.sort_by ??= DEFAULT_SORT;
+    const allItems = [];
+    let page = 1;
+    while (true) {
+        if (maxPages && page > maxPages)
+            break;
+        requestParams.page = page;
+        const data = await apiGet(endpointKey, requestParams, pathParams);
+        const items = Array.isArray(data.items) ? data.items : [];
+        allItems.push(...items);
+        const pagination = data.pagination && typeof data.pagination === "object" ? data.pagination : {};
+        const totalPages = Number(pagination.total_pages ?? 1);
+        if (page >= totalPages)
+            break;
+        page += 1;
+        await sleep(200);
+    }
+    return allItems;
+}
+export async function fetchAllPagesByDateSegments(endpointKey, startDate, endDate, params = {}) {
+    const allItems = [];
+    const start = new Date(startDate.replace("Z", "+00:00"));
+    const end = new Date(endDate.replace("Z", "+00:00"));
+    const segmentMs = 30 * 86_400_000;
+    for (let current = start.getTime(); current < end.getTime(); current += segmentMs) {
+        const segmentEnd = Math.min(current + segmentMs, end.getTime());
+        const segmentParams = {
+            ...params,
+            created_after: new Date(current).toISOString().replace(".000Z", "Z"),
+            created_before: new Date(segmentEnd).toISOString().replace(".000Z", "Z"),
+        };
+        allItems.push(...(await fetchAllPages(endpointKey, segmentParams)));
+    }
+    return allItems;
+}
+//# 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,8 @@
+export declare const BASE_URL = "https://open.shopline.io";
+export declare const DEFAULT_PER_PAGE = 50;
+export declare const DEFAULT_SORT = "desc";
+export declare const ENDPOINTS: Record<string, string>;
+export declare function getAccessToken(): string;
+export declare function getHeaders(): Record<string, string>;
+export declare function getUrl(endpointKey: string, pathParams?: Record<string, unknown>): string;
+export declare function endpointPathParams(endpointKey: string): string[];

package/dist/config.js

@@ -0,0 +1,37 @@
+import { endpoints } from "./generated/endpoints.js";
+export const BASE_URL = "https://open.shopline.io";
+export const DEFAULT_PER_PAGE = 50;
+export const DEFAULT_SORT = "desc";
+export const ENDPOINTS = { ...endpoints };
+export function getAccessToken() {
+    const token = process.env.SHOPLINE_API_TOKEN ?? "";
+    if (!token) {
+        throw new Error("SHOPLINE_API_TOKEN environment variable is not set. Run: export SHOPLINE_API_TOKEN=your_token_here");
+    }
+    return token;
+}
+export function getHeaders() {
+    return {
+        Authorization: `Bearer ${getAccessToken()}`,
+        "Content-Type": "application/json",
+    };
+}
+export function getUrl(endpointKey, pathParams = {}) {
+    const template = ENDPOINTS[endpointKey];
+    if (!template) {
+        throw new Error(`Unknown Shopline endpoint key: ${endpointKey}`);
+    }
+    const path = template.replace(/\{(\w+)\}/g, (_, key) => {
+        const value = pathParams[key];
+        if (value === undefined || value === null || value === "") {
+            throw new Error(`Missing path parameter "${key}" for endpoint "${endpointKey}"`);
+        }
+        return encodeURIComponent(String(value));
+    });
+    return `${BASE_URL}${path}`;
+}
+export function endpointPathParams(endpointKey) {
+    const template = ENDPOINTS[endpointKey] ?? "";
+    return [...template.matchAll(/\{(\w+)\}/g)].map((match) => match[1] ?? "");
+}
+//# 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,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,CAAC,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,SAAS,GAA2B,EAAE,GAAG,SAAS,EAAE,CAAC;AAElE,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,aAAa,EAAE,UAAU,cAAc,EAAE,EAAE;QAC3C,cAAc,EAAE,kBAAkB;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,WAAmB,EAAE,aAAsC,EAAE;IAClF,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,mBAAmB,WAAW,GAAG,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/generated/endpoints.d.ts

@@ -0,0 +1,137 @@
+export declare const endpoints: {
+    readonly orders: "/v1/orders";
+    readonly orders_search: "/v1/orders/search";
+    readonly order_detail: "/v1/orders/{order_id}";
+    readonly order_labels: "/v1/orders/{order_id}/labels";
+    readonly order_tags: "/v1/orders/{order_id}/tags";
+    readonly order_action_logs: "/v1/orders/{order_id}/action-logs";
+    readonly order_transactions: "/v1/orders/{order_id}/transactions";
+    readonly orders_archived: "/v1/orders/archived";
+    readonly order_create: "/v1/orders";
+    readonly order_update: "/v1/orders/{order_id}";
+    readonly order_shipment: "/v1/orders/{order_id}/shipment";
+    readonly orders_shipment_bulk: "/v1/orders/shipment/bulk";
+    readonly order_split: "/v1/orders/{order_id}/split";
+    readonly order_cancel: "/v1/orders/{order_id}/cancel";
+    readonly order_status: "/v1/orders/{order_id}/status";
+    readonly order_delivery_status: "/v1/orders/{order_id}/delivery-status";
+    readonly order_payment_status: "/v1/orders/{order_id}/payment-status";
+    readonly order_tags_update: "/v1/orders/{order_id}/tags";
+    readonly customers: "/v1/customers";
+    readonly customers_search: "/v1/customers/search";
+    readonly customer_detail: "/v1/customers/{customer_id}";
+    readonly customer_store_credit_history: "/v1/customers/{customer_id}/store-credit-history";
+    readonly customer_member_points: "/v1/customers/{customer_id}/member-points";
+    readonly customer_promotions: "/v1/customers/{customer_id}/promotions";
+    readonly customer_create: "/v1/customers";
+    readonly customer_update: "/v1/customers/{customer_id}";
+    readonly customer_delete: "/v1/customers/{customer_id}";
+    readonly customer_tags: "/v1/customers/{customer_id}/tags";
+    readonly customer_store_credits_update: "/v1/customers/{customer_id}/store-credits";
+    readonly customer_member_points_update: "/v1/customers/{customer_id}/member-points";
+    readonly customer_groups: "/v1/customer-groups";
+    readonly customer_groups_search: "/v1/customer-groups/search";
+    readonly customer_group_customers: "/v1/customer-groups/{group_id}/customers";
+    readonly user_credits: "/v1/user_credits";
+    readonly custom_fields: "/v1/custom_fields";
+    readonly membership_tiers: "/v1/membership_tiers";
+    readonly customer_membership_tier_history: "/v1/customers/{customer_id}/membership-tier-history";
+    readonly member_point_rules: "/v1/member_point_rules";
+    readonly products: "/v1/products";
+    readonly products_search: "/v1/products/search";
+    readonly product_detail: "/v1/products/{product_id}";
+    readonly product_stocks: "/v1/products/{product_id}/stocks";
+    readonly products_locked_inventory: "/v1/products/locked-inventory";
+    readonly product_create: "/v1/products";
+    readonly product_update: "/v1/products/{product_id}";
+    readonly product_delete: "/v1/products/{product_id}";
+    readonly product_images: "/v1/products/{product_id}/images";
+    readonly product_variations_create: "/v1/products/{product_id}/variations";
+    readonly product_variation_update: "/v1/products/{product_id}/variations/{variation_id}";
+    readonly product_variation_delete: "/v1/products/{product_id}/variations/{variation_id}";
+    readonly product_variation_quantity: "/v1/products/{product_id}/variations/{variation_id}/quantity";
+    readonly product_variation_price: "/v1/products/{product_id}/variations/{variation_id}/price";
+    readonly product_quantity: "/v1/products/{product_id}/quantity";
+    readonly product_price: "/v1/products/{product_id}/price";
+    readonly product_tags: "/v1/products/{product_id}/tags";
+    readonly products_bulk_quantities: "/v1/products/bulk-update-quantities";
+    readonly products_bulk_categories: "/v1/products/bulk-assign-categories";
+    readonly categories: "/v1/categories";
+    readonly category_detail: "/v1/categories/{category_id}";
+    readonly category_create: "/v1/categories";
+    readonly category_update: "/v1/categories/{category_id}";
+    readonly category_delete: "/v1/categories/{category_id}";
+    readonly promotions: "/v1/promotions";
+    readonly promotion_detail: "/v1/promotions/{promotion_id}";
+    readonly promotions_search: "/v1/promotions/search";
+    readonly promotion_create: "/v1/promotions";
+    readonly promotion_update: "/v1/promotions/{promotion_id}";
+    readonly promotion_delete: "/v1/promotions/{promotion_id}";
+    readonly coupon_send: "/v1/coupons/send";
+    readonly coupon_redeem: "/v1/coupons/redeem";
+    readonly coupon_claim: "/v1/coupons/claim";
+    readonly warehouses: "/v1/warehouses";
+    readonly return_orders: "/v1/return_orders";
+    readonly return_order_detail: "/v1/return_orders/{return_order_id}";
+    readonly return_order_create: "/v1/return_orders";
+    readonly return_order_update: "/v1/return_orders/{return_order_id}";
+    readonly channels: "/v1/channels";
+    readonly channel_detail: "/v1/channels/{channel_id}";
+    readonly token_info: "/v1/token/info";
+    readonly conversations: "/v1/conversations";
+    readonly conversation_messages: "/v1/conversations/{conversation_id}/messages";
+    readonly conversation_order_message: "/v1/conversations/order-messages";
+    readonly conversation_shop_message: "/v1/conversations/shop-messages";
+    readonly gifts: "/v1/gifts";
+    readonly gifts_search: "/v1/gifts/search";
+    readonly gift_create: "/v1/gifts";
+    readonly gift_update: "/v1/gifts/{gift_id}";
+    readonly gift_quantity_by_sku: "/v1/gifts/quantity-by-sku";
+    readonly addon_products: "/v1/addon_products";
+    readonly addon_products_search: "/v1/addon_products/search";
+    readonly addon_product_create: "/v1/addon_products";
+    readonly addon_product_update: "/v1/addon_products/{addon_product_id}";
+    readonly addon_product_quantity: "/v1/addon_products/{addon_product_id}/quantity";
+    readonly addon_product_sku_quantity: "/v1/addon_products/sku/quantity";
+    readonly settings_app: "/v1/settings/app";
+    readonly payments: "/v1/payments";
+    readonly delivery_options: "/v1/delivery_options";
+    readonly delivery_option_detail: "/v1/delivery_options/{delivery_option_id}";
+    readonly delivery_option_time_slots: "/v1/delivery_options/{delivery_option_id}/time_slots";
+    readonly delivery_option_pickup_store: "/v1/delivery_options/{delivery_option_id}/pickup_store";
+    readonly merchants: "/v1/merchants";
+    readonly merchant_detail: "/v1/merchants/{merchant_id}";
+    readonly merchant_update: "/v1/merchants/{merchant_id}";
+    readonly staff_permissions: "/v1/staffs/{staff_id}/permissions";
+    readonly taxes: "/v1/taxes";
+    readonly product_review_comments: "/v1/product_review_comments";
+    readonly product_review_comment_detail: "/v1/product_review_comments/{comment_id}";
+    readonly product_review_comment_create: "/v1/product_review_comments";
+    readonly product_review_comments_bulk_create: "/v1/product_review_comments/bulk";
+    readonly product_review_comment_update: "/v1/product_review_comments/{comment_id}";
+    readonly product_review_comments_bulk_update: "/v1/product_review_comments";
+    readonly product_review_comment_delete: "/v1/product_review_comments/{comment_id}";
+    readonly product_review_comments_bulk_delete: "/v1/product_review_comments";
+    readonly agents: "/v1/agents";
+    readonly product_subscriptions: "/v1/product_subscriptions";
+    readonly product_subscription_detail: "/v1/product_subscriptions/{subscription_id}";
+    readonly media_create: "/v1/media";
+    readonly order_delivery_detail: "/v1/order_deliveries/{delivery_id}";
+    readonly order_delivery_update: "/v1/order_deliveries/{delivery_id}";
+    readonly flash_price_campaigns: "/v1/flash_price_campaigns";
+    readonly flash_price_campaign_detail: "/v1/flash_price_campaigns/{campaign_id}";
+    readonly flash_price_campaign_create: "/v1/flash_price_campaigns";
+    readonly flash_price_campaign_update: "/v1/flash_price_campaigns/{campaign_id}";
+    readonly flash_price_campaign_delete: "/v1/flash_price_campaigns/{campaign_id}";
+    readonly affiliate_campaigns: "/v1/affiliate_campaigns";
+    readonly affiliate_campaign_detail: "/v1/affiliate_campaigns/{campaign_id}";
+    readonly affiliate_campaign_order_usage: "/v1/affiliate_campaigns/{campaign_id}/order_usage";
+    readonly affiliate_campaign_create: "/v1/affiliate_campaigns";
+    readonly affiliate_campaign_update: "/v1/affiliate_campaigns/{campaign_id}";
+    readonly affiliate_campaign_delete: "/v1/affiliate_campaigns/{campaign_id}";
+    readonly metafield_create: "/merchants/current/app-metafields";
+    readonly purchase_orders: "/v1/pos/purchase_orders";
+    readonly purchase_order_detail: "/v1/pos/purchase_orders/{purchase_order_id}";
+    readonly purchase_order_create: "/v1/pos/purchase_orders";
+    readonly purchase_order_delete: "/v1/pos/purchase_orders";
+};