@unclick/mcp-server 0.2.3 → 0.2.5

package/dist/heygen-tool.js

@@ -0,0 +1,134 @@
+// HeyGen API integration for the UnClick MCP server.
+// Uses the HeyGen REST API via fetch - no external dependencies.
+// Users must supply an API key from app.heygen.com/settings.
+const HG_API_BASE = "https://api.heygen.com";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at app.heygen.com/settings.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function hgGet(apiKey, path) {
+    const res = await fetch(`${HG_API_BASE}${path}`, {
+        headers: {
+            "x-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`HeyGen error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+async function hgPost(apiKey, path, body) {
+    const res = await fetch(`${HG_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            "x-api-key": apiKey,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`HeyGen error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function heygen_create_avatar_video(args) {
+    const apiKey = requireKey(args);
+    const avatarId = String(args.avatar_id ?? "").trim();
+    const script = String(args.script ?? "").trim();
+    if (!avatarId)
+        throw new Error("avatar_id is required.");
+    if (!script)
+        throw new Error("script is required (the text the avatar will speak).");
+    const voiceId = args.voice_id ? String(args.voice_id) : undefined;
+    const backgroundUrl = args.background_url ? String(args.background_url) : undefined;
+    const width = args.width ? Number(args.width) : 1280;
+    const height = args.height ? Number(args.height) : 720;
+    const body = {
+        video_inputs: [
+            {
+                character: {
+                    type: "avatar",
+                    avatar_id: avatarId,
+                    avatar_style: args.avatar_style ?? "normal",
+                },
+                voice: voiceId
+                    ? { type: "text", input_text: script, voice_id: voiceId }
+                    : { type: "text", input_text: script },
+                background: backgroundUrl
+                    ? { type: "image", url: backgroundUrl }
+                    : { type: "color", value: "#ffffff" },
+            },
+        ],
+        dimension: { width, height },
+    };
+    if (args.title)
+        body.title = String(args.title);
+    if (args.test !== undefined)
+        body.test = Boolean(args.test);
+    const result = await hgPost(apiKey, "/v2/video/generate", body);
+    const videoId = (result.data?.video_id ?? result.video_id);
+    return {
+        video_id: videoId ?? null,
+        status: "submitted",
+        note: "Use heygen_get_video_status with the video_id to poll for completion.",
+        raw: result,
+    };
+}
+export async function heygen_list_avatars(args) {
+    const apiKey = requireKey(args);
+    const data = await hgGet(apiKey, "/v2/avatars");
+    const avatars = data.data?.avatars ?? [];
+    return {
+        count: avatars.length,
+        avatars: avatars.map((a) => ({
+            avatar_id: a.avatar_id,
+            name: a.avatar_name,
+            gender: a.gender ?? null,
+            preview_image_url: a.preview_image_url ?? null,
+        })),
+    };
+}
+export async function heygen_get_video_status(args) {
+    const apiKey = requireKey(args);
+    const videoId = String(args.video_id ?? "").trim();
+    if (!videoId)
+        throw new Error("video_id is required.");
+    const data = await hgGet(apiKey, `/v1/video_status.get?video_id=${encodeURIComponent(videoId)}`);
+    const info = data.data ?? data;
+    return {
+        video_id: videoId,
+        status: info.status ?? null,
+        video_url: info.video_url ?? null,
+        thumbnail_url: info.thumbnail_url ?? null,
+        duration: info.duration ?? null,
+        created_at: info.created_at ?? null,
+        error: info.error ?? null,
+        raw: data,
+    };
+}
+export async function heygen_list_voices(args) {
+    const apiKey = requireKey(args);
+    const data = await hgGet(apiKey, "/v2/voices");
+    const voices = data.data?.voices ?? [];
+    return {
+        count: voices.length,
+        voices: voices.map((v) => ({
+            voice_id: v.voice_id,
+            name: v.name,
+            language: v.language,
+            gender: v.gender,
+            preview_audio: v.preview_audio ?? null,
+        })),
+    };
+}
+//# sourceMappingURL=heygen-tool.js.map

package/dist/heygen-tool.js.map

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

package/dist/higgsfield-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function higgsfield_generate_video(args: Record<string, unknown>): Promise<unknown>;
+export declare function higgsfield_generate_image(args: Record<string, unknown>): Promise<unknown>;
+export declare function higgsfield_get_styles(args: Record<string, unknown>): Promise<unknown>;
+export declare function higgsfield_get_status(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=higgsfield-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"higgsfield-tool.d.ts","sourceRoot":"","sources":["../src/higgsfield-tool.ts"],"names":[],"mappings":"AAoDA,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB/F;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB/F;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3F;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB3F"}

package/dist/higgsfield-tool.js

@@ -0,0 +1,120 @@
+// Higgsfield AI API integration for the UnClick MCP server.
+// Uses the Higgsfield REST API via fetch - no external dependencies.
+// Users must supply an API key from higgsfield.ai.
+const HF_API_BASE = "https://api.higgsfield.ai/v1";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at higgsfield.ai.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function hfGet(apiKey, path) {
+    const res = await fetch(`${HF_API_BASE}${path}`, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Higgsfield error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+async function hfPost(apiKey, path, body) {
+    const res = await fetch(`${HF_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? data.error ?? `HTTP ${res.status}`;
+        throw new Error(`Higgsfield error (${res.status}): ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function higgsfield_generate_video(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    const body = { prompt };
+    if (args.style)
+        body.style = String(args.style);
+    if (args.duration)
+        body.duration = Number(args.duration);
+    if (args.aspect_ratio)
+        body.aspect_ratio = String(args.aspect_ratio);
+    if (args.negative_prompt)
+        body.negative_prompt = String(args.negative_prompt);
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await hfPost(apiKey, "/video/generate", body);
+    return {
+        generation_id: result.id ?? result.generation_id ?? null,
+        status: result.status ?? "submitted",
+        prompt,
+        note: "Use higgsfield_get_status with the generation_id to poll for completion.",
+        raw: result,
+    };
+}
+export async function higgsfield_generate_image(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    const body = { prompt };
+    if (args.style)
+        body.style = String(args.style);
+    if (args.width)
+        body.width = Number(args.width);
+    if (args.height)
+        body.height = Number(args.height);
+    if (args.negative_prompt)
+        body.negative_prompt = String(args.negative_prompt);
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await hfPost(apiKey, "/image/generate", body);
+    return {
+        generation_id: result.id ?? result.generation_id ?? null,
+        status: result.status ?? "submitted",
+        image_url: result.image_url ?? result.url ?? null,
+        prompt,
+        raw: result,
+    };
+}
+export async function higgsfield_get_styles(args) {
+    const apiKey = requireKey(args);
+    const data = await hfGet(apiKey, "/styles");
+    const styles = data.styles ?? data.data ?? [];
+    return {
+        count: Array.isArray(styles) ? styles.length : 0,
+        styles,
+    };
+}
+export async function higgsfield_get_status(args) {
+    const apiKey = requireKey(args);
+    const generationId = String(args.generation_id ?? "").trim();
+    if (!generationId)
+        throw new Error("generation_id is required.");
+    const result = await hfGet(apiKey, `/generation/${encodeURIComponent(generationId)}`);
+    return {
+        generation_id: generationId,
+        status: result.status ?? null,
+        video_url: result.video_url ?? result.url ?? null,
+        image_url: result.image_url ?? null,
+        created_at: result.created_at ?? null,
+        completed_at: result.completed_at ?? null,
+        error: result.error ?? null,
+        raw: result,
+    };
+}
+//# sourceMappingURL=higgsfield-tool.js.map

package/dist/higgsfield-tool.js.map

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

package/dist/igdb-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function igdbSearchGames(args: Record<string, unknown>): Promise<unknown>;
+export declare function igdbGetGame(args: Record<string, unknown>): Promise<unknown>;
+export declare function igdbListPlatforms(args: Record<string, unknown>): Promise<unknown>;
+export declare function igdbListGenres(args: Record<string, unknown>): Promise<unknown>;
+export declare function igdbGetCompany(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=igdb-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"igdb-tool.d.ts","sourceRoot":"","sources":["../src/igdb-tool.ts"],"names":[],"mappings":"AAsEA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAarF;AAGD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAajF;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvF;AAGD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpF;AAGD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBpF"}

package/dist/igdb-tool.js

@@ -0,0 +1,140 @@
+// IGDB games database API (powered by Twitch).
+// Docs: https://api-docs.igdb.com/
+// Auth: IGDB_CLIENT_ID + IGDB_CLIENT_SECRET (Twitch OAuth2 app credentials)
+// Base: https://api.igdb.com/v4
+// Token endpoint: https://id.twitch.tv/oauth2/token (client_credentials grant)
+const IGDB_BASE = "https://api.igdb.com/v4";
+const TWITCH_TOKEN_URL = "https://id.twitch.tv/oauth2/token";
+// Simple in-process token cache (resets on restart)
+let cachedToken = null;
+function getCredentials(args) {
+    const clientId = String(args.client_id ?? process.env.IGDB_CLIENT_ID ?? "").trim();
+    const clientSecret = String(args.client_secret ?? process.env.IGDB_CLIENT_SECRET ?? "").trim();
+    if (!clientId)
+        throw new Error("client_id is required (or set IGDB_CLIENT_ID env var).");
+    if (!clientSecret)
+        throw new Error("client_secret is required (or set IGDB_CLIENT_SECRET env var).");
+    return { clientId, clientSecret };
+}
+async function getTwitchToken(clientId, clientSecret) {
+    if (cachedToken && Date.now() < cachedToken.expires)
+        return cachedToken.token;
+    const res = await fetch(`${TWITCH_TOKEN_URL}?client_id=${encodeURIComponent(clientId)}&client_secret=${encodeURIComponent(clientSecret)}&grant_type=client_credentials`, { method: "POST" });
+    if (res.status === 400 || res.status === 401) {
+        throw new Error("Invalid IGDB credentials. Check your client_id and client_secret.");
+    }
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Twitch token request failed HTTP ${res.status}: ${body}`);
+    }
+    const json = await res.json();
+    const token = String(json.access_token ?? "");
+    const expiresIn = Number(json.expires_in ?? 3600);
+    cachedToken = { token, expires: Date.now() + (expiresIn - 60) * 1000 };
+    return token;
+}
+async function igdbPost(clientId, token, endpoint, body) {
+    const res = await fetch(`${IGDB_BASE}${endpoint}`, {
+        method: "POST",
+        headers: {
+            "Client-ID": clientId,
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "text/plain",
+            Accept: "application/json",
+        },
+        body,
+    });
+    if (res.status === 401) {
+        cachedToken = null;
+        throw new Error("IGDB token expired or invalid. Try again.");
+    }
+    if (res.status === 429)
+        throw new Error("IGDB rate limit exceeded.");
+    if (!res.ok) {
+        const b = await res.text().catch(() => "");
+        throw new Error(`IGDB HTTP ${res.status}: ${b || res.statusText}`);
+    }
+    return res.json();
+}
+// igdb_search_games
+export async function igdbSearchGames(args) {
+    try {
+        const { clientId, clientSecret } = getCredentials(args);
+        const token = await getTwitchToken(clientId, clientSecret);
+        const query = String(args.query ?? "").trim();
+        if (!query)
+            return { error: "query is required." };
+        const limit = Math.min(Number(args.limit ?? 10), 50);
+        const body = `search "${query}"; fields id,name,summary,genres.name,platforms.name,release_dates.human,rating,rating_count,cover.url,url; limit ${limit};`;
+        return igdbPost(clientId, token, "/games", body);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// igdb_get_game
+export async function igdbGetGame(args) {
+    try {
+        const { clientId, clientSecret } = getCredentials(args);
+        const token = await getTwitchToken(clientId, clientSecret);
+        const gameId = String(args.game_id ?? "").trim();
+        if (!gameId)
+            return { error: "game_id is required." };
+        const body = `fields id,name,summary,storyline,genres.name,platforms.name,involved_companies.company.name,involved_companies.developer,involved_companies.publisher,release_dates.human,rating,rating_count,aggregated_rating,aggregated_rating_count,cover.url,screenshots.url,websites.url,url; where id = ${gameId};`;
+        const result = await igdbPost(clientId, token, "/games", body);
+        return result[0] ?? { error: "Game not found." };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// igdb_list_platforms
+export async function igdbListPlatforms(args) {
+    try {
+        const { clientId, clientSecret } = getCredentials(args);
+        const token = await getTwitchToken(clientId, clientSecret);
+        const limit = Math.min(Number(args.limit ?? 30), 500);
+        const offset = Number(args.offset ?? 0);
+        const body = `fields id,name,abbreviation,alternative_name,platform_family.name,generation; sort name asc; limit ${limit}; offset ${offset};`;
+        return igdbPost(clientId, token, "/platforms", body);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// igdb_list_genres
+export async function igdbListGenres(args) {
+    try {
+        const { clientId, clientSecret } = getCredentials(args);
+        const token = await getTwitchToken(clientId, clientSecret);
+        const body = `fields id,name,slug,url; sort name asc; limit 50;`;
+        return igdbPost(clientId, token, "/genres", body);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// igdb_get_company
+export async function igdbGetCompany(args) {
+    try {
+        const { clientId, clientSecret } = getCredentials(args);
+        const token = await getTwitchToken(clientId, clientSecret);
+        const name = String(args.name ?? "").trim();
+        const companyId = String(args.company_id ?? "").trim();
+        if (!name && !companyId)
+            return { error: "Either name or company_id is required." };
+        let body;
+        if (companyId) {
+            body = `fields id,name,description,developed.name,published.name,country,start_date,websites.url,logo.url; where id = ${companyId};`;
+        }
+        else {
+            body = `fields id,name,description,developed.name,published.name,country,start_date,websites.url,logo.url; search "${name}"; limit 5;`;
+        }
+        const result = await igdbPost(clientId, token, "/companies", body);
+        return companyId ? (result[0] ?? { error: "Company not found." }) : result;
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=igdb-tool.js.map

package/dist/igdb-tool.js.map

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

package/dist/keychain-crypto.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Encrypt a plaintext string using AES-256-GCM.
+ * Key is derived from the caller's UnClick API key via PBKDF2.
+ */
+export declare function encrypt(plaintext: string, apiKey: string): {
+    encrypted_value: string;
+    iv: string;
+    auth_tag: string;
+};
+/**
+ * Decrypt a value previously encrypted with encrypt().
+ */
+export declare function decrypt(encrypted_value: string, iv: string, auth_tag: string, apiKey: string): string;
+/**
+ * Returns the first 12 hex characters of the SHA-256 hash of the API key.
+ * Used as a human-readable namespace in logs and error messages.
+ */
+export declare function hashKey(apiKey: string): string;
+/**
+ * Returns the full SHA-256 hex hash of the API key.
+ * Used as the lookup key in Supabase (never store the raw API key).
+ */
+export declare function hashKeyFull(apiKey: string): string;
+//# sourceMappingURL=keychain-crypto.d.ts.map

package/dist/keychain-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain-crypto.d.ts","sourceRoot":"","sources":["../src/keychain-crypto.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAU3D;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAe,MAAM,EACvB,QAAQ,EAAS,MAAM,EACvB,MAAM,EAAW,MAAM,GACtB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/keychain-crypto.js

@@ -0,0 +1,60 @@
+// ─── Keychain Crypto ──────────────────────────────────────────────────────────
+// AES-256-GCM encryption for platform credentials.
+// Key derivation: PBKDF2 with a deterministic salt derived from the API key.
+// No external dependencies - Node.js built-in crypto only.
+import * as crypto from "crypto";
+const PBKDF2_ITERATIONS = 100_000;
+const KEY_BYTES = 32; // AES-256
+const IV_BYTES = 12; // 96-bit IV recommended for GCM
+// Deterministic salt: avoids storing a per-credential salt while still
+// using PBKDF2 for slow key derivation. The secret material is the API key.
+const KEYCHAIN_PEPPER = "unclick-keychain-v1";
+function deriveKey(apiKey) {
+    const salt = crypto
+        .createHash("sha256")
+        .update(`${KEYCHAIN_PEPPER}:${apiKey}`)
+        .digest();
+    return crypto.pbkdf2Sync(apiKey, salt, PBKDF2_ITERATIONS, KEY_BYTES, "sha256");
+}
+/**
+ * Encrypt a plaintext string using AES-256-GCM.
+ * Key is derived from the caller's UnClick API key via PBKDF2.
+ */
+export function encrypt(plaintext, apiKey) {
+    const key = deriveKey(apiKey);
+    const iv = crypto.randomBytes(IV_BYTES);
+    const cipher = crypto.createCipheriv("aes-256-gcm", key, iv);
+    const enc = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
+    return {
+        encrypted_value: enc.toString("hex"),
+        iv: iv.toString("hex"),
+        auth_tag: cipher.getAuthTag().toString("hex"),
+    };
+}
+/**
+ * Decrypt a value previously encrypted with encrypt().
+ */
+export function decrypt(encrypted_value, iv, auth_tag, apiKey) {
+    const key = deriveKey(apiKey);
+    const decipher = crypto.createDecipheriv("aes-256-gcm", key, Buffer.from(iv, "hex"));
+    decipher.setAuthTag(Buffer.from(auth_tag, "hex"));
+    return Buffer.concat([
+        decipher.update(Buffer.from(encrypted_value, "hex")),
+        decipher.final(),
+    ]).toString("utf8");
+}
+/**
+ * Returns the first 12 hex characters of the SHA-256 hash of the API key.
+ * Used as a human-readable namespace in logs and error messages.
+ */
+export function hashKey(apiKey) {
+    return crypto.createHash("sha256").update(apiKey).digest("hex").slice(0, 12);
+}
+/**
+ * Returns the full SHA-256 hex hash of the API key.
+ * Used as the lookup key in Supabase (never store the raw API key).
+ */
+export function hashKeyFull(apiKey) {
+    return crypto.createHash("sha256").update(apiKey).digest("hex");
+}
+//# sourceMappingURL=keychain-crypto.js.map

package/dist/keychain-crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain-crypto.js","sourceRoot":"","sources":["../src/keychain-crypto.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,mDAAmD;AACnD,6EAA6E;AAC7E,2DAA2D;AAE3D,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,SAAS,GAAW,EAAE,CAAC,CAAC,UAAU;AACxC,MAAM,QAAQ,GAAY,EAAE,CAAC,CAAC,gCAAgC;AAE9D,uEAAuE;AACvE,4EAA4E;AAC5E,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,IAAI,GAAG,MAAM;SAChB,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;SACtC,MAAM,EAAE,CAAC;IACZ,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,SAAiB,EACjB,MAAc;IAEd,MAAM,GAAG,GAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,GAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAM,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO;QACL,eAAe,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpC,EAAE,EAAe,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnC,QAAQ,EAAS,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,eAAuB,EACvB,EAAuB,EACvB,QAAuB,EACvB,MAAuB;IAEvB,MAAM,GAAG,GAAQ,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IACrF,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACpD,QAAQ,CAAC,KAAK,EAAE;KACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/keychain-secure-input.d.ts

@@ -0,0 +1,17 @@
+export interface SecureInputResult {
+    value: string;
+    source: "env" | "secure_input" | "direct";
+}
+export declare function checkEnvCredential(platform: string): string | null;
+export declare function startSecureInputServer(platform: string, setupUrl?: string): number;
+export declare function popResolvedCredential(platform: string): string | null;
+export declare function hasActiveServer(platform: string): boolean;
+export interface SecureConnectState {
+    status: "found_env" | "found_submitted" | "awaiting_input";
+    value?: string;
+    source?: "env" | "secure_input";
+    url?: string;
+    message: string;
+}
+export declare function resolveCredential(platform: string, setupUrl?: string): SecureConnectState;
+//# sourceMappingURL=keychain-secure-input.d.ts.map

package/dist/keychain-secure-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain-secure-input.d.ts","sourceRoot":"","sources":["../src/keychain-secure-input.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,cAAc,GAAG,QAAQ,CAAC;CAC3C;AAuED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAuDD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA0DlF;AAGD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOrE;AAGD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAID,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAI,WAAW,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC7D,KAAK,CAAC,EAAI,MAAM,CAAC;IACjB,MAAM,CAAC,EAAG,KAAK,GAAG,cAAc,CAAC;IACjC,GAAG,CAAC,EAAM,MAAM,CAAC;IACjB,OAAO,EAAG,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA8BzF"}