mcp-sunsama 0.2.0

package/dist/auth/http.js

@@ -0,0 +1,52 @@
+import { IncomingMessage } from "http";
+import { SunsamaClient } from "sunsama-api";
+/**
+ * Parse HTTP Basic Auth credentials from Authorization header
+ * @param authHeader - The Authorization header value
+ * @returns Object containing email and password
+ * @throws {Error} If the header format is invalid
+ */
+export function parseBasicAuth(authHeader) {
+    const base64Credentials = authHeader.replace('Basic ', '');
+    const credentials = Buffer.from(base64Credentials, 'base64').toString('ascii');
+    const [email, password] = credentials.split(':');
+    if (!email || !password) {
+        throw new Error("Invalid Basic Auth format");
+    }
+    return { email, password };
+}
+/**
+ * HTTP Basic Auth authenticator for httpStream transport
+ * @param request - The incoming request object
+ * @returns SessionData with authenticated SunsamaClient
+ * @throws {Response} HTTP 401 response for authentication failures
+ */
+export async function httpStreamAuthenticator(request) {
+    const authHeader = request.headers["authorization"];
+    if (!authHeader || Array.isArray(authHeader) || !authHeader.startsWith('Basic ')) {
+        throw new Response(null, {
+            status: 401,
+            statusText: "Unauthorized: Basic Auth required",
+            headers: { 'WWW-Authenticate': 'Basic realm="Sunsama MCP"' }
+        });
+    }
+    try {
+        // Parse Basic Auth credentials
+        const { email, password } = parseBasicAuth(authHeader);
+        // Create and authenticate SunsamaClient
+        const sunsamaClient = new SunsamaClient();
+        await sunsamaClient.login(email, password);
+        console.log(`HTTP session authenticated for user: ${email}`);
+        return {
+            sunsamaClient,
+            email
+        };
+    }
+    catch (error) {
+        console.log("Authentication failed:", error instanceof Error ? error.message : 'Unknown error');
+        throw new Response(null, {
+            status: 401,
+            statusText: "Unauthorized: Invalid Sunsama credentials"
+        });
+    }
+}

package/dist/auth/stdio.d.ts

@@ -0,0 +1,13 @@
+import { SunsamaClient } from "sunsama-api";
+/**
+ * Initialize stdio authentication using environment variables
+ * @throws {Error} If credentials are missing or authentication fails
+ */
+export declare function initializeStdioAuth(): Promise<void>;
+/**
+ * Get the global Sunsama client instance for stdio transport
+ * @returns {SunsamaClient} The authenticated global client
+ * @throws {Error} If global client is not initialized
+ */
+export declare function getGlobalSunsamaClient(): SunsamaClient;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/auth/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/auth/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CASzD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,aAAa,CAKtD"}

package/dist/auth/stdio.js

@@ -0,0 +1,27 @@
+import { SunsamaClient } from "sunsama-api";
+/**
+ * Global Sunsama client instance for stdio transport
+ */
+let globalSunsamaClient = null;
+/**
+ * Initialize stdio authentication using environment variables
+ * @throws {Error} If credentials are missing or authentication fails
+ */
+export async function initializeStdioAuth() {
+    if (!process.env.SUNSAMA_EMAIL || !process.env.SUNSAMA_PASSWORD) {
+        throw new Error("Sunsama credentials not configured. Please set SUNSAMA_EMAIL and SUNSAMA_PASSWORD environment variables.");
+    }
+    globalSunsamaClient = new SunsamaClient();
+    await globalSunsamaClient.login(process.env.SUNSAMA_EMAIL, process.env.SUNSAMA_PASSWORD);
+}
+/**
+ * Get the global Sunsama client instance for stdio transport
+ * @returns {SunsamaClient} The authenticated global client
+ * @throws {Error} If global client is not initialized
+ */
+export function getGlobalSunsamaClient() {
+    if (!globalSunsamaClient) {
+        throw new Error("Global Sunsama client not initialized.");
+    }
+    return globalSunsamaClient;
+}

package/dist/auth/types.d.ts

@@ -0,0 +1,9 @@
+import { SunsamaClient } from "sunsama-api";
+/**
+ * Session data interface for HTTP transport
+ */
+export interface SessionData extends Record<string, unknown> {
+    sunsamaClient: SunsamaClient;
+    email: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/auth/types.js

@@ -0,0 +1 @@
+import { SunsamaClient } from "sunsama-api";

package/dist/config/transport.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Transport configuration for the Sunsama MCP Server
+ * Supports both stdio and httpStream transports based on environment variables
+ */
+export type TransportType = "stdio" | "httpStream";
+export interface TransportConfig {
+    transportType: TransportType;
+    httpStream?: {
+        port: number;
+        endpoint: string;
+    };
+}
+/**
+ * Gets the transport configuration based on environment variables
+ *
+ * Environment Variables:
+ * - TRANSPORT_TYPE: "stdio" | "httpStream" (default: "stdio")
+ * - PORT: HTTP server port (default: 3000, only for httpStream)
+ * - HTTP_ENDPOINT: HTTP endpoint path (default: "/mcp", only for httpStream)
+ *
+ * @throws {z.ZodError} When environment variables are invalid
+ */
+export declare function getTransportConfig(): TransportConfig;
+/**
+ * Returns true if the current transport configuration is for HTTP streaming
+ */
+export declare function isHttpStreamTransport(): boolean;
+/**
+ * Returns true if the current transport configuration is for stdio
+ */
+export declare function isStdioTransport(): boolean;
+//# sourceMappingURL=transport.d.ts.map

package/dist/config/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/config/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAcD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CA0BpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/config/transport.js

@@ -0,0 +1,62 @@
+/**
+ * Transport configuration for the Sunsama MCP Server
+ * Supports both stdio and httpStream transports based on environment variables
+ */
+import { z } from "zod";
+/**
+ * Zod schema for validating transport-related environment variables
+ */
+const TransportEnvSchema = z.object({
+    TRANSPORT_TYPE: z.enum(["stdio", "httpStream"]).default("stdio"),
+    PORT: z.string()
+        .transform(val => parseInt(val, 10))
+        .pipe(z.number().min(1).max(65535))
+        .optional(),
+    HTTP_ENDPOINT: z.string().default("/mcp")
+});
+/**
+ * Gets the transport configuration based on environment variables
+ *
+ * Environment Variables:
+ * - TRANSPORT_TYPE: "stdio" | "httpStream" (default: "stdio")
+ * - PORT: HTTP server port (default: 3000, only for httpStream)
+ * - HTTP_ENDPOINT: HTTP endpoint path (default: "/mcp", only for httpStream)
+ *
+ * @throws {z.ZodError} When environment variables are invalid
+ */
+export function getTransportConfig() {
+    try {
+        const env = TransportEnvSchema.parse(process.env);
+        if (env.TRANSPORT_TYPE === "httpStream") {
+            return {
+                transportType: "httpStream",
+                httpStream: {
+                    port: env.PORT || 3000,
+                    endpoint: env.HTTP_ENDPOINT
+                }
+            };
+        }
+        return {
+            transportType: "stdio"
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`).join(', ');
+            throw new Error(`Invalid transport configuration: ${issues}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Returns true if the current transport configuration is for HTTP streaming
+ */
+export function isHttpStreamTransport() {
+    return getTransportConfig().transportType === "httpStream";
+}
+/**
+ * Returns true if the current transport configuration is for stdio
+ */
+export function isStdioTransport() {
+    return getTransportConfig().transportType === "stdio";
+}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}