@_davideast/stitch-mcp 0.4.0 → 0.5.0

package/dist/src/services/proxy/spec.d.ts

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+export declare const StartProxyInputSchema: z.ZodObject<{
+    transport: z.ZodDefault<z.ZodEnum<["stdio", "sse"]>>;
+    port: z.ZodOptional<z.ZodNumber>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "stdio" | "sse";
+    port?: number | undefined;
+    debug?: boolean | undefined;
+}, {
+    transport?: "stdio" | "sse" | undefined;
+    port?: number | undefined;
+    debug?: boolean | undefined;
+}>;
+export type StartProxyInput = z.infer<typeof StartProxyInputSchema>;
+export declare const ProxyErrorCode: z.ZodEnum<["START_FAILED", "TRANSPORT_ERROR", "AUTH_REFRESH_FAILED", "UNKNOWN_ERROR"]>;
+export type ProxyErrorCodeType = z.infer<typeof ProxyErrorCode>;
+export declare const ProxySuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        status: z.ZodEnum<["running", "stopped"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "running" | "stopped";
+    }, {
+        status: "running" | "stopped";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        status: "running" | "stopped";
+    };
+}, {
+    success: true;
+    data: {
+        status: "running" | "stopped";
+    };
+}>;
+export declare const ProxyFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["START_FAILED", "TRANSPORT_ERROR", "AUTH_REFRESH_FAILED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "START_FAILED" | "TRANSPORT_ERROR" | "AUTH_REFRESH_FAILED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }, {
+        code: "UNKNOWN_ERROR" | "START_FAILED" | "TRANSPORT_ERROR" | "AUTH_REFRESH_FAILED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "START_FAILED" | "TRANSPORT_ERROR" | "AUTH_REFRESH_FAILED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "START_FAILED" | "TRANSPORT_ERROR" | "AUTH_REFRESH_FAILED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+    };
+}>;
+export type ProxyResult = z.infer<typeof ProxySuccess> | z.infer<typeof ProxyFailure>;
+export interface ProxyService {
+    /**
+     * Start the MCP proxy server
+     *
+     * @remarks
+     * This is a long-running operation. The promise settles only when the server stops
+     * or if initial startup fails.
+     */
+    start(input: StartProxyInput): Promise<ProxyResult>;
+}

package/dist/src/services/proxy/spec.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/services/stitch/handler.d.ts

@@ -0,0 +1,15 @@
+import { type StitchService, type ConfigureIAMInput, type EnableAPIInput, type TestConnectionInput, type IAMConfigResult, type APIEnableResult, type ConnectionTestResult } from './spec.js';
+export declare class StitchHandler implements StitchService {
+    private getGcloudEnv;
+    private getGcloudBinary;
+    configureIAM(input: ConfigureIAMInput): Promise<IAMConfigResult>;
+    enableAPI(input: EnableAPIInput): Promise<APIEnableResult>;
+    checkIAMRole(input: {
+        projectId: string;
+        userEmail: string;
+    }): Promise<boolean>;
+    checkAPIEnabled(input: {
+        projectId: string;
+    }): Promise<boolean>;
+    testConnection(input: TestConnectionInput): Promise<ConnectionTestResult>;
+}

package/dist/src/services/stitch/handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/services/stitch/spec.d.ts

