@unclick/mcp-server 0.2.3 → 0.2.5

package/dist/stability-tool.js

@@ -0,0 +1,190 @@
+// Stability AI API integration for the UnClick MCP server.
+// Uses the Stability AI REST API via fetch - no external dependencies.
+// Users must supply an API key from platform.stability.ai.
+const STABILITY_API_BASE = "https://api.stability.ai";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at platform.stability.ai.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function stabilityGet(apiKey, path) {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        const id = data.id ? ` (id: ${data.id})` : "";
+        throw new Error(`Stability AI error${id}: ${msg}`);
+    }
+    return data;
+}
+async function stabilityPost(apiKey, path, body, acceptHeader = "application/json") {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            Accept: acceptHeader,
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        const id = data.id ? ` (id: ${data.id})` : "";
+        throw new Error(`Stability AI error${id}: ${msg}`);
+    }
+    return data;
+}
+async function stabilityPostMultipart(apiKey, path, form) {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+        },
+        body: form,
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        throw new Error(`Stability AI error: ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function stabilityTextToImage(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    const engineId = String(args.engine_id ?? "stable-diffusion-xl-1024-v1-0");
+    const negativePrompt = String(args.negative_prompt ?? "").trim();
+    const width = Number(args.width ?? 1024);
+    const height = Number(args.height ?? 1024);
+    const steps = Math.min(150, Math.max(10, Number(args.steps ?? 30)));
+    const cfgScale = Math.min(35, Math.max(0, Number(args.cfg_scale ?? 7)));
+    const samples = Math.min(10, Math.max(1, Number(args.samples ?? 1)));
+    const stylePreset = args.style_preset ? String(args.style_preset) : undefined;
+    const textPrompts = [{ text: prompt, weight: 1 }];
+    if (negativePrompt)
+        textPrompts.push({ text: negativePrompt, weight: -1 });
+    const body = {
+        text_prompts: textPrompts,
+        cfg_scale: cfgScale,
+        height,
+        width,
+        steps,
+        samples,
+    };
+    if (stylePreset)
+        body.style_preset = stylePreset;
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await stabilityPost(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/text-to-image`, body);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+            note: "Decode base64 and write as PNG to save the image.",
+        })),
+    };
+}
+export async function stabilityImageToImage(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    const imageUrl = String(args.image_url ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    if (!imageUrl)
+        throw new Error("image_url is required (URL of the source image).");
+    const engineId = String(args.engine_id ?? "stable-diffusion-xl-1024-v1-0");
+    const strength = Math.min(1, Math.max(0, Number(args.strength ?? 0.35)));
+    const steps = Math.min(150, Math.max(10, Number(args.steps ?? 30)));
+    const cfgScale = Math.min(35, Math.max(0, Number(args.cfg_scale ?? 7)));
+    const samples = Math.min(10, Math.max(1, Number(args.samples ?? 1)));
+    // Fetch the source image
+    const imgRes = await fetch(imageUrl);
+    if (!imgRes.ok)
+        throw new Error(`Failed to fetch image_url: HTTP ${imgRes.status}`);
+    const imgBlob = await imgRes.blob();
+    const form = new FormData();
+    form.append("init_image", imgBlob, "init_image.png");
+    form.append("init_image_mode", "IMAGE_STRENGTH");
+    form.append("image_strength", String(strength));
+    form.append("text_prompts[0][text]", prompt);
+    form.append("text_prompts[0][weight]", "1");
+    const negativePrompt = String(args.negative_prompt ?? "").trim();
+    if (negativePrompt) {
+        form.append("text_prompts[1][text]", negativePrompt);
+        form.append("text_prompts[1][weight]", "-1");
+    }
+    form.append("cfg_scale", String(cfgScale));
+    form.append("steps", String(steps));
+    form.append("samples", String(samples));
+    const result = await stabilityPostMultipart(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/image-to-image`, form);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+            note: "Decode base64 and write as PNG to save the image.",
+        })),
+    };
+}
+export async function stabilityUpscale(args) {
+    const apiKey = requireKey(args);
+    const imageUrl = String(args.image_url ?? "").trim();
+    if (!imageUrl)
+        throw new Error("image_url is required (URL of the image to upscale).");
+    const width = Number(args.width ?? 2048);
+    const engineId = String(args.engine_id ?? "esrgan-v1-x2plus");
+    // Fetch source image
+    const imgRes = await fetch(imageUrl);
+    if (!imgRes.ok)
+        throw new Error(`Failed to fetch image_url: HTTP ${imgRes.status}`);
+    const imgBlob = await imgRes.blob();
+    const form = new FormData();
+    form.append("image", imgBlob, "image.png");
+    form.append("width", String(width));
+    const result = await stabilityPostMultipart(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/image-to-image/upscale`, form);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+        })),
+    };
+}
+export async function stabilityListEngines(args) {
+    const apiKey = requireKey(args);
+    const engines = await stabilityGet(apiKey, "/v1/engines/list");
+    return {
+        count: engines.length,
+        engines: engines.map((e) => ({
+            id: e.id,
+            name: e.name,
+            description: e.description,
+            type: e.type,
+            ready: e.ready,
+        })),
+    };
+}
+//# sourceMappingURL=stability-tool.js.map

