@unclick/mcp-server 0.1.1 → 0.2.0

package/dist/hunter-tool.js

@@ -0,0 +1,148 @@
+// Hunter.io integration.
+// Find and verify professional email addresses by company domain.
+// Docs: https://hunter.io/api-documentation
+// Auth: HUNTER_API_KEY env var (api_key query param).
+// Base URL: https://api.hunter.io/v2/
+const HUNTER_BASE = "https://api.hunter.io/v2";
+function getApiKey(args) {
+    const key = String(args.api_key ?? process.env.HUNTER_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required (or set HUNTER_API_KEY env var).");
+    return key;
+}
+async function hunterGet(apiKey, path, params) {
+    const qs = new URLSearchParams({ ...params, api_key: apiKey });
+    const res = await fetch(`${HUNTER_BASE}${path}?${qs}`, {
+        headers: { "User-Agent": "UnClickMCP/1.0 (https://unclick.io)" },
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new Error("Invalid Hunter.io API key.");
+    if (res.status === 404)
+        throw new Error("Resource not found.");
+    if (res.status === 429)
+        throw new Error("Hunter.io rate limit exceeded.");
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Hunter.io API HTTP ${res.status}${body ? `: ${body.slice(0, 200)}` : ""}`);
+    }
+    const json = await res.json();
+    const errors = json["errors"];
+    if (errors?.length) {
+        throw new Error(`Hunter.io error: ${errors.map((e) => e["details"] ?? e["id"]).join(", ")}`);
+    }
+    return json["data"] ?? json;
+}
+// ─── find_email ───────────────────────────────────────────────────────────────
+export async function findEmail(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const domain = String(args.domain ?? "").trim().toLowerCase();
+        if (!domain)
+            return { error: "domain is required (e.g. stripe.com)." };
+        const params = { domain };
+        if (args.first_name)
+            params["first_name"] = String(args.first_name);
+        if (args.last_name)
+            params["last_name"] = String(args.last_name);
+        if (args.company)
+            params["company"] = String(args.company);
+        if (args.limit)
+            params["limit"] = String(Math.min(100, Number(args.limit)));
+        if (args.skip)
+            params["skip"] = String(args.skip);
+        if (args.department)
+            params["department"] = String(args.department);
+        if (args.seniority)
+            params["seniority"] = String(args.seniority);
+        const data = await hunterGet(apiKey, "/domain-search", params);
+        return {
+            domain: data["domain"],
+            organization: data["organization"],
+            description: data["description"],
+            twitter: data["twitter"],
+            linkedin: data["linkedin"],
+            facebook: data["facebook"],
+            instagram: data["instagram"],
+            youtube: data["youtube"],
+            company_size: data["company_size"],
+            country: data["country"],
+            pattern: data["pattern"],
+            email_count: data["emails_count"],
+            emails: data["emails"]?.map((e) => ({
+                value: e["value"],
+                type: e["type"],
+                confidence: e["confidence"],
+                first_name: e["first_name"],
+                last_name: e["last_name"],
+                position: e["position"],
+                department: e["department"],
+                seniority: e["seniority"],
+                linkedin: e["linkedin"],
+                twitter: e["twitter"],
+                phone: e["phone_number"],
+                verification_status: e["verification"]?.["status"],
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── verify_email ─────────────────────────────────────────────────────────────
+export async function verifyEmail(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const email = String(args.email ?? "").trim().toLowerCase();
+        if (!email)
+            return { error: "email is required." };
+        const data = await hunterGet(apiKey, "/email-verifier", { email });
+        return {
+            email: data["email"],
+            status: data["status"],
+            result: data["result"],
+            score: data["score"],
+            regexp: data["regexp"],
+            gibberish: data["gibberish"],
+            disposable: data["disposable"],
+            webmail: data["webmail"],
+            mx_records: data["mx_records"],
+            smtp_server: data["smtp_server"],
+            smtp_check: data["smtp_check"],
+            accept_all: data["accept_all"],
+            block: data["block"],
+            sources: data["sources"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── get_domain_info ─────────────────────────────────────────────────────────
+export async function getDomainInfo(args) {
+    try {
+        const apiKey = getApiKey(args);
+        const domain = String(args.domain ?? "").trim().toLowerCase();
+        if (!domain)
+            return { error: "domain is required (e.g. stripe.com)." };
+        const data = await hunterGet(apiKey, "/domain-search", { domain, limit: "1" });
+        return {
+            domain: data["domain"],
+            organization: data["organization"],
+            description: data["description"],
+            country: data["country"],
+            company_size: data["company_size"],
+            industry: data["industry"],
+            technology: data["technology"],
+            pattern: data["pattern"],
+            website: data["website"],
+            twitter: data["twitter"],
+            linkedin: data["linkedin"],
+            facebook: data["facebook"],
+            email_count: data["emails_count"],
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=hunter-tool.js.map

package/dist/hunter-tool.js.map

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

package/dist/instapaper-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function instapaperAction(action: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=instapaper-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instapaper-tool.d.ts","sourceRoot":"","sources":["../src/instapaper-tool.ts"],"names":[],"mappings":"AAiTA,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/instapaper-tool.js

@@ -0,0 +1,257 @@
+// ── Instapaper API tool ────────────────────────────────────────────────────────
+// Wraps the Instapaper API v1 (https://www.instapaper.com/api/1/) via fetch.
+// Auth: xAuth (OAuth 1.0a simplified flow). Requires INSTAPAPER_CONSUMER_KEY,
+//   INSTAPAPER_CONSUMER_SECRET, INSTAPAPER_USERNAME, and INSTAPAPER_PASSWORD.
+//   The tool exchanges credentials for an OAuth access token on first use
+//   (xAuth: POST to /api/1/oauth/access_token).
+//
+// Credentials are auto-resolved via vault-bridge:
+//   1. Inline args   (consumer_key, consumer_secret, username, password passed directly)
+//   2. Env vars      UNCLICK_INSTAPAPER_CONSUMER_KEY, etc.
+//   3. Local vault   keys "instapaper/consumer_key", etc.
+//   4. Supabase      via UNCLICK_API_KEY + unclick.world/api/credentials
+//
+// No external dependencies.
+import { resolveCredentials } from "./vault-bridge.js";
+const INSTAPAPER_BASE = "https://www.instapaper.com/api/1";
+// ── OAuth 1.0a xAuth helper ────────────────────────────────────────────────────
+// Instapaper uses xAuth: trade username + password for an access token.
+// This requires signing the request with HMAC-SHA1, which is available via
+// Node's built-in crypto module.
+import { createHmac } from "crypto";
+function oauthSign(method, url, params, consumerSecret, tokenSecret = "") {
+    const encoded = Object.entries(params)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+        .join("&");
+    const base = [
+        method.toUpperCase(),
+        encodeURIComponent(url),
+        encodeURIComponent(encoded),
+    ].join("&");
+    const signingKey = `${encodeURIComponent(consumerSecret)}&${encodeURIComponent(tokenSecret)}`;
+    return createHmac("sha1", signingKey).update(base).digest("base64");
+}
+function buildOAuthHeader(consumerKey, consumerSecret, token, tokenSecret, method, url, extraParams = {}) {
+    const nonce = Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const oauthParams = {
+        oauth_consumer_key: consumerKey,
+        oauth_nonce: nonce,
+        oauth_signature_method: "HMAC-SHA1",
+        oauth_timestamp: timestamp,
+        oauth_token: token,
+        oauth_version: "1.0",
+    };
+    const allParams = { ...oauthParams, ...extraParams };
+    if (!token)
+        delete allParams.oauth_token;
+    const signature = oauthSign(method, url, allParams, consumerSecret, tokenSecret);
+    oauthParams.oauth_signature = signature;
+    if (!token)
+        delete oauthParams.oauth_token;
+    const headerParts = Object.entries(oauthParams)
+        .map(([k, v]) => `${encodeURIComponent(k)}="${encodeURIComponent(v)}"`)
+        .join(", ");
+    return `OAuth ${headerParts}`;
+}
+async function getXAuthToken(consumerKey, consumerSecret, username, password) {
+    const url = "https://www.instapaper.com/api/1/oauth/access_token";
+    const method = "POST";
+    const formParams = {
+        x_auth_username: username,
+        x_auth_password: password,
+        x_auth_mode: "client_auth",
+    };
+    const nonce = Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const allParams = {
+        oauth_consumer_key: consumerKey,
+        oauth_nonce: nonce,
+        oauth_signature_method: "HMAC-SHA1",
+        oauth_timestamp: timestamp,
+        oauth_version: "1.0",
+        ...formParams,
+    };
+    const signature = oauthSign(method, url, allParams, consumerSecret);
+    const oauthHeader = [
+        `OAuth oauth_consumer_key="${encodeURIComponent(consumerKey)}"`,
+        `oauth_nonce="${encodeURIComponent(nonce)}"`,
+        `oauth_signature="${encodeURIComponent(signature)}"`,
+        `oauth_signature_method="HMAC-SHA1"`,
+        `oauth_timestamp="${timestamp}"`,
+        `oauth_version="1.0"`,
+    ].join(", ");
+    const body = new URLSearchParams(formParams).toString();
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: oauthHeader,
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body,
+        });
+    }
+    catch (err) {
+        return { error: `Network error reaching Instapaper: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 401) {
+        return { error: "Instapaper authentication failed. Check your consumer key/secret and username/password." };
+    }
+    if (!response.ok) {
+        return { error: `Instapaper xAuth error ${response.status}: ${response.statusText}` };
+    }
+    const text = await response.text();
+    const parsed = Object.fromEntries(new URLSearchParams(text).entries());
+    if (!parsed.oauth_token || !parsed.oauth_token_secret) {
+        return { error: `Instapaper xAuth did not return tokens. Response: ${text}` };
+    }
+    return {
+        oauth_token: parsed.oauth_token,
+        oauth_token_secret: parsed.oauth_token_secret,
+    };
+}
+// ── Authenticated API call ─────────────────────────────────────────────────────
+async function instapaperPost(consumerKey, consumerSecret, token, tokenSecret, path, formData = {}) {
+    const url = `${INSTAPAPER_BASE}${path}`;
+    const method = "POST";
+    const nonce = Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const allParams = {
+        oauth_consumer_key: consumerKey,
+        oauth_nonce: nonce,
+        oauth_signature_method: "HMAC-SHA1",
+        oauth_timestamp: timestamp,
+        oauth_token: token,
+        oauth_version: "1.0",
+        ...formData,
+    };
+    const signature = oauthSign(method, url, allParams, consumerSecret, tokenSecret);
+    const oauthHeader = [
+        `OAuth oauth_consumer_key="${encodeURIComponent(consumerKey)}"`,
+        `oauth_nonce="${encodeURIComponent(nonce)}"`,
+        `oauth_signature="${encodeURIComponent(signature)}"`,
+        `oauth_signature_method="HMAC-SHA1"`,
+        `oauth_timestamp="${timestamp}"`,
+        `oauth_token="${encodeURIComponent(token)}"`,
+        `oauth_version="1.0"`,
+    ].join(", ");
+    const body = new URLSearchParams(formData).toString();
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: oauthHeader,
+                "Content-Type": "application/x-www-form-urlencoded",
+                Accept: "application/json",
+            },
+            body,
+        });
+    }
+    catch (err) {
+        return { error: `Network error reaching Instapaper API: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 401)
+        return { error: "Instapaper authentication failed. Re-check your credentials.", status: 401 };
+    if (response.status === 404)
+        return { error: "Instapaper resource not found.", status: 404 };
+    const text = await response.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = { raw: text };
+    }
+    if (!response.ok) {
+        return { error: `Instapaper API error ${response.status}: ${text}`, status: response.status };
+    }
+    return data;
+}
+async function authenticate(resolved) {
+    const consumerKey = String(resolved.consumer_key ?? "").trim();
+    const consumerSecret = String(resolved.consumer_secret ?? "").trim();
+    const username = String(resolved.username ?? "").trim();
+    const password = String(resolved.password ?? "");
+    if (!consumerKey)
+        return { error: "consumer_key is required." };
+    if (!consumerSecret)
+        return { error: "consumer_secret is required." };
+    if (!username)
+        return { error: "username is required." };
+    const tokenResult = await getXAuthToken(consumerKey, consumerSecret, username, password);
+    if ("error" in tokenResult)
+        return tokenResult;
+    return {
+        consumerKey,
+        consumerSecret,
+        token: tokenResult.oauth_token,
+        tokenSecret: tokenResult.oauth_token_secret,
+    };
+}
+// ── Action implementations ─────────────────────────────────────────────────────
+async function getBookmarks(creds, args) {
+    const params = {
+        limit: String(args.limit ? Number(args.limit) : 20),
+    };
+    if (args.folder_id)
+        params.folder_id = String(args.folder_id);
+    return instapaperPost(creds.consumerKey, creds.consumerSecret, creds.token, creds.tokenSecret, "/bookmarks/list", params);
+}
+async function addBookmark(creds, args) {
+    const url = String(args.url ?? "").trim();
+    if (!url)
+        return { error: "url is required." };
+    const params = { url };
+    if (args.title)
+        params.title = String(args.title);
+    if (args.description)
+        params.description = String(args.description);
+    if (args.folder_id)
+        params.folder_id = String(args.folder_id);
+    return instapaperPost(creds.consumerKey, creds.consumerSecret, creds.token, creds.tokenSecret, "/bookmarks/add", params);
+}
+async function archiveBookmark(creds, args) {
+    const bookmark_id = String(args.bookmark_id ?? "").trim();
+    if (!bookmark_id)
+        return { error: "bookmark_id is required." };
+    return instapaperPost(creds.consumerKey, creds.consumerSecret, creds.token, creds.tokenSecret, "/bookmarks/archive", { bookmark_id });
+}
+async function deleteBookmark(creds, args) {
+    const bookmark_id = String(args.bookmark_id ?? "").trim();
+    if (!bookmark_id)
+        return { error: "bookmark_id is required." };
+    return instapaperPost(creds.consumerKey, creds.consumerSecret, creds.token, creds.tokenSecret, "/bookmarks/delete", { bookmark_id });
+}
+async function getFolders(creds, _args) {
+    return instapaperPost(creds.consumerKey, creds.consumerSecret, creds.token, creds.tokenSecret, "/folders/list");
+}
+// ── Public dispatcher ──────────────────────────────────────────────────────────
+export async function instapaperAction(action, args) {
+    const resolved = await resolveCredentials("instapaper", args);
+    if ("error" in resolved)
+        return resolved;
+    const creds = await authenticate(resolved);
+    if ("error" in creds)
+        return creds;
+    try {
+        switch (action) {
+            case "get_instapaper_bookmarks": return getBookmarks(creds, args);
+            case "add_instapaper_bookmark": return addBookmark(creds, args);
+            case "archive_bookmark": return archiveBookmark(creds, args);
+            case "delete_bookmark": return deleteBookmark(creds, args);
+            case "get_instapaper_folders": return getFolders(creds, args);
+            default:
+                return {
+                    error: `Unknown Instapaper action: "${action}". Valid actions: get_instapaper_bookmarks, add_instapaper_bookmark, archive_bookmark, delete_bookmark, get_instapaper_folders.`,
+                };
+        }
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=instapaper-tool.js.map

package/dist/instapaper-tool.js.map

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

package/dist/ipapi-tool.d.ts

@@ -0,0 +1,3 @@
+export declare function ipLookup(args: Record<string, unknown>): Promise<unknown>;
+export declare function ipBatch(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=ipapi-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipapi-tool.d.ts","sourceRoot":"","sources":["../src/ipapi-tool.ts"],"names":[],"mappings":"AAkDA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9E;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmC7E"}

package/dist/ipapi-tool.js

@@ -0,0 +1,78 @@
+// IP geolocation integration for the UnClick MCP server.
+// Uses the ip-api.com free tier via fetch - no auth required (100 req/min).
+// Returns country, region, city, lat/lon, ISP, timezone, and more.
+const IPAPI_BASE = "http://ip-api.com";
+// --- API helper ---
+async function ipapiGet(ip) {
+    const path = ip ? `/${encodeURIComponent(ip)}` : "/";
+    const url = `${IPAPI_BASE}/json${path}?fields=66846719`;
+    const response = await fetch(url, { headers: { "Accept": "application/json" } });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ip-api.com`);
+    }
+    const data = await response.json();
+    if (data.status === "fail") {
+        throw new Error(`ip-api error: ${data.message ?? "Query failed"}`);
+    }
+    return data;
+}
+function normalizeIpData(data) {
+    return {
+        ip: data.query,
+        status: data.status,
+        country: data.country,
+        country_code: data.countryCode,
+        region: data.regionName,
+        region_code: data.region,
+        city: data.city,
+        zip: data.zip,
+        lat: data.lat,
+        lon: data.lon,
+        timezone: data.timezone,
+        isp: data.isp,
+        org: data.org,
+        as: data.as,
+        mobile: data.mobile,
+        proxy: data.proxy,
+        hosting: data.hosting,
+    };
+}
+// --- Operations ---
+export async function ipLookup(args) {
+    const ip = String(args.ip ?? "").trim();
+    // Empty ip will look up the caller's IP
+    const data = await ipapiGet(ip);
+    return normalizeIpData(data);
+}
+export async function ipBatch(args) {
+    const addresses = args.addresses;
+    if (!Array.isArray(addresses) || addresses.length === 0) {
+        throw new Error("addresses is required and must be a non-empty array of IP strings.");
+    }
+    if (addresses.length > 100) {
+        throw new Error("addresses array must contain 100 or fewer IPs per request.");
+    }
+    const body = addresses.map((a) => ({
+        query: String(a).trim(),
+        fields: "66846719",
+    }));
+    const response = await fetch(`${IPAPI_BASE}/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "Accept": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ip-api.com batch endpoint`);
+    }
+    const results = await response.json();
+    return {
+        count: results.length,
+        results: results.map((r) => {
+            if (r.status === "fail") {
+                return { ip: r.query, error: r.message ?? "Query failed" };
+            }
+            return normalizeIpData(r);
+        }),
+    };
+}
+//# sourceMappingURL=ipapi-tool.js.map

package/dist/ipapi-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipapi-tool.js","sourceRoot":"","sources":["../src/ipapi-tool.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,4EAA4E;AAC5E,mEAAmE;AAEnE,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,qBAAqB;AAErB,KAAK,UAAU,QAAQ,CAAC,EAAU;IAChC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,MAAM,GAAG,GAAG,GAAG,UAAU,QAAQ,IAAI,kBAAkB,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAC;IAE9D,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,IAA6B;IACpD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,KAAK;QACd,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,qBAAqB;AAErB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAA6B;IAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,wCAAwC;IACxC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAA6B;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,QAAQ,EAAE;QAClD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;QAC7E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,iCAAiC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoC,CAAC;IAExE,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;YAC7D,CAAC;YACD,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/ipaustralia-tool.d.ts

@@ -0,0 +1,4 @@
+export declare function searchTrademarks(args: Record<string, unknown>): Promise<unknown>;
+export declare function getTrademarkDetails(args: Record<string, unknown>): Promise<unknown>;
+export declare function searchPatents(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=ipaustralia-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipaustralia-tool.d.ts","sourceRoot":"","sources":["../src/ipaustralia-tool.ts"],"names":[],"mappings":"AAsCA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCtF;AAID,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBzF;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCnF"}