@tailor-platform/sdk 1.22.0 → 1.24.0

package/dist/{query-Bz2oDGhw.mjs → query-CV5n7DRd.mjs}

@@ -1,8 +1,7 @@
-import { t as db } from "./schema-Cjm-OvPF.mjs";
-import { $ as AuthSCIMAttribute_Mutability, A as platformBaseUrl, B as TailorDBType_Permission_Permit, C as readPlatformConfig, E as fetchMachineUserToken, F as WorkflowJobExecution_Status, H as PipelineResolver_OperationType, I as TailorDBGQLPermission_Action, J as ExecutorTriggerType, K as ExecutorJobStatus, L as TailorDBGQLPermission_Operator, M as userAgent, N as WorkspacePlatformUserRole, P as WorkflowExecution_Status, Q as AuthOAuth2Client_GrantType, R as TailorDBGQLPermission_Permit, S as loadWorkspaceId, T as fetchAll, U as IdPLang, V as TailorDBType_PermitAction, W as FunctionExecution_Status, X as AuthInvokerSchema, Y as AuthIDPConfig_AuthType, Z as AuthOAuth2Client_ClientType, _ as hashFile, a as loadConfig, at as UserProfileProviderConfig_UserProfileProviderType, b as loadFolderId, ct as Condition_Operator, d as TailorDBTypeSchema, dt as ApplicationSchemaUpdateAttemptStatus, et as AuthSCIMAttribute_Type, f as stringifyFunction, ft as Subgraph_ServiceType, g as getDistDir, h as createBundleCache, ht as symbols, it as TenantProviderConfig_TenantProviderType, j as resolveStaticWebsiteUrls, k as initOperatorClient, l as OAuth2ClientSchema, lt as FilterSchema, m as loadFilesWithIgnores, mt as styles, n as generatePluginFilesIfNeeded, nt as AuthSCIMConfig_AuthorizationType, ot as GetApplicationSchemaHealthResponse_ApplicationSchemaHealthStatus, p as tailorUserMap, pt as logger, q as ExecutorTargetType, r as loadApplication, s as createExecutorService, st as ConditionSchema, t as defineApplication, tt as AuthSCIMAttribute_Uniqueness, ut as PageDirection, w as writePlatformConfig, x as loadOrganizationId, y as loadAccessToken, z as TailorDBType_Permission_Operator } from "./application-CTQe2HSB.mjs";
-import { t as readPackageJson } from "./package-json-iVBhE5Ef.mjs";
-import { r as withSpan } from "./telemetry-C46fds1l.mjs";
-import { createRequire } from "node:module";
+import { t as db } from "./schema-0ByCZ2Ym.mjs";
+import { $ as AuthSCIMAttribute_Mutability, A as platformBaseUrl, B as TailorDBType_Permission_Permit, C as readPlatformConfig, E as fetchMachineUserToken, F as WorkflowJobExecution_Status, H as PipelineResolver_OperationType, I as TailorDBGQLPermission_Action, J as ExecutorTriggerType, K as ExecutorJobStatus, L as TailorDBGQLPermission_Operator, M as userAgent, N as WorkspacePlatformUserRole, P as WorkflowExecution_Status, Q as AuthOAuth2Client_GrantType, R as TailorDBGQLPermission_Permit, S as loadWorkspaceId, T as fetchAll, U as IdPLang, V as TailorDBType_PermitAction, W as FunctionExecution_Status, X as AuthInvokerSchema, Y as AuthIDPConfig_AuthType, Z as AuthOAuth2Client_ClientType, _ as hashFile, a as loadConfig, at as UserProfileProviderConfig_UserProfileProviderType, b as loadFolderId, ct as Condition_Operator, d as TailorDBTypeSchema, dt as ApplicationSchemaUpdateAttemptStatus, et as AuthSCIMAttribute_Type, f as stringifyFunction, ft as Subgraph_ServiceType, g as getDistDir, h as createBundleCache, ht as symbols, it as TenantProviderConfig_TenantProviderType, j as resolveStaticWebsiteUrls, k as initOperatorClient, l as OAuth2ClientSchema, lt as FilterSchema, m as loadFilesWithIgnores, mt as styles, n as generatePluginFilesIfNeeded, nt as AuthSCIMConfig_AuthorizationType, ot as GetApplicationSchemaHealthResponse_ApplicationSchemaHealthStatus, p as tailorUserMap, pt as logger, q as ExecutorTargetType, r as loadApplication, s as createExecutorService, st as ConditionSchema, t as defineApplication, tt as AuthSCIMAttribute_Uniqueness, ut as PageDirection, w as writePlatformConfig, x as loadOrganizationId, y as loadAccessToken, z as TailorDBType_Permission_Operator } from "./application-DThE2HW7.mjs";
+import { t as readPackageJson } from "./package-json-4G3gLWMd.mjs";
+import { r as withSpan } from "./telemetry-BPviAbME.mjs";
 import { arg, defineCommand, runCommand } from "politty";
 import { z } from "zod";
 import * as fs$1 from "node:fs";