@@ -0,0 +1,262 @@
+import { z } from 'zod';
+export declare const ConfigureIAMInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    userEmail: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    userEmail: string;
+}, {
+    projectId: string;
+    userEmail: string;
+}>;
+export type ConfigureIAMInput = z.infer<typeof ConfigureIAMInputSchema>;
+export declare const EnableAPIInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export type EnableAPIInput = z.infer<typeof EnableAPIInputSchema>;
+export declare const TestConnectionInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    accessToken: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    accessToken: string;
+}, {
+    projectId: string;
+    accessToken: string;
+}>;
+export type TestConnectionInput = z.infer<typeof TestConnectionInputSchema>;
+export declare const StitchErrorCode: z.ZodEnum<["IAM_CONFIG_FAILED", "API_ENABLE_FAILED", "CONNECTION_TEST_FAILED", "PERMISSION_DENIED", "UNKNOWN_ERROR"]>;
+export declare const IAMConfigSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        role: z.ZodString;
+        member: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        member: string;
+    }, {
+        role: string;
+        member: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        role: string;
+        member: string;
+    };
+}, {
+    success: true;
+    data: {
+        role: string;
+        member: string;
+    };
+}>;
+export declare const IAMConfigFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["IAM_CONFIG_FAILED", "API_ENABLE_FAILED", "CONNECTION_TEST_FAILED", "PERMISSION_DENIED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}>;
+export type IAMConfigResult = z.infer<typeof IAMConfigSuccess> | z.infer<typeof IAMConfigFailure>;
+export declare const APIEnableSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        api: z.ZodString;
+        enabled: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        api: string;
+        enabled: boolean;
+    }, {
+        api: string;
+        enabled: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        api: string;
+        enabled: boolean;
+    };
+}, {
+    success: true;
+    data: {
+        api: string;
+        enabled: boolean;
+    };
+}>;
+export declare const APIEnableFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["IAM_CONFIG_FAILED", "API_ENABLE_FAILED", "CONNECTION_TEST_FAILED", "PERMISSION_DENIED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}>;
+export type APIEnableResult = z.infer<typeof APIEnableSuccess> | z.infer<typeof APIEnableFailure>;
+export declare const ConnectionTestSuccess: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        connected: z.ZodBoolean;
+        statusCode: z.ZodNumber;
+        response: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        connected: boolean;
+        statusCode: number;
+        response?: any;
+    }, {
+        connected: boolean;
+        statusCode: number;
+        response?: any;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        connected: boolean;
+        statusCode: number;
+        response?: any;
+    };
+}, {
+    success: true;
+    data: {
+        connected: boolean;
+        statusCode: number;
+        response?: any;
+    };
+}>;
+export declare const ConnectionTestFailure: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["IAM_CONFIG_FAILED", "API_ENABLE_FAILED", "CONNECTION_TEST_FAILED", "PERMISSION_DENIED", "UNKNOWN_ERROR"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+        recoverable: z.ZodBoolean;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }, {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}, {
+    success: false;
+    error: {
+        code: "UNKNOWN_ERROR" | "IAM_CONFIG_FAILED" | "API_ENABLE_FAILED" | "CONNECTION_TEST_FAILED" | "PERMISSION_DENIED";
+        message: string;
+        recoverable: boolean;
+        suggestion?: string | undefined;
+        details?: string | undefined;
+    };
+}>;
+export type ConnectionTestResult = z.infer<typeof ConnectionTestSuccess> | z.infer<typeof ConnectionTestFailure>;
+export interface StitchService {
+    /**
+     * Configure IAM permissions for Stitch API
+     */
+    configureIAM(input: ConfigureIAMInput): Promise<IAMConfigResult>;
+    /**
+     * Enable Stitch API for the project
+     */
+    enableAPI(input: EnableAPIInput): Promise<APIEnableResult>;
+    /**
+    * Test the connection to the Stitch API
+     */
+    testConnection(input: TestConnectionInput): Promise<ConnectionTestResult>;
+    /**
+     * Check if a user has a specific IAM role on a project
+     */
+    checkIAMRole(input: {
+        projectId: string;
+        userEmail: string;
+    }): Promise<boolean>;
+    /**
+     * Check if the Stitch API is enabled for a project
+     */
+    checkAPIEnabled(input: {
+        projectId: string;
+    }): Promise<boolean>;
+}

package/dist/src/services/stitch/spec.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/ui/spinner.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wrapper for ora spinner with consistent styling
+ */
+export declare class Spinner {
+    private spinner;
+    start(message: string): void;
+    succeed(message: string): void;
+    fail(message: string): void;
+    stop(): void;
+}
+export declare function createSpinner(): Spinner;