package/dist/stability-tool.js.map

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

package/dist/steam-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function getSteamPlayerSummaries(args: Record<string, unknown>): Promise<unknown>;
+export declare function getSteamOwnedGames(args: Record<string, unknown>): Promise<unknown>;
+export declare function getSteamAchievements(args: Record<string, unknown>): Promise<unknown>;
+export declare function getSteamAppDetails(args: Record<string, unknown>): Promise<unknown>;
+export declare function searchSteamStore(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=steam-tool.d.ts.map

package/dist/steam-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam-tool.d.ts","sourceRoot":"","sources":["../src/steam-tool.ts"],"names":[],"mappings":"AAqDA,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC7F;AAGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BxF;AAGD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmC1F;AAGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCxF;AAGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BtF"}

package/dist/steam-tool.js

@@ -0,0 +1,222 @@
+// Steam Web API - player data, games, achievements.
+// Docs: https://developer.valvesoftware.com/wiki/Steam_Web_API
+// Auth: STEAM_API_KEY (API key query param)
+// Base: https://api.steampowered.com
+const STEAM_BASE = "https://api.steampowered.com";
+const STEAM_STORE_BASE = "https://store.steampowered.com/api";
+function getApiKey(args) {
+    const key = String(args.api_key ?? process.env.STEAM_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set STEAM_API_KEY env var).");
+    return key;
+}
+async function steamGet(path, params) {
+    const url = new URL(`${STEAM_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), {
+        headers: { Accept: "application/json" },
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new Error("Invalid Steam API key.");
+    if (res.status === 429)
+        throw new Error("Steam rate limit exceeded.");
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Steam HTTP ${res.status}: ${body || res.statusText}`);
+    }
+    return res.json();
+}
+async function steamStoreGet(path, params) {
+    const url = new URL(`${STEAM_STORE_BASE}${path}`);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== "")
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), {
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Steam Store HTTP ${res.status}: ${body || res.statusText}`);
+    }
+    return res.json();
+}
+// get_steam_player_summaries
+export async function getSteamPlayerSummaries(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const steamids = String(args.steamids ?? "").trim();
+        if (!steamids)
+            return { error: "steamids is required (comma-separated Steam64 IDs, up to 100)." };
+        const json = await steamGet("/ISteamUser/GetPlayerSummaries/v2/", {
+            key: apiKey,
+            steamids,
+        });
+        const response = json.response;
+        const players = (response?.players ?? []);
+        return {
+            count: players.length,
+            players: players.map((p) => ({
+                steamid: p.steamid,
+                personaname: p.personaname,
+                profileurl: p.profileurl,
+                avatar: p.avatarfull,
+                personastate: p.personastate,
+                communityvisibilitystate: p.communityvisibilitystate,
+                country: p.loccountrycode,
+                lastlogoff: p.lastlogoff,
+                timecreated: p.timecreated,
+                gameid: p.gameid,
+                gameextrainfo: p.gameextrainfo,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// get_steam_owned_games
+export async function getSteamOwnedGames(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const steamId = String(args.steamid ?? "").trim();
+        if (!steamId)
+            return { error: "steamid is required (Steam64 ID)." };
+        const params = {
+            key: apiKey,
+            steamid: steamId,
+            format: "json",
+        };
+        if (args.include_appinfo !== false)
+            params.include_appinfo = "1";
+        if (args.include_played_free_games)
+            params.include_played_free_games = "1";
+        const json = await steamGet("/IPlayerService/GetOwnedGames/v1/", params);
+        const response = json.response;
+        const games = (response?.games ?? []);
+        return {
+            game_count: response?.game_count ?? games.length,
+            games: games.map((g) => ({
+                appid: g.appid,
+                name: g.name,
+                playtime_forever: g.playtime_forever,
+                playtime_2weeks: g.playtime_2weeks,
+                img_icon_url: g.img_icon_url,
+                rtime_last_played: g.rtime_last_played,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// get_steam_achievements
+export async function getSteamAchievements(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const steamId = String(args.steamid ?? "").trim();
+        if (!steamId)
+            return { error: "steamid is required." };
+        const appId = String(args.appid ?? "").trim();
+        if (!appId)
+            return { error: "appid is required (the game's Steam App ID)." };
+        const json = await steamGet("/ISteamUserStats/GetPlayerAchievements/v1/", {
+            key: apiKey,
+            steamid: steamId,
+            appid: appId,
+        });
+        const playerstats = json.playerstats;
+        if (playerstats?.error)
+            throw new Error(String(playerstats.error));
+        const achievements = (playerstats?.achievements ?? []);
+        const unlocked = achievements.filter((a) => a.achieved === 1);
+        return {
+            game_name: playerstats?.gameName,
+            steamid: playerstats?.steamID,
+            total: achievements.length,
+            unlocked: unlocked.length,
+            achievements: achievements.map((a) => ({
+                apiname: a.apiname,
+                achieved: a.achieved === 1,
+                unlocktime: a.unlocktime,
+                name: a.name,
+                description: a.description,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// get_steam_app_details
+export async function getSteamAppDetails(args) {
+    try {
+        const appId = String(args.appid ?? "").trim();
+        if (!appId)
+            return { error: "appid is required." };
+        const params = { appids: appId };
+        if (args.cc)
+            params.cc = String(args.cc);
+        if (args.l)
+            params.l = String(args.l);
+        const json = await steamStoreGet("/appdetails", params);
+        const appData = json[appId];
+        if (!appData?.success)
+            return { error: `App ${appId} not found or data unavailable.` };
+        const d = appData.data;
+        return {
+            steam_appid: d?.steam_appid,
+            name: d?.name,
+            type: d?.type,
+            is_free: d?.is_free,
+            short_description: d?.short_description,
+            developers: d?.developers,
+            publishers: d?.publishers,
+            price_overview: d?.price_overview,
+            platforms: d?.platforms,
+            genres: d?.genres,
+            release_date: d?.release_date,
+            metacritic: d?.metacritic,
+            header_image: d?.header_image,
+            website: d?.website,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// search_steam_store
+export async function searchSteamStore(args) {
+    try {
+        const term = String(args.term ?? "").trim();
+        if (!term)
+            return { error: "term is required." };
+        const params = { term };
+        if (args.cc)
+            params.cc = String(args.cc);
+        if (args.l)
+            params.l = String(args.l);
+        const json = await steamStoreGet("/storesearch", params);
+        const items = (json.items ?? []);
+        return {
+            count: items.length,
+            total: json.total,
+            items: items.map((i) => ({
+                id: i.id,
+                name: i.name,
+                type: i.type,
+                tiny_image: i.tiny_image,
+                price: i.price,
+                metascore: i.metascore,
+                platforms: i.platforms,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=steam-tool.js.map

package/dist/steam-tool.js.map

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

package/dist/stripe-tool.d.ts

@@ -0,0 +1,7 @@
+export declare function stripeCustomers(args: Record<string, unknown>): Promise<unknown>;
+export declare function stripeCharges(args: Record<string, unknown>): Promise<unknown>;
+export declare function stripeSubscriptions(args: Record<string, unknown>): Promise<unknown>;
+export declare function stripeInvoices(args: Record<string, unknown>): Promise<unknown>;
+export declare function stripeProducts(args: Record<string, unknown>): Promise<unknown>;
+export declare function stripePrices(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=stripe-tool.d.ts.map

package/dist/stripe-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-tool.d.ts","sourceRoot":"","sources":["../src/stripe-tool.ts"],"names":[],"mappings":"AAgFA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBrF;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BnF;AAID,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzF;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWpF;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASpF;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlF"}

package/dist/stripe-tool.js

@@ -0,0 +1,181 @@
+// ─── Stripe REST API Tool ────────────────────────────────────────────────────
+// Covers customers, charges, subscriptions, invoices, products, and prices.
+// Auth: Secret key (Bearer token - sk_live_* or sk_test_*).
+// Base URL: https://api.stripe.com/v1
+// No external dependencies - native fetch only.
+const STRIPE_BASE = "https://api.stripe.com/v1";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function requireConfig(args) {
+    const secret_key = String(args.secret_key ?? "").trim();
+    if (!secret_key)
+        return { error: "secret_key is required (Stripe secret key, starts with sk_)." };
+    return { secret_key };
+}
+async function stripeFetch(cfg, method, path, params) {
+    const url = new URL(`${STRIPE_BASE}${path}`);
+    let body;
+    if (method === "GET" && params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    else if (method === "POST" && params) {
+        const form = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                form.set(k, String(v));
+        }
+        body = form.toString();
+    }
+    let response;
+    try {
+        response = await fetch(url.toString(), {
+            method,
+            headers: {
+                Authorization: `Bearer ${cfg.secret_key}`,
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body,
+        });
+    }
+    catch (err) {
+        return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 429) {
+        const retryAfter = response.headers.get("Retry-After");
+        return { error: "Stripe rate limit reached.", retry_after: retryAfter ? Number(retryAfter) : 5, status: 429 };
+    }
+    if (response.status === 401 || response.status === 403) {
+        return { error: "Stripe auth failed: invalid secret key.", status: response.status };
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        return { error: `Non-JSON response (HTTP ${response.status})`, status: response.status };
+    }
+    if (!response.ok) {
+        const d = data;
+        const err = d["error"];
+        return { error: err?.["message"] ?? d["message"] ?? "Stripe API error", status: response.status };
+    }
+    return data;
+}
+// ─── stripe_customers ─────────────────────────────────────────────────────────
+export async function stripeCustomers(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const action = String(args.action ?? "list");
+    switch (action) {
+        case "list": {
+            return stripeFetch(cfg, "GET", "/customers", {
+                limit: args.limit ? Number(args.limit) : 20,
+                starting_after: args.starting_after ? String(args.starting_after) : undefined,
+                email: args.email ? String(args.email) : undefined,
+            });
+        }
+        case "create": {
+            const params = {};
+            if (args.email)
+                params["email"] = String(args.email);
+            if (args.name)
+                params["name"] = String(args.name);
+            if (args.phone)
+                params["phone"] = String(args.phone);
+            if (args.description)
+                params["description"] = String(args.description);
+            return stripeFetch(cfg, "POST", "/customers", params);
+        }
+        default:
+            return { error: `Unknown action "${action}". Valid: list, create.` };
+    }
+}
+// ─── stripe_charges ───────────────────────────────────────────────────────────
+export async function stripeCharges(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const action = String(args.action ?? "list");
+    switch (action) {
+        case "list": {
+            return stripeFetch(cfg, "GET", "/charges", {
+                limit: args.limit ? Number(args.limit) : 20,
+                starting_after: args.starting_after ? String(args.starting_after) : undefined,
+                customer: args.customer ? String(args.customer) : undefined,
+                created: args.created ? Number(args.created) : undefined,
+            });
+        }
+        case "create": {
+            const amount = Number(args.amount ?? 0);
+            const currency = String(args.currency ?? "").trim();
+            if (!amount)
+                return { error: "amount is required for action='create' (in smallest currency unit, e.g. cents)." };
+            if (!currency)
+                return { error: "currency is required for action='create' (e.g. 'usd')." };
+            const params = { amount, currency };
+            if (args.source)
+                params["source"] = String(args.source);
+            if (args.customer)
+                params["customer"] = String(args.customer);
+            if (args.description)
+                params["description"] = String(args.description);
+            return stripeFetch(cfg, "POST", "/charges", params);
+        }
+        default:
+            return { error: `Unknown action "${action}". Valid: list, create.` };
+    }
+}
+// ─── stripe_subscriptions ─────────────────────────────────────────────────────
+export async function stripeSubscriptions(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return stripeFetch(cfg, "GET", "/subscriptions", {
+        limit: args.limit ? Number(args.limit) : 20,
+        starting_after: args.starting_after ? String(args.starting_after) : undefined,
+        customer: args.customer ? String(args.customer) : undefined,
+        status: args.status ? String(args.status) : undefined,
+        price: args.price ? String(args.price) : undefined,
+    });
+}
+// ─── stripe_invoices ──────────────────────────────────────────────────────────
+export async function stripeInvoices(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return stripeFetch(cfg, "GET", "/invoices", {
+        limit: args.limit ? Number(args.limit) : 20,
+        starting_after: args.starting_after ? String(args.starting_after) : undefined,
+        customer: args.customer ? String(args.customer) : undefined,
+        status: args.status ? String(args.status) : undefined,
+        subscription: args.subscription ? String(args.subscription) : undefined,
+    });
+}
+// ─── stripe_products ──────────────────────────────────────────────────────────
+export async function stripeProducts(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return stripeFetch(cfg, "GET", "/products", {
+        limit: args.limit ? Number(args.limit) : 20,
+        starting_after: args.starting_after ? String(args.starting_after) : undefined,
+        active: args.active !== undefined ? (args.active ? "true" : "false") : undefined,
+    });
+}
+// ─── stripe_prices ────────────────────────────────────────────────────────────
+export async function stripePrices(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return stripeFetch(cfg, "GET", "/prices", {
+        limit: args.limit ? Number(args.limit) : 20,
+        starting_after: args.starting_after ? String(args.starting_after) : undefined,
+        product: args.product ? String(args.product) : undefined,
+        active: args.active !== undefined ? (args.active ? "true" : "false") : undefined,
+        type: args.type ? String(args.type) : undefined,
+    });
+}
+//# sourceMappingURL=stripe-tool.js.map