@@ -14,6 +13,7 @@ import { getBorderCharacters, table } from "table";
 import { ValueSchema, timestampDate } from "@bufbuild/protobuf/wkt";
 import { Code, ConnectError } from "@connectrpc/connect";
 import { resolveTSConfig } from "pkg-types";
+import { tmpdir } from "node:os";
 import { findUpSync } from "find-up-simple";
 import ml from "multiline-ts";
 import * as crypto from "node:crypto";
@@ -28,7 +28,9 @@ import { setTimeout as setTimeout$1 } from "timers/promises";
 import { spawn } from "node:child_process";
 import { watch } from "chokidar";
 import * as madgeModule from "madge";
+import { createInterface } from "node:readline/promises";
 import { astVisitor, parse, toSql } from "pgsql-ast-parser";
+import { parse as parse$1 } from "@0no-co/graphql.web";
 
 //#region src/cli/shared/errors.ts
 /**
@@ -211,7 +213,7 @@ const withCommonArgs = (handler) => async (args) => {
 	try {
 		if ("json" in args && typeof args.json === "boolean") logger.jsonMode = args.json;
 		loadEnvFiles(args["env-file"], args["env-file-if-exists"]);
-		const { initTelemetry } = await import("./telemetry-BAxP8-PR.mjs");
+		const { initTelemetry } = await import("./telemetry-Dq5FZUH0.mjs");
 		await initTelemetry();
 		await handler(args);
 	} catch (error) {
@@ -224,7 +226,7 @@ const withCommonArgs = (handler) => async (args) => {
 		} else logger.error(`Unknown error: ${error}`);
 		process.exit(1);
 	} finally {
-		const { shutdownTelemetry } = await import("./telemetry-BAxP8-PR.mjs");
+		const { shutdownTelemetry } = await import("./telemetry-Dq5FZUH0.mjs");
 		await shutdownTelemetry();
 	}
 	process.exit(0);
@@ -519,7 +521,6 @@ export {};
 
 `;
 }
-const require = createRequire(import.meta.url);
 function collectAttributesFromConfig(config) {
 	const auth = config.auth;
 	if (!auth || typeof auth !== "object") return {};
@@ -562,12 +563,7 @@ function collectAttributesFromConfig(config) {
 * @returns Absolute path to the type definition file
 */
 function resolveTypeDefinitionPath(configPath) {
-	const typePath = process.env.TAILOR_PLATFORM_SDK_TYPE_PATH;
-	if (typePath) return path.resolve(process.cwd(), typePath);
-	const configDir = path.dirname(path.resolve(configPath));
-	const packageDir = resolvePackageDirectory(configDir);
-	if (!packageDir) return path.join(configDir, "node_modules", "@tailor-platform", "sdk", "dist", "user-defined.d.ts");
-	return path.join(packageDir, "dist", "user-defined.d.ts");
+	return path.join(path.dirname(path.resolve(configPath)), "tailor.d.ts");
 }
 /**
 * Generate user type definitions from the app config and write them to disk.
@@ -595,33 +591,16 @@ async function generateUserTypes(options) {
 		logger.error(String(error));
 	}
 }
-function resolvePackageDirectory(startDir) {
-	let currentDir = startDir;
-	const root = path.parse(currentDir).root;
-	while (true) {
-		const candidate = path.join(currentDir, "node_modules", "@tailor-platform", "sdk");
-		const packageJsonPath = path.join(candidate, "package.json");
-		if (fs$1.existsSync(packageJsonPath)) return candidate;
-		if (currentDir === root) break;
-		currentDir = path.dirname(currentDir);
-	}
-	try {
-		const resolved = require.resolve("@tailor-platform/sdk/package.json", { paths: [startDir] });
-		return path.dirname(resolved);
-	} catch {
-		return null;
-	}
-}
 
 //#endregion
-//#region src/parser/plugin-config/generation-types.ts
+//#region src/types/plugin-generation.ts
 /**
 * Derives generation-time dependency set from hook presence on a plugin.
-* @param plugin - Plugin to check for generation hooks
-* @param plugin.onTailorDBReady - TailorDB phase-complete hook
-* @param plugin.onResolverReady - Resolver phase-complete hook
-* @param plugin.onExecutorReady - Executor phase-complete hook
-* @returns Set of dependency kinds based on which hooks are implemented
+* @param plugin - The plugin object to inspect.
+* @param plugin.onTailorDBReady - Hook for TailorDB readiness.
+* @param plugin.onResolverReady - Hook for resolver readiness.
+* @param plugin.onExecutorReady - Hook for executor readiness.
+* @returns Set of dependency kinds required by the plugin.
 */
 function getPluginGenerationDependencies(plugin) {
 	const deps = /* @__PURE__ */ new Set();
@@ -632,11 +611,11 @@ function getPluginGenerationDependencies(plugin) {
 }
 /**
 * Checks if a plugin has any generation-time hooks.
-* @param plugin - Plugin to check
-* @param plugin.onTailorDBReady - TailorDB phase-complete hook
-* @param plugin.onResolverReady - Resolver phase-complete hook
-* @param plugin.onExecutorReady - Executor phase-complete hook
-* @returns True if the plugin has at least one generation hook
+* @param plugin - The plugin object to inspect.
+* @param plugin.onTailorDBReady - Hook for TailorDB readiness.
+* @param plugin.onResolverReady - Hook for resolver readiness.
+* @param plugin.onExecutorReady - Hook for executor readiness.
+* @returns True if the plugin has at least one generation hook.
 */
 function hasGenerationHooks(plugin) {
 	return !!(plugin.onTailorDBReady || plugin.onResolverReady || plugin.onExecutorReady);
@@ -3694,7 +3673,7 @@ function createSnapshotFieldConfig(field) {
 }
 /**
 * Create a snapshot field config from an OperatorFieldConfig (for nested fields)
-* @param {import("@/parser/service/tailordb/types").OperatorFieldConfig} fieldConfig - Field configuration
+* @param {import("@/types/tailordb").OperatorFieldConfig} fieldConfig - Field configuration
 * @returns {SnapshotFieldConfig} Snapshot field configuration
 */
 function createSnapshotFieldConfigFromOperatorConfig(fieldConfig) {
@@ -9549,6 +9528,70 @@ function logBetaWarning(featureName) {
 	logger.newline();
 }
 
+//#endregion
+//#region src/cli/shared/editor.ts
+const DEFAULT_EDITOR = "editor";
+function normalizeEditorCommand(editor) {
+	const normalized = editor?.trim();
+	return normalized && normalized.length > 0 ? normalized : void 0;
+}
+/**
+* Resolve an editor command only from explicit environment variables.
+* @returns Configured editor command, if any
+*/
+function getConfiguredEditorCommand() {
+	return normalizeEditorCommand(process.env.VISUAL) ?? normalizeEditorCommand(process.env.EDITOR);
+}
+/**
+* Resolve the editor command used for interactive file editing.
+* @returns Configured editor command or the system default fallback
+*/
+function getEditorCommand() {
+	return getConfiguredEditorCommand() ?? DEFAULT_EDITOR;
+}
+function parseEditorCommand(editor) {
+	const [command, ...args] = editor.trim().split(/\s+/);
+	if (!command) throw new Error("Editor command is empty.");
+	return {
+		command,
+		args
+	};
+}
+/**
+* Open a file in the resolved editor and wait for the process to exit.
+* @param filePath - File path to open
+* @param editor - Editor command string
+* @returns Whether an editor process was launched
+*/
+async function openInEditor(filePath, editor = getEditorCommand()) {
+	const { command, args } = parseEditorCommand(editor);
+	await new Promise((resolve$1, reject) => {
+		const child = spawn(command, [...args, filePath], {
+			stdio: "inherit",
+			detached: false
+		});
+		child.once("error", (error) => reject(error));
+		child.once("close", (code) => {
+			if (code == null || code === 0) {
+				resolve$1();
+				return;
+			}
+			reject(/* @__PURE__ */ new Error(`Editor exited with code ${code}.`));
+		});
+	});
+	return true;
+}
+/**
+* Open a file only when an editor is explicitly configured in the environment.
+* @param filePath - File path to open
+* @returns Whether an editor process was launched
+*/
+async function openInConfiguredEditor(filePath) {
+	const editor = getConfiguredEditorCommand();
+	if (!editor) return false;
+	return await openInEditor(filePath, editor);
+}
+
 //#endregion
 //#region src/cli/commands/tailordb/migrate/db-types-generator.ts
 /**
@@ -10058,7 +10101,7 @@ async function generate(options) {
 	if (options.init) await handleInitOption(namespacesWithMigrations, options.yes);
 	let pluginManager;
 	if (plugins.length > 0) pluginManager = new PluginManager(plugins);
-	const { defineApplication: defineApplication$1 } = await import("./application-DdSu3baZ.mjs");
+	const { defineApplication: defineApplication$1 } = await import("./application-P1by1htu.mjs");
 	const application = defineApplication$1({
 		config,
 		pluginManager
@@ -10157,33 +10200,21 @@ async function generateDiffFromSnapshot(previousSnapshot, currentSnapshot, migra
 		logger.newline();
 		logger.log("A migration script was generated for breaking changes.");
 		logger.log("Please review and edit the script before running 'tailor-sdk apply'.");
-		await openInEditor(result.migrateFilePath);
-	}
-}
-/**
-* Open a file in the user's preferred editor
-* @param {string} filePath - Path to file to open
-* @returns {Promise<void>} Promise that resolves when editor closes
-*/
-async function openInEditor(filePath) {
-	const editor = process.env.EDITOR;
-	if (!editor) return;
-	try {
-		await fs.access(filePath);
-	} catch {
-		return;
+		const editor = getConfiguredEditorCommand();
+		if (!editor) return;
+		try {
+			await fs.access(result.migrateFilePath);
+		} catch {
+			return;
+		}
+		logger.newline();
+		logger.info(`Opening ${path.basename(result.migrateFilePath)} in ${editor}...`);
+		try {
+			await openInConfiguredEditor(result.migrateFilePath);
+		} catch {
+			return;
+		}
 	}
-	const [command, ...args] = editor.trim().split(/\s+/);
-	logger.newline();
-	logger.info(`Opening ${path.basename(filePath)} in ${editor}...`);
-	const child = spawn(command, [...args, filePath], {
-		stdio: "inherit",
-		detached: false
-	});
-	await new Promise((resolve$1) => {
-		child.on("close", () => resolve$1());
-		child.on("error", () => resolve$1());
-	});
 }
 /**
 * CLI command definition for generate
@@ -11451,6 +11482,118 @@ function mapQueryExecutionError(args) {
 	return args.error instanceof Error ? args.error : new Error(message);
 }
 
+//#endregion
+//#region src/cli/query/graphql-repl.ts
+/**
+* Return true when the buffered GraphQL input parses as a complete document.
+* @param input - Buffered GraphQL input
+* @returns True when the GraphQL document is complete and ready to execute
+*/
+function isGraphQLInputComplete(input) {
+	if (input.trim().length === 0) return false;
+	try {
+		parse$1(input);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+//#region src/cli/query/sql-repl.ts
+/**
+* Return true when the buffered SQL input ends with a real statement terminator.
+* @param input - Buffered SQL input
+* @returns True when the SQL statement is complete and ready to execute
+*/
+function isSqlInputComplete(input) {
+	let inSingleQuote = false;
+	let inDoubleQuote = false;
+	let inLineComment = false;
+	let blockCommentDepth = 0;
+	let dollarQuoteTag = null;
+	let lastSignificantTokenWasSemicolon = false;
+	for (let i = 0; i < input.length; i += 1) {
+		const char = input[i];
+		const next = input[i + 1];
+		if (inLineComment) {
+			if (char === "\n") inLineComment = false;
+			continue;
+		}
+		if (blockCommentDepth > 0) {
+			if (char === "/" && next === "*") {
+				blockCommentDepth += 1;
+				i += 1;
+				continue;
+			}
+			if (char === "*" && next === "/") {
+				blockCommentDepth -= 1;
+				i += 1;
+			}
+			continue;
+		}
+		if (dollarQuoteTag != null) {
+			if (input.startsWith(dollarQuoteTag, i)) {
+				i += dollarQuoteTag.length - 1;
+				dollarQuoteTag = null;
+			}
+			continue;
+		}
+		if (inSingleQuote) {
+			if (char === "'" && next === "'") {
+				i += 1;
+				continue;
+			}
+			if (char === "'") inSingleQuote = false;
+			continue;
+		}
+		if (inDoubleQuote) {
+			if (char === "\"" && next === "\"") {
+				i += 1;
+				continue;
+			}
+			if (char === "\"") inDoubleQuote = false;
+			continue;
+		}
+		if (char === "-" && next === "-") {
+			inLineComment = true;
+			i += 1;
+			continue;
+		}
+		if (char === "/" && next === "*") {
+			blockCommentDepth = 1;
+			i += 1;
+			continue;
+		}
+		if (char === "'") {
+			lastSignificantTokenWasSemicolon = false;
+			inSingleQuote = true;
+			continue;
+		}
+		if (char === "\"") {
+			lastSignificantTokenWasSemicolon = false;
+			inDoubleQuote = true;
+			continue;
+		}
+		if (char === "$") {
+			const rest = input.slice(i);
+			const match = rest.match(/^\$[A-Za-z_][A-Za-z0-9_]*\$/) ?? rest.match(/^\$\$/);
+			if (match != null) {
+				lastSignificantTokenWasSemicolon = false;
+				dollarQuoteTag = match[0];
+				i += match[0].length - 1;
+				continue;
+			}
+		}
+		if (char === ";") {
+			lastSignificantTokenWasSemicolon = true;
+			continue;
+		}
+		if (!/\s/.test(char)) lastSignificantTokenWasSemicolon = false;
+	}
+	return lastSignificantTokenWasSemicolon && !inSingleQuote && !inDoubleQuote && blockCommentDepth === 0 && dollarQuoteTag == null;
+}
+
 //#endregion
 //#region src/cli/query/sql-type-extractor.ts
 /**
@@ -11560,14 +11703,14 @@ async function loadTypeFieldOrder(config, namespace) {
 //#endregion
 //#region src/cli/query/index.ts
 const queryEngineSchema = z.enum(["sql", "gql"]);
-const queryOptionsSchema = z.object({
+const queryBaseOptionsSchema = z.object({
 	workspaceId: z.string().optional(),
 	profile: z.string().optional(),
 	configPath: z.string().optional(),
 	engine: queryEngineSchema,
-	query: z.string(),
 	machineUser: z.string()
 });
+const queryOptionsSchema = queryBaseOptionsSchema.extend({ query: z.string() });
 async function getNamespaceFromSqlQuery(workspaceId, query$1, client, namespaces) {
 	if (namespaces.length === 0) throw new Error("No namespaces found in configuration.");
 	if (namespaces.length === 1) return namespaces[0];
@@ -11586,7 +11729,7 @@ async function getNamespaceFromSqlQuery(workspaceId, query$1, client, namespaces
 	throw new Error(`Query references types from multiple namespaces: ${[...namespacesFromTypes].join(", ")}.`);
 }
 async function loadOptions(options) {
-	const result = queryOptionsSchema.safeParse(options);
+	const result = queryBaseOptionsSchema.safeParse(options);
 	if (!result.success) throw new Error(result.error.issues[0].message);
 	const client = await initOperatorClient(await loadAccessToken({
 		useProfile: true,
@@ -11609,23 +11752,14 @@ async function loadOptions(options) {
 		name: result.data.machineUser
 	});
 	if (!machineUserResource) throw new Error(`Machine user ${result.data.machineUser} not found.`);
-	if (options.engine === "gql") return {
-		engine: options.engine,
-		client,
-		workspaceId,
-		config,
-		application,
-		machineUserResource
-	};
-	const namespace = await getNamespaceFromSqlQuery(workspaceId, result.data.query, client, namespaces);
 	return {
-		engine: options.engine,
+		engine: result.data.engine,
 		client,
 		workspaceId,
 		config,
 		application,
 		machineUserResource,
-		namespace
+		namespaces
 	};
 }
 async function sqlQuery(client, invoker, args) {
@@ -11679,40 +11813,242 @@ function parseExecutionResult(result) {
 	}
 }
 /**
+* Resolve query input mode from CLI args.
+* @param args - Query input flags
+* @param args.query - Direct query string
+* @param args.file - File path containing query text
+* @param args.edit - Open a query editor instead of REPL
+* @param args.engine - Query engine used to choose temp file extension
+* @returns Normalized input mode
+*/
+async function resolveQueryCommandInput(args) {
+	if (args.query != null) return {
+		mode: "query",
+		query: args.query
+	};
+	if (args.file != null) return {
+		mode: "query",
+		query: await fs.readFile(args.file, "utf-8")
+	};
+	if (args.edit) return await resolveEditedQueryInput(args.engine);
+	return { mode: "repl" };
+}
+async function resolveEditedQueryInput(engine) {
+	if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("Non-interactive terminals are not supported. Pass -q/--query or -f/--file to run a query.");
+	const editor = getEditorCommand();
+	const tempDir = await fs.mkdtemp(path.join(tmpdir(), "tailor-query-"));
+	const fileExtension = engine === "sql" ? "sql" : "graphql";
+	const filePath = path.join(tempDir, `query.${fileExtension}`);
+	const initialQuery = "";
+	try {
+		await fs.writeFile(filePath, initialQuery, "utf-8");
+		try {
+			await openInEditor(filePath, editor);
+		} catch (error) {
+			throw new Error(`Failed to open query editor "${editor}": ${error instanceof Error ? error.message : String(error)}`);
+		}
+		const editedQuery = await fs.readFile(filePath, "utf-8");
+		if (editedQuery.trim().length === 0 || editedQuery === initialQuery) return { mode: "abort" };
+		return {
+			mode: "query",
+			query: editedQuery
+		};
+	} finally {
+		await fs.rm(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+/**
 * Dispatch query execution.
 * @param options - Query command options
 * @returns Dispatch result
 */
 async function query(options) {
-	const { client, workspaceId, config, application, machineUserResource, engine, namespace } = await loadOptions(options);
-	try {
-		const bundledCode = await bundleQueryScript(engine);
-		const invoker = create(AuthInvokerSchema, {
-			namespace: application.authNamespace,
-			machineUserName: machineUserResource.name
-		});
-		switch (engine) {
-			case "sql": return reorderSqlColumns(await sqlQuery(client, invoker, {
-				workspaceId,
+	const result = queryOptionsSchema.safeParse(options);
+	if (!result.success) throw new Error(result.error.issues[0].message);
+	return await (await prepareQueryExecutor(result.data))(result.data.query);
+}
+async function prepareQueryExecutor(options) {
+	const { client, workspaceId, config, application, machineUserResource, engine, namespaces } = await loadOptions(options);
+	const bundledCode = await bundleQueryScript(engine);
+	const invoker = create(AuthInvokerSchema, {
+		namespace: application.authNamespace,
+		machineUserName: machineUserResource.name
+	});
+	return async (queryString) => {
+		let namespace;
+		try {
+			switch (engine) {
+				case "sql":
+					namespace = await getNamespaceFromSqlQuery(workspaceId, queryString, client, namespaces);
+					return reorderSqlColumns(await sqlQuery(client, invoker, {
+						workspaceId,
+						namespace,
+						bundledCode,
+						query: queryString
+					}), config, namespace, queryString);
+				case "gql": return await gqlQuery(client, invoker, application, machineUserResource, {
+					workspaceId,
+					bundledCode,
+					query: queryString
+				});
+				default: throw new Error(`Unsupported query engine: ${engine}`);
+			}
+		} catch (error) {
+			throw mapQueryExecutionError({
+				error,
+				engine,
 				namespace,
-				bundledCode,
-				query: options.query
-			}), config, namespace, options.query);
-			case "gql": return await gqlQuery(client, invoker, application, machineUserResource, {
-				workspaceId,
-				bundledCode,
-				query: options.query
+				machineUser: options.machineUser
 			});
-			default: throw new Error(`Unsupported query engine: ${engine}`);
 		}
-	} catch (error) {
-		throw mapQueryExecutionError({
-			error,
-			engine,
-			namespace,
-			machineUser: options.machineUser
-		});
+	};
+}
+function isReadlineTerminationError(error) {
+	if (!(error instanceof Error) || !("code" in error)) return false;
+	return error.code === "ABORT_ERR" || error.code === "ERR_USE_AFTER_CLOSE";
+}
+/**
+* Resolve a backslash REPL command into its normalized action.
+* @param input - Raw user input
+* @returns Normalized REPL command, or null for non-command input
+*/
+function resolveReplCommand(input) {
+	const trimmed = input.trim();
+	if (!trimmed.startsWith("\\")) return null;
+	if (trimmed === "\\q" || trimmed === "\\quit") return "quit";
+	if (trimmed === "\\help" || trimmed === "\\h" || trimmed === "\\?") return "help";
+	if (trimmed === "\\clear" || trimmed === "\\c") return "clear";
+	return "unknown";
+}
+/**
+* Decide how REPL should react to Ctrl+C based on current buffered input.
+* @param bufferedLines - Previously accepted lines in the current statement buffer
+* @param currentLine - In-progress line currently being edited
+* @returns Whether to clear the buffer or exit the REPL
+*/
+function resolveReplInterruptAction(bufferedLines, currentLine) {
+	if (bufferedLines.length === 0 && currentLine.length === 0) return "exit";
+	return "clear";
+}
+/**
+* Clear the interactive terminal screen and move the cursor to the top-left.
+*/
+function clearReplScreen() {
+	process.stdout.write("\x1Bc");
+}
+async function runRepl(options) {
+	if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("Non-interactive terminals are not supported. Pass -q/--query or -f/--file to run a query.");
+	const execute = await prepareQueryExecutor(options);
+	const rl = createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	logger.info(`Entering ${options.engine.toUpperCase()} REPL mode.`);
+	logger.info("Type \\help for usage, \\q to quit.");
+	const lines = [];
+	try {
+		while (true) {
+			const prompt = lines.length === 0 ? `${options.engine}> ` : " ";
+			let line;
+			let interruptAction = null;
+			const controller = new AbortController();
+			const handleSigint = () => {
+				interruptAction = resolveReplInterruptAction(lines, rl.line);
+				if (interruptAction === "clear") {
+					lines.length = 0;
+					rl.write(null, {
+						ctrl: true,
+						name: "u"
+					});
+					process.stdout.write("\n");
+				} else rl.close();
+				controller.abort();
+			};
+			rl.once("SIGINT", handleSigint);
+			try {
+				line = await rl.question(prompt, { signal: controller.signal });
+			} catch (error) {
+				rl.off("SIGINT", handleSigint);
+				if (controller.signal.aborted) {
+					if (interruptAction === "exit") return;
+					continue;
+				}
+				if (isReadlineTerminationError(error)) return;
+				throw error;
+			} finally {
+				rl.off("SIGINT", handleSigint);
+			}
+			const trimmed = line.trim();
+			if (lines.length === 0 && trimmed === "") continue;
+			if (lines.length === 0) {
+				const command = resolveReplCommand(trimmed);
+				if (command === "quit") return;
+				if (command === "help") {
+					printReplHelp(options.engine);
+					continue;
+				}
+				if (command === "clear") {
+					clearReplScreen();
+					continue;
+				}
+				if (command === "unknown") {
+					logger.warn(`Unknown command: ${trimmed}`);
+					continue;
+				}
+			}
+			lines.push(line);
+			if (options.engine === "sql") {
+				if (!isSqlInputComplete(lines.join("\n"))) continue;
+			} else if (!isGraphQLInputComplete(lines.join("\n"))) continue;
+			const statement = getReplStatement(lines, options.engine);
+			lines.length = 0;
+			if (statement.length === 0) continue;
+			try {
+				if (options.engine === "sql") {
+					const result$1 = await execute(statement);
+					if (result$1.engine !== "sql") throw new Error(`Expected sql engine result but got: ${result$1.engine}`);
+					printSqlResult(result$1, { json: options.json });
+					continue;
+				}
+				const result = await execute(statement);
+				if (result.engine !== "gql") throw new Error(`Expected gql engine result but got: ${result.engine}`);
+				printGqlResult(result, { json: options.json });
+			} catch (error) {
+				if (isCLIError(error)) {
+					logger.log(error.format());
+					continue;
+				}
+				if (error instanceof Error) {
+					logger.error(error.message);
+					continue;
+				}
+				logger.error(String(error));
+			}
+		}
+	} finally {
+		rl.close();
+	}
+}
+function getReplStatement(lines, engine) {
+	if (engine === "sql") return lines.join("\n").trim();
+	let end = lines.length;
+	while (end > 0 && lines[end - 1].trim() === "") end -= 1;
+	return lines.slice(0, end).join("\n").trim();
+}
+function printReplHelp(engine) {
+	logger.log("REPL commands:");
+	logger.log("  \\help, \\h, \\?         Show this help");
+	logger.log("  Ctrl+C                Clear current input");
+	logger.log("  \\q, \\quit, Ctrl+D     Exit REPL");
+	logger.log("  \\clear, \\c            Clear the screen");
+	if (engine === "sql") {
+		logger.log("SQL execution: statement ending with ';' runs immediately.");
+		return;
 	}
+	logger.log("GraphQL execution: a complete GraphQL document runs immediately.");
 }
 /**
 * Execute SQL query directly.
@@ -11793,28 +12129,73 @@ const queryCommand = defineCommand({
 		...jsonArgs,
 		...deploymentArgs,
 		engine: arg(queryEngineSchema, { description: "Query engine (sql or gql)" }),
-		query: arg(z.string(), {
+		query: arg(z.string().optional(), {
 			alias: "q",
-			description: "Query string to execute directly"
+			description: "Query string to execute directly; omit to start REPL mode"
 		}),
+		file: arg(z.string().optional(), {
+			alias: "f",
+			description: "Read query string from file; omit to start REPL mode"
+		}),
+		edit: arg(z.boolean().default(false), { description: "Open a temporary file in your editor; omit to start REPL mode" }),
 		machineuser: arg(z.string(), {
 			alias: "m",
 			description: "Machine user name for query execution"
 		})
+	}).superRefine((args, ctx) => {
+		if (args.query != null && args.file != null) ctx.addIssue({
+			code: "custom",
+			path: ["file"],
+			message: "Pass either -q/--query or -f/--file, not both."
+		});
+		if (args.edit && args.query != null) ctx.addIssue({
+			code: "custom",
+			path: ["edit"],
+			message: "Pass only one of --edit, -q/--query, or -f/--file."
+		});
+		if (args.edit && args.file != null) ctx.addIssue({
+			code: "custom",
+			path: ["edit"],
+			message: "Pass only one of --edit, -q/--query, or -f/--file."
+		});
 	}).strict(),
 	run: withCommonArgs(async (args) => {
+		const mode = await resolveQueryCommandInput({
+			query: args.query,
+			file: args.file,
+			edit: args.edit,
+			engine: args.engine
+		});
 		const sharedOptions = {
 			workspaceId: args["workspace-id"],
 			profile: args.profile,
 			configPath: args.config,
-			query: args.query,
+			engine: args.engine,
 			machineUser: args.machineuser
 		};
+		if (mode.mode === "abort") {
+			logger.info("Editor closed without a query. Nothing was executed.");
+			return;
+		}
+		if (mode.mode === "repl") {
+			await runRepl({
+				...sharedOptions,
+				json: args.json
+			});
+			return;
+		}
+		const directQuery = mode.query;
 		if (args.engine === "sql") {
-			printSqlResult(await querySql(sharedOptions), { json: args.json });
+			printSqlResult(await querySql({
+				...sharedOptions,
+				query: directQuery
+			}), { json: args.json });
 			return;
 		}
-		printGqlResult(await queryGql(sharedOptions), { json: args.json });
+		printGqlResult(await queryGql({
+			...sharedOptions,
+			query: directQuery
+		}), { json: args.json });
 	})
 });
 function isSQLExecutionResult(value) {
@@ -11894,4 +12275,4 @@ function printGqlResult(result, options = {}) {
 
 //#endregion
 export { getExecutorJob as $, truncateCommand as A, getMigrationDirPath as At, getCommand$1 as B, getNamespacesWithMigrations as Bt, getAppHealth as C, MIGRATE_FILE_NAME as Ct, listCommand$3 as D, createSnapshotFromLocalTypes as Dt, resumeWorkflow as E, compareSnapshots as Et, showCommand as F, loadDiff as Ft, listMachineUsers as G, commonArgs as Gt, getMachineUserToken as H, generateUserTypes as Ht, remove as I, reconstructSnapshotFromMigrations as It, webhookCommand as J, jsonArgs as Jt, generate$1 as K, confirmationArgs as Kt, removeCommand$1 as L, formatDiffSummary as Lt, generateCommand as M, getMigrationFiles as Mt, logBetaWarning as N, getNextMigrationNumber as Nt, listWorkflows as O, formatMigrationNumber as Ot, show as P, isValidMigrationNumber as Pt, listExecutors as Q, listCommand$4 as R, formatMigrationDiff as Rt, listCommand$2 as S, INITIAL_SCHEMA_NUMBER as St, resumeCommand as T, compareLocalTypesWithSnapshot as Tt, tokenCommand as U, apiCall as Ut, getOAuth2Client as V, trnPrefix as Vt, listCommand$5 as W, apiCommand as Wt, triggerExecutor as X, workspaceArgs as Xt, triggerCommand as Y, withCommonArgs as Yt, listCommand$6 as Z, deleteCommand as _, MIGRATION_LABEL_KEY as _t, removeCommand as a, getCommand$2 as at, createWorkspace as b, DB_TYPES_FILE_NAME as bt, listUsers as c, getWorkflowExecution as ct, restoreCommand as d, formatKeyValueTable as dt, jobsCommand as et, restoreWorkspace as f, getCommand$3 as ft, getWorkspace as g, waitForExecution$1 as gt, getCommand as h, executeScript as ht, updateUser as i, startWorkflow as it, generate as j, getMigrationFilePath as jt, truncate as k, getLatestMigrationNumber as kt, inviteCommand as l, listWorkflowExecutions as lt, listWorkspaces as m, apply as mt, queryCommand as n, watchExecutorJob as nt, removeUser as o, getWorkflow as ot, listCommand$1 as p, getExecutor as pt, listWebhookExecutors as q, deploymentArgs as qt, updateCommand as r, startCommand as rt, listCommand as s, executionsCommand as st, query as t, listExecutorJobs as tt, inviteUser as u, functionExecutionStatusToString as ut, deleteWorkspace as v, parseMigrationLabelNumber as vt, healthCommand as w, SCHEMA_FILE_NAME as wt, listApps as x, DIFF_FILE_NAME as xt, createCommand as y, bundleMigrationScript as yt, listOAuth2Clients as z, hasChanges as zt };
-//# sourceMappingURL=query-Bz2oDGhw.mjs.map
+//# sourceMappingURL=query-CV5n7DRd.mjs.map