package/dist/src/ui/theme.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Theme colors matching the shell script aesthetic
+ */
+export declare const theme: {
+    blue: import("chalk").ChalkInstance;
+    green: import("chalk").ChalkInstance;
+    gray: import("chalk").ChalkInstance;
+    red: import("chalk").ChalkInstance;
+    yellow: import("chalk").ChalkInstance;
+    cyan: import("chalk").ChalkInstance;
+    bgDark: import("chalk").ChalkInstance;
+};
+export declare const icons: {
+    success: string;
+    error: string;
+    info: string;
+    warning: string;
+};

package/dist/src/ui/wizard.d.ts

@@ -0,0 +1,24 @@
+export type McpClient = 'antigravity' | 'vscode' | 'cursor' | 'claude-code' | 'gemini-cli';
+/**
+ * Prompt user to select their MCP client
+ */
+export declare function promptMcpClient(): Promise<McpClient>;
+/**
+ * Prompt user to select from a list of options
+ */
+export declare function promptSelect<T extends string>(message: string, choices: Array<{
+    name: string;
+    value: T;
+}>): Promise<T>;
+/**
+ * Prompt user to enter text
+ */
+export declare function promptInput(message: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt user for confirmation
+ */
+export declare function promptConfirm(message: string, defaultValue?: boolean): Promise<boolean>;
+/**
+ * Prompt user to select transport type
+ */
+export declare function promptTransportType(): Promise<'http' | 'stdio'>;

package/dist/tests/mocks/shell.d.ts

@@ -0,0 +1,2 @@
+import type { ShellResult } from '../../src/platform/shell.js';
+export declare const mockExecCommand: import("bun:test").Mock<(command: string[], options?: any) => Promise<ShellResult>>;

package/dist/ui/JsonTree.d.ts

@@ -1,4 +1,4 @@
-import { type NavigationResult } from './navigation-behaviors/index.js';
+import { type NavigationResult } from './navigation-behaviors/handler.js';
 interface JsonTreeProps {
     data: any;
     /** Optional label for root object - when set, root is selectable for copying */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_davideast/stitch-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Stitch MCP CLI helper. Automates Google Cloud authentication. Generates MCP config for your client. Sets up a proxy server.",
   "type": "module",
   "publishConfig": {
@@ -23,7 +23,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun build src/index.ts src/cli.ts --outdir=dist --target=node --format=esm --external lightningcss --external vite --external @astrojs/compiler && tsc -p tsconfig.build.json && bun scripts/generate-bin.ts",
+    "build": "bun run scripts/build.ts && tsc -p tsconfig.build.json && bun scripts/generate-bin.ts",
     "dev": "bun run src/cli.ts",
     "test": "bun test --preload ./tests/setup.ts",
     "prepublishOnly": "bun run build",

package/dist/commands/registry.d.ts

@@ -1,2 +0,0 @@
-import { type CommandDefinition } from '../framework/CommandDefinition.js';
-export declare const commands: CommandDefinition[];

package/dist/ui/copy-behaviors/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Copy behaviors for JSON viewer.
- * Provides isolated, reusable copy handlers.
- */
-export type { CopyHandler, CopyContext, CopyResult, PathMatcher } from './types.js';
-export { copyText, copyJson, downloadAndCopyImage } from './clipboard.js';
-export { defaultCopyHandler, imageUrlCopyHandler } from './handlers.js';
-export { registerHandler, getHandler, endsWith, contains } from './registry.js';

package/dist/ui/serve-behaviors/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Serve behaviors for JSON viewer.
- */
-export type { ServeHandler, ServeContext, ServeResult, PathMatcher } from './types.js';
-export { serveHtmlInMemory } from './server.js';
-export { htmlCodeServeHandler } from './handlers.js';
-export { registerServeHandler, getServeHandler, endsWith, contains } from './registry.js';