@apteva/integrations 0.1.0

package/dist/apps/index.d.ts

@@ -0,0 +1,25 @@
+import type { AppTemplate } from "../types.js";
+/**
+ * Load all app templates from the JSON files in this directory.
+ * Results are cached after first load.
+ */
+export declare function loadAppTemplates(): Map<string, AppTemplate>;
+/**
+ * Get a single app template by slug.
+ */
+export declare function getAppTemplate(slug: string): AppTemplate | undefined;
+/**
+ * List all available app slugs.
+ */
+export declare function listAppSlugs(): string[];
+/**
+ * List all app templates with basic info (no full tool schemas).
+ */
+export declare function listApps(): Array<{
+    slug: string;
+    name: string;
+    description: string;
+    categories: string[];
+    toolCount: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/apps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/apps/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAiB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAQD"}

package/dist/apps/index.js

@@ -0,0 +1,51 @@
+import { readFileSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cachedApps = null;
+/**
+ * Load all app templates from the JSON files in this directory.
+ * Results are cached after first load.
+ */
+export function loadAppTemplates() {
+    if (cachedApps)
+        return cachedApps;
+    cachedApps = new Map();
+    const files = readdirSync(__dirname).filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+        try {
+            const raw = readFileSync(join(__dirname, file), "utf-8");
+            const app = JSON.parse(raw);
+            cachedApps.set(app.slug, app);
+        }
+        catch (e) {
+            console.warn(`[integrations] Failed to load app template ${file}:`, e);
+        }
+    }
+    return cachedApps;
+}
+/**
+ * Get a single app template by slug.
+ */
+export function getAppTemplate(slug) {
+    return loadAppTemplates().get(slug);
+}
+/**
+ * List all available app slugs.
+ */
+export function listAppSlugs() {
+    return Array.from(loadAppTemplates().keys());
+}
+/**
+ * List all app templates with basic info (no full tool schemas).
+ */
+export function listApps() {
+    return Array.from(loadAppTemplates().values()).map((app) => ({
+        slug: app.slug,
+        name: app.name,
+        description: app.description,
+        categories: app.categories,
+        toolCount: app.tools.length,
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/apps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,UAAU,GAAoC,IAAI,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAExE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,GAAG,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,8CAA8C,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ;IAOtB,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/http-executor.d.ts

@@ -0,0 +1,21 @@
+import type { AppTemplate, AppToolTemplate, ConnectionCredentials } from "./types.js";
+export interface ExecuteToolOptions {
+    app: AppTemplate;
+    tool: AppToolTemplate;
+    credentials: ConnectionCredentials;
+    input: Record<string, unknown>;
+    timeout?: number;
+}
+export interface ExecuteToolResult {
+    success: boolean;
+    status: number;
+    data: unknown;
+    headers: Record<string, string>;
+}
+/**
+ * Execute an HTTP-based tool call against a real API.
+ * Takes an app template, tool definition, connection credentials, and input params,
+ * then makes the actual HTTP request and returns the result.
+ */
+export declare function executeTool(opts: ExecuteToolOptions): Promise<ExecuteToolResult>;
+//# sourceMappingURL=http-executor.d.ts.map

package/dist/http-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-executor.d.ts","sourceRoot":"","sources":["../src/http-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EAEf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,WAAW,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,qBAAqB,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA+F5B"}

package/dist/http-executor.js

@@ -0,0 +1,191 @@
+/**
+ * Execute an HTTP-based tool call against a real API.
+ * Takes an app template, tool definition, connection credentials, and input params,
+ * then makes the actual HTTP request and returns the result.
+ */
+export async function executeTool(opts) {
+    const { app, tool, credentials, input, timeout = 30000 } = opts;
+    // 1. Build the URL with path parameter interpolation
+    const url = buildUrl(app.base_url, tool.path, input);
+    // 2. Build headers from app auth config + credentials
+    const headers = buildHeaders(app, credentials);
+    // 3. Build request options
+    const fetchOpts = {
+        method: tool.method,
+        headers,
+        signal: AbortSignal.timeout(timeout),
+    };
+    // 4. Build auth query params (e.g. Pushover's ?token=xxx)
+    const authQueryParams = buildAuthQueryParams(app, credentials);
+    // 5. For GET/DELETE, remaining params go to query string.
+    //    For POST/PUT/PATCH, remaining params go to body.
+    const pathParams = extractPathParams(tool.path);
+    const remainingParams = Object.fromEntries(Object.entries(input).filter(([k]) => !pathParams.includes(k)));
+    let finalUrl = url;
+    const allQueryParams = { ...authQueryParams };
+    if (tool.method === "GET" || tool.method === "DELETE") {
+        Object.assign(allQueryParams, remainingParams);
+    }
+    else {
+        // For POST with query_params auth (like Pushover), merge auth + input into body
+        if (Object.keys(authQueryParams).length > 0) {
+            // API-key APIs like Pushover expect token in the POST body too
+            const bodyParams = { ...authQueryParams, ...remainingParams };
+            const contentType = headers["Content-Type"] || headers["content-type"] || "";
+            if (contentType.includes("x-www-form-urlencoded")) {
+                fetchOpts.body = buildQueryString(bodyParams);
+            }
+            else {
+                fetchOpts.body = JSON.stringify(bodyParams);
+            }
+        }
+        else {
+            const contentType = headers["Content-Type"] || headers["content-type"] || "";
+            if (contentType.includes("x-www-form-urlencoded")) {
+                fetchOpts.body = buildQueryString(remainingParams);
+            }
+            else {
+                fetchOpts.body = JSON.stringify(remainingParams);
+            }
+        }
+    }
+    // Append query params to URL for GET/DELETE (or auth params for any method)
+    if (tool.method === "GET" || tool.method === "DELETE") {
+        const qs = buildQueryString(allQueryParams);
+        if (qs)
+            finalUrl += `?${qs}`;
+    }
+    // 5. Execute the request
+    try {
+        const response = await fetch(finalUrl, fetchOpts);
+        const responseHeaders = {};
+        response.headers.forEach((v, k) => {
+            responseHeaders[k] = v;
+        });
+        let data;
+        const ct = response.headers.get("content-type") || "";
+        if (ct.includes("application/json")) {
+            data = await response.json();
+        }
+        else {
+            data = await response.text();
+        }
+        // Apply response_path extraction if defined
+        if (tool.response_path && data && typeof data === "object") {
+            data = extractPath(data, tool.response_path);
+        }
+        return {
+            success: response.ok,
+            status: response.status,
+            data,
+            headers: responseHeaders,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            status: 0,
+            data: { error: message },
+            headers: {},
+        };
+    }
+}
+// ─── Helpers ───
+function buildUrl(baseUrl, path, input) {
+    // Replace {param} placeholders with actual values
+    let resolved = path;
+    const paramRegex = /\{(\w+)\}/g;
+    let match;
+    while ((match = paramRegex.exec(path)) !== null) {
+        const key = match[1];
+        const value = input[key];
+        if (value !== undefined) {
+            resolved = resolved.replace(`{${key}}`, encodeURIComponent(String(value)));
+        }
+    }
+    return `${baseUrl.replace(/\/$/, "")}${resolved}`;
+}
+function extractPathParams(path) {
+    const params = [];
+    const regex = /\{(\w+)\}/g;
+    let match;
+    while ((match = regex.exec(path)) !== null) {
+        params.push(match[1]);
+    }
+    return params;
+}
+function buildAuthQueryParams(app, credentials) {
+    const params = {};
+    if (app.auth.query_params) {
+        for (const [key, template] of Object.entries(app.auth.query_params)) {
+            params[key] = resolveTemplate(template, credentials);
+        }
+    }
+    return params;
+}
+function buildHeaders(app, credentials) {
+    const headers = {};
+    if (app.auth.headers) {
+        for (const [key, template] of Object.entries(app.auth.headers)) {
+            headers[key] = resolveTemplate(template, credentials);
+        }
+    }
+    return headers;
+}
+function resolveTemplate(template, credentials) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        // Map common template vars to credential fields
+        switch (key) {
+            case "token":
+                return (credentials.access_token ||
+                    credentials.bearer_token ||
+                    credentials.api_key ||
+                    "");
+            case "api_key":
+                return credentials.api_key || "";
+            case "username":
+                return credentials.username || "";
+            case "password":
+                return credentials.password || "";
+            default:
+                return credentials.fields?.[key] || "";
+        }
+    });
+}
+function buildQueryString(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+            }
+        }
+        else if (typeof value === "object") {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(JSON.stringify(value))}`);
+        }
+        else {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        }
+    }
+    return parts.join("&");
+}
+function extractPath(data, jsonPath) {
+    // Simple dot-notation path extraction: "data.items"
+    const parts = jsonPath.split(".");
+    let current = data;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return current;
+        if (typeof current === "object") {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=http-executor.js.map

package/dist/http-executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { AppTemplate, AppAuthConfig, AuthType, OAuthConfig, AppToolTemplate, Connection, ConnectionCredentials, LocalTriggerConfig, GeneratedMcpServer, GeneratedMcpTool, IntegrationsStorage, } from "./types.js";
+export { loadAppTemplates, getAppTemplate, listAppSlugs, listApps, } from "./apps/index.js";
+export { executeTool } from "./http-executor.js";
+export type { ExecuteToolOptions, ExecuteToolResult } from "./http-executor.js";
+export { getAuthorizationUrl, exchangeCode, refreshAccessToken, tokensToCredentials, isTokenExpired, } from "./oauth.js";
+export type { OAuthStartOptions, OAuthCallbackOptions, OAuthRefreshOptions, OAuthTokenResult, } from "./oauth.js";
+export { generateMcpServer } from "./mcp-generator.js";
+export { LocalIntegrationProvider } from "./providers/local.js";
+export type { LocalProviderConfig } from "./providers/local.js";
+export { LocalTriggerProvider } from "./triggers/local.js";
+export type { TriggerStorage, WebhookPayload, TriggerResult } from "./triggers/local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// ─── App Templates ───
+export { loadAppTemplates, getAppTemplate, listAppSlugs, listApps, } from "./apps/index.js";
+// ─── HTTP Tool Executor ───
+export { executeTool } from "./http-executor.js";
+// ─── OAuth Engine ───
+export { getAuthorizationUrl, exchangeCode, refreshAccessToken, tokensToCredentials, isTokenExpired, } from "./oauth.js";
+// ─── MCP Server Generator ───
+export { generateMcpServer } from "./mcp-generator.js";
+// ─── Local Integration Provider ───
+export { LocalIntegrationProvider } from "./providers/local.js";
+// ─── Local Trigger Provider ───
+export { LocalTriggerProvider } from "./triggers/local.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAQpB,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qCAAqC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-generator.d.ts

@@ -0,0 +1,8 @@
+import type { AppTemplate, Connection, GeneratedMcpServer } from "./types.js";
+/**
+ * Generate an MCP server definition from a connection + its app template.
+ * The generated server contains tools that map to HTTP API calls,
+ * with credentials baked into the headers.
+ */
+export declare function generateMcpServer(connection: Connection, app: AppTemplate): GeneratedMcpServer;
+//# sourceMappingURL=mcp-generator.d.ts.map

package/dist/mcp-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-generator.d.ts","sourceRoot":"","sources":["../src/mcp-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,UAAU,EACV,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,WAAW,GACf,kBAAkB,CAWpB"}

package/dist/mcp-generator.js

@@ -0,0 +1,108 @@
+/**
+ * Generate an MCP server definition from a connection + its app template.
+ * The generated server contains tools that map to HTTP API calls,
+ * with credentials baked into the headers.
+ */
+export function generateMcpServer(connection, app) {
+    const tools = app.tools.map((tool) => generateMcpTool(app, tool, connection));
+    return {
+        name: `${app.slug}-${connection.id}`,
+        type: "local",
+        source: "local-integration",
+        tools,
+    };
+}
+/**
+ * Generate a single MCP tool from an app tool template + connection.
+ */
+function generateMcpTool(app, tool, connection) {
+    // Build resolved headers with actual credentials
+    const headers = {};
+    if (app.auth.headers) {
+        for (const [key, template] of Object.entries(app.auth.headers)) {
+            headers[key] = resolveCredentialTemplate(template, connection.credentials);
+        }
+    }
+    // Build auth query params (e.g. Pushover's ?token=xxx) and bake into URL
+    let authQuery = "";
+    if (app.auth.query_params) {
+        const parts = [];
+        for (const [key, template] of Object.entries(app.auth.query_params)) {
+            const value = resolveCredentialTemplate(template, connection.credentials);
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+        }
+        if (parts.length > 0)
+            authQuery = `?${parts.join("&")}`;
+    }
+    // Build the full URL template (path params remain as {param} for runtime resolution)
+    const url = `${app.base_url.replace(/\/$/, "")}${tool.path}${authQuery}`;
+    // For POST/PUT/PATCH, generate a body template
+    let bodyTemplate;
+    if (tool.method !== "GET" && tool.method !== "DELETE") {
+        // The body template uses the tool's input_schema properties as a hint.
+        // At runtime, the MCP handler will JSON.stringify the input minus path params.
+        bodyTemplate = "{{json_body}}";
+    }
+    // Build clean input schema without path params (those get resolved in URL)
+    const pathParams = extractPathParams(tool.path);
+    const cleanSchema = removePathParamsFromSchema(tool.input_schema, pathParams);
+    return {
+        name: `${app.slug}_${tool.name}`,
+        description: `[${app.name}] ${tool.description}`,
+        input_schema: cleanSchema,
+        handler_type: "http",
+        http_config: {
+            method: tool.method,
+            url,
+            headers,
+            body_template: bodyTemplate,
+        },
+    };
+}
+// ─── Helpers ───
+function resolveCredentialTemplate(template, credentials) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        switch (key) {
+            case "token":
+                return (credentials.access_token ||
+                    credentials.bearer_token ||
+                    credentials.api_key ||
+                    "");
+            case "api_key":
+                return credentials.api_key || "";
+            case "username":
+                return credentials.username || "";
+            case "password":
+                return credentials.password || "";
+            default:
+                return credentials.fields?.[key] || "";
+        }
+    });
+}
+function extractPathParams(path) {
+    const params = [];
+    const regex = /\{(\w+)\}/g;
+    let match;
+    while ((match = regex.exec(path)) !== null) {
+        params.push(match[1]);
+    }
+    return params;
+}
+function removePathParamsFromSchema(schema, pathParams) {
+    if (pathParams.length === 0)
+        return schema;
+    const clone = JSON.parse(JSON.stringify(schema));
+    if (clone.properties) {
+        for (const param of pathParams) {
+            delete clone.properties[param];
+        }
+        // Also remove from required array
+        if (Array.isArray(clone.required)) {
+            clone.required = clone.required.filter((r) => !pathParams.includes(r));
+            if (clone.required.length === 0)
+                delete clone.required;
+        }
+    }
+    return clone;
+}
+//# sourceMappingURL=mcp-generator.js.map

package/dist/mcp-generator.js.map

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

package/dist/oauth.d.ts

@@ -0,0 +1,49 @@
+import type { AppTemplate, ConnectionCredentials } from "./types.js";
+export interface OAuthStartOptions {
+    app: AppTemplate;
+    clientId: string;
+    redirectUri: string;
+    state?: string;
+    scopes?: string[];
+}
+export interface OAuthCallbackOptions {
+    app: AppTemplate;
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    code: string;
+}
+export interface OAuthRefreshOptions {
+    app: AppTemplate;
+    clientId: string;
+    clientSecret: string;
+    refreshToken: string;
+}
+export interface OAuthTokenResult {
+    access_token: string;
+    refresh_token?: string;
+    expires_in?: number;
+    token_type?: string;
+    scope?: string;
+}
+/**
+ * Generate the OAuth2 authorization URL for a given app.
+ */
+export declare function getAuthorizationUrl(opts: OAuthStartOptions): string;
+/**
+ * Exchange an authorization code for access/refresh tokens.
+ */
+export declare function exchangeCode(opts: OAuthCallbackOptions): Promise<OAuthTokenResult>;
+/**
+ * Refresh an expired access token using a refresh token.
+ */
+export declare function refreshAccessToken(opts: OAuthRefreshOptions): Promise<OAuthTokenResult>;
+/**
+ * Convert OAuth tokens into ConnectionCredentials format.
+ */
+export declare function tokensToCredentials(tokens: OAuthTokenResult, clientId?: string, clientSecret?: string): Partial<ConnectionCredentials>;
+/**
+ * Check if a connection's token is expired or about to expire (within 5 min).
+ */
+export declare function isTokenExpired(credentials: ConnectionCredentials): boolean;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkBnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAK1E"}

package/dist/oauth.js

@@ -0,0 +1,119 @@
+/**
+ * Generate the OAuth2 authorization URL for a given app.
+ */
+export function getAuthorizationUrl(opts) {
+    const oauth = opts.app.auth.oauth2;
+    if (!oauth) {
+        throw new Error(`App "${opts.app.slug}" does not support OAuth2`);
+    }
+    const params = new URLSearchParams({
+        client_id: opts.clientId,
+        redirect_uri: opts.redirectUri,
+        response_type: "code",
+        scope: (opts.scopes || oauth.scopes).join(" "),
+    });
+    if (opts.state) {
+        params.set("state", opts.state);
+    }
+    return `${oauth.authorize_url}?${params.toString()}`;
+}
+/**
+ * Exchange an authorization code for access/refresh tokens.
+ */
+export async function exchangeCode(opts) {
+    const oauth = opts.app.auth.oauth2;
+    if (!oauth) {
+        throw new Error(`App "${opts.app.slug}" does not support OAuth2`);
+    }
+    const body = new URLSearchParams({
+        grant_type: "authorization_code",
+        code: opts.code,
+        redirect_uri: opts.redirectUri,
+        client_id: opts.clientId,
+        client_secret: opts.clientSecret,
+    });
+    const response = await fetch(oauth.token_url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+            Accept: "application/json",
+        },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`OAuth token exchange failed (${response.status}): ${text}`);
+    }
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+        return (await response.json());
+    }
+    // Some providers (e.g. GitHub) return form-encoded
+    const text = await response.text();
+    const params = new URLSearchParams(text);
+    return {
+        access_token: params.get("access_token") || "",
+        refresh_token: params.get("refresh_token") || undefined,
+        token_type: params.get("token_type") || undefined,
+        scope: params.get("scope") || undefined,
+    };
+}
+/**
+ * Refresh an expired access token using a refresh token.
+ */
+export async function refreshAccessToken(opts) {
+    const oauth = opts.app.auth.oauth2;
+    if (!oauth) {
+        throw new Error(`App "${opts.app.slug}" does not support OAuth2`);
+    }
+    const body = new URLSearchParams({
+        grant_type: "refresh_token",
+        refresh_token: opts.refreshToken,
+        client_id: opts.clientId,
+        client_secret: opts.clientSecret,
+    });
+    const response = await fetch(oauth.token_url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+            Accept: "application/json",
+        },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`OAuth token refresh failed (${response.status}): ${text}`);
+    }
+    return (await response.json());
+}
+/**
+ * Convert OAuth tokens into ConnectionCredentials format.
+ */
+export function tokensToCredentials(tokens, clientId, clientSecret) {
+    const creds = {
+        access_token: tokens.access_token,
+    };
+    if (tokens.refresh_token) {
+        creds.refresh_token = tokens.refresh_token;
+    }
+    if (tokens.expires_in) {
+        const expiresAt = new Date(Date.now() + tokens.expires_in * 1000);
+        creds.token_expires_at = expiresAt.toISOString();
+    }
+    if (clientId)
+        creds.client_id = clientId;
+    if (clientSecret)
+        creds.client_secret = clientSecret;
+    return creds;
+}
+/**
+ * Check if a connection's token is expired or about to expire (within 5 min).
+ */
+export function isTokenExpired(credentials) {
+    if (!credentials.token_expires_at)
+        return false;
+    const expiresAt = new Date(credentials.token_expires_at).getTime();
+    const buffer = 5 * 60 * 1000; // 5 minutes
+    return Date.now() >= expiresAt - buffer;
+}
+//# sourceMappingURL=oauth.js.map