@mcp-consultant-tools/azure-sql 28.0.0-beta.7 → 29.0.0-beta.1

package/build/services/write-service.d.ts

@@ -0,0 +1,109 @@
+import type { ConnectionService } from './connection-service.js';
+export interface WriteResult {
+    success: boolean;
+    message: string;
+    objectName?: string;
+    rowsAffected?: number;
+}
+export interface UnrestrictedBatchResult {
+    batchIndex: number;
+    sql: string;
+    success: boolean;
+    rowsAffected?: number;
+    resultSet?: any[];
+    error?: string;
+}
+export interface UnrestrictedResult {
+    batches: UnrestrictedBatchResult[];
+    totalBatches: number;
+    completedBatches: number;
+}
+/**
+ * WriteService handles all write operations against Azure SQL databases:
+ * view management, stored procedure management/execution, and DML (INSERT/UPDATE/DELETE).
+ *
+ * Depends on ConnectionService for connection pooling.
+ */
+export declare class WriteService {
+    private readonly connectionService;
+    constructor(connectionService: ConnectionService);
+    /**
+     * Validate that a string is a safe SQL identifier (schema name, table name, etc.).
+     * Prevents SQL injection on object names.
+     */
+    private validateIdentifier;
+    /**
+     * Strip SQL comments and normalize whitespace for validation.
+     */
+    private cleanSql;
+    /**
+     * Validate a DML query starts with the expected keyword and contains no dangerous patterns.
+     */
+    private validateDmlQuery;
+    /**
+     * Create or alter a view.
+     */
+    manageView(serverId: string, database: string, schemaName: string, viewName: string, selectBody: string): Promise<WriteResult>;
+    /**
+     * Deploy a view from a local .sql file.
+     * Reads the file and executes its contents as-is against the database.
+     * The file must contain a valid CREATE OR ALTER VIEW statement.
+     */
+    deployViewFromFile(serverId: string, database: string, filePath: string): Promise<WriteResult>;
+    /**
+     * Drop a view if it exists.
+     */
+    dropView(serverId: string, database: string, schemaName: string, viewName: string): Promise<WriteResult>;
+    /**
+     * Create or alter a stored procedure.
+     */
+    manageSproc(serverId: string, database: string, schemaName: string, sprocName: string, definition: string): Promise<WriteResult>;
+    /**
+     * Deploy a stored procedure from a local .sql file.
+     * Reads the file and executes its contents as-is against the database.
+     * The file must contain a valid CREATE OR ALTER PROCEDURE statement.
+     */
+    deploySprocFromFile(serverId: string, database: string, filePath: string): Promise<WriteResult>;
+    /**
+     * Drop a stored procedure if it exists.
+     */
+    dropSproc(serverId: string, database: string, schemaName: string, sprocName: string): Promise<WriteResult>;
+    /**
+     * Execute a stored procedure using mssql request.execute() (not raw SQL).
+     * Parameters are passed via request.input() for safety.
+     */
+    executeSproc(serverId: string, database: string, schemaName: string, sprocName: string, parameters?: Record<string, any>): Promise<{
+        rows: any[];
+        rowCount: number;
+        returnValue: number;
+    }>;
+    /**
+     * Execute an INSERT query with safety validation.
+     */
+    executeInsert(serverId: string, database: string, query: string): Promise<WriteResult>;
+    /**
+     * Execute an UPDATE query with safety validation.
+     */
+    executeUpdate(serverId: string, database: string, query: string): Promise<WriteResult>;
+    /**
+     * Execute a DELETE query with safety validation.
+     * REQUIRES a WHERE clause to prevent accidental full-table deletes.
+     */
+    executeDelete(serverId: string, database: string, query: string): Promise<WriteResult>;
+    /**
+     * Split T-SQL on GO batch separators.
+     * Matches lines containing only GO (case-insensitive, optional whitespace).
+     */
+    private splitBatches;
+    /**
+     * Detect the primary operation type from a SQL batch for audit logging.
+     */
+    private detectOperationType;
+    /**
+     * Execute any T-SQL without restrictions. Supports multi-batch scripts with GO separators.
+     * This is the "break glass" method — no validation, no keyword restrictions.
+     * The caller (MCP tool / CLI) is responsible for gating behind SQL_ENABLE_UNRESTRICTED.
+     */
+    executeUnrestricted(serverId: string, database: string, sql: string): Promise<UnrestrictedResult>;
+}
+//# sourceMappingURL=write-service.d.ts.map

package/build/services/write-service.d.ts.map

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