@tailor-platform/sdk 1.75.0 → 1.76.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @tailor-platform/sdk
 
+## 1.76.0
+
+### Minor Changes
+
+- [#1699](https://github.com/tailor-platform/sdk/pull/1699) [`f6a8d07`](https://github.com/tailor-platform/sdk/commit/f6a8d0779f94c2de5502dfdc68348e4a41ceee47) Thanks [@dqn](https://github.com/dqn)! - Allow `setup coordinate --action` values to group multiple generated actions into one multi-config deploy by separating action names with commas.
+
+### Patch Changes
+
+- [#1702](https://github.com/tailor-platform/sdk/pull/1702) [`03143f5`](https://github.com/tailor-platform/sdk/commit/03143f5213d9fa9d3c7697de78f2376994716679) Thanks [@dqn](https://github.com/dqn)! - Clarify the setup delete warning for coordinator action references so grouped `--action` values tell users to remove the action name from the relevant value.
+
+- [#1691](https://github.com/tailor-platform/sdk/pull/1691) [`2f3dbab`](https://github.com/tailor-platform/sdk/commit/2f3dbab7ed3cf40fa174a82053d70c23c356204d) Thanks [@dqn](https://github.com/dqn)! - Clarify when profile machine user override errors are caused by `TAILOR_PLATFORM_MACHINE_USER_NAME`.
+
+- [#1701](https://github.com/tailor-platform/sdk/pull/1701) [`e8bcbdf`](https://github.com/tailor-platform/sdk/commit/e8bcbdf92f90f20cc292a4f6b998475e4aa35c8e) Thanks [@dqn](https://github.com/dqn)! - Show the `profile update --user` recovery command when `tailor-sdk login --profile` authenticates a different user than the profile references.
+
+- [#1698](https://github.com/tailor-platform/sdk/pull/1698) [`dd25b69`](https://github.com/tailor-platform/sdk/commit/dd25b69ba829e7d446731b4cbf2f6753d2abde95) Thanks [@dqn](https://github.com/dqn)! - Reject duplicate TailorDB type-level builder calls at type-check time and runtime instead of silently overwriting earlier settings.
+
 ## 1.75.0
 
 ### Minor Changes

package/dist/{application-DYshsH-K.mjs → application-BUfYmf0O.mjs}

@@ -1,4 +1,5 @@
 import { n as isSdkBranded } from "./brand-Eo4pLXPJ.mjs";
+import { i as PageDirection } from "./resource_pb-BRv7AMXK.mjs";
 import { t as assertDefined } from "./assert-DBxo8jPo.mjs";
 import { a as parseBoolean, n as logger, r as styles } from "./logger-BEiZZ3qT.mjs";
 import { a as TailorFieldSchema, i as AuthInvokerSchema, n as ExecutorSchema, o as loadFilesWithIgnores, r as AuthConfigSchema, s as functionSchema, t as createExecutorService } from "./service-BCRJ-3NV.mjs";
@@ -11,10 +12,12 @@ import { t as readPackageJson } from "./package-json-8b0O9TlX.mjs";
 import { i as userAgent, n as tightenSecretFilePermissions, r as writeSecretFile } from "./secret-file-VSVGy1V0.mjs";
 import { t as createCLIError } from "./errors-Dtf2WPaW.mjs";
 import { builtinModules, createRequire } from "node:module";
+import { arg } from "politty";
 import { z } from "zod";
 import { create } from "@bufbuild/protobuf";
 import * as fs$1 from "node:fs";
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { parseEnv } from "node:util";
 import { MethodOptions_IdempotencyLevel } from "@bufbuild/protobuf/wkt";
 import * as path from "pathe";
 import { join, resolve } from "pathe";
@@ -36,6 +39,256 @@ import { parseSync } from "oxc-parser";
 import * as inflection from "inflection";
 import * as globals from "globals";
 
+//#region src/cli/shared/args.ts
+const unitToMs = {
+	ms: 1,
+	s: 1e3,
+	m: 60 * 1e3
+};
+const durationPattern = /^(\d+)(ms|s|m)$/;
+/**
+* Schema for duration string validation (e.g., "3s", "500ms", "1m")
+* Only validates format; use parseDuration() to convert to milliseconds
+*/
+const durationArg = z.string().refine((val) => durationPattern.test(val), { message: "Invalid duration format. Expected format: '3s', '500ms', '1m'" }).refine((val) => {
+	const match = val.match(durationPattern);
+	if (!match) return false;
+	const digits = match[1];
+	return digits !== void 0 && parseInt(digits, 10) > 0;
+}, { message: "Duration must be greater than 0" });
+/**
+* Parse a validated duration string into milliseconds
+* @param duration - Duration string (e.g., "3s", "500ms", "1m")
+* @returns Duration in milliseconds
+*/
+function parseDuration(duration) {
+	const match = assertDefined(duration.match(durationPattern), `invalid duration format: ${duration}`);
+	const value = parseInt(assertDefined(match[1], "duration digits group missing"), 10);
+	const unit = assertDefined(match[2], "duration unit group missing");
+	return value * unitToMs[unit];
+}
+/**
+* Schema for positive integer validation (from string input)
+* Transforms the string to a number
+*/
+const positiveIntArg = z.coerce.number().int().positive();
+/**
+* Schema for non-negative integer validation (from string input).
+* Accepts 0 (used for `--limit 0` to disable the limit).
+*/
+const nonNegativeIntArg = z.coerce.number().int().nonnegative();
+/**
+* Schema for sort order (`asc` or `desc`).
+*/
+const orderArg = z.enum(["asc", "desc"]);
+/**
+* Translate a CLI `--order` value into the proto `PageDirection` enum.
+* Returns `undefined` when the user did not specify an order so that
+* callers can omit the field and fall back to the server default.
+* @param order - Order string from CLI args (`"asc"` | `"desc"` | undefined)
+* @returns PageDirection, or undefined when `order` is undefined
+*/
+function toPageDirection(order) {
+	if (order === void 0) return void 0;
+	return order === "asc" ? PageDirection.ASC : PageDirection.DESC;
+}
+function hasMachineUserFlag(argv) {
+	return argv.slice(0, argv.indexOf("--") === -1 ? argv.length : argv.indexOf("--")).some((token) => token === "-m" || token.startsWith("-m=") || token === "--machine-user" || token.startsWith("--machine-user=") || token === "--machineUser" || token.startsWith("--machineUser=") || token === "--machineuser" || token.startsWith("--machineuser="));
+}
+/**
+* Resolve whether a parsed machine user value came from an explicit CLI option or env fallback.
+* @param machineUser - Parsed machine user value
+* @param argv - Raw CLI argv, excluding the executable and script path
+* @param options - Source resolution options
+* @returns Machine user input source, or undefined when no value was parsed
+*/
+function resolveMachineUserInputSource(machineUser, argv = process.argv.slice(2), options = {}) {
+	if (machineUser === void 0) return void 0;
+	if (options.valueIsExplicit) return "option";
+	if (hasMachineUserFlag(argv)) return "option";
+	return process.env.TAILOR_PLATFORM_MACHINE_USER_NAME === machineUser ? "env" : "option";
+}
+/**
+* Load env files from parsed arguments.
+* Processes --env-file first, then --env-file-if-exists.
+*
+* Follows Node.js --env-file behavior:
+* - Variables already set in the environment are NOT overwritten
+* - Variables from later files override those from earlier files
+* @param envFiles - Required env file path(s) that must exist
+* @param envFilesIfExists - Optional env file path(s) that are loaded if they exist
+*/
+function loadEnvFiles(envFiles, envFilesIfExists) {
+	const originalEnvKeys = new Set(Object.keys(process.env));
+	const load = (files, required) => {
+		for (const file of [files ?? []].flat()) {
+			const envPath = path.resolve(process.cwd(), file);
+			if (!fs$1.existsSync(envPath)) {
+				if (required) throw new Error(`Environment file not found: ${envPath}`);
+				continue;
+			}
+			const parsed = parseEnv(fs$1.readFileSync(envPath, "utf-8"));
+			for (const [key, value] of Object.entries(parsed)) {
+				if (originalEnvKeys.has(key)) continue;
+				process.env[key] = value;
+			}
+		}
+	};
+	load(envFiles, true);
+	load(envFilesIfExists, false);
+}
+/**
+* Common arguments for all CLI commands
+*
+* NOTE: --env-file and --env-file-if-exists collide with Node.js flags due to a bug
+* (https://github.com/nodejs/node/issues/54232). Node.js parses these even after the
+* script path, causing warnings (twice due to tsx loader).
+*/
+const commonArgs = {
+	"env-file": arg(z.string().optional(), {
+		alias: "e",
+		description: "Path to the environment file (error if not found)",
+		completion: {
+			type: "file",
+			matcher: [".env.*", ".env"]
+		}
+	}),
+	"env-file-if-exists": arg(z.string().optional(), {
+		description: "Path to the environment file (ignored if not found)",
+		completion: {
+			type: "file",
+			matcher: [".env.*", ".env"]
+		},
+		effect: (_value, { args }) => {
+			loadEnvFiles(args["env-file"], args["env-file-if-exists"]);
+		}
+	}),
+	verbose: arg(z.boolean().default(false), {
+		description: "Enable verbose logging",
+		effect: (value) => {
+			verboseMode = value;
+		}
+	}),
+	json: arg(z.boolean().default(false), {
+		alias: "j",
+		description: "Output as JSON",
+		effect: (value) => {
+			logger.jsonMode = value;
+		}
+	})
+};
+/**
+* Arguments for commands that require workspace context
+*/
+const workspaceArgs = {
+	"workspace-id": arg(z.string().optional(), {
+		alias: "w",
+		description: "Workspace ID",
+		env: "TAILOR_PLATFORM_WORKSPACE_ID",
+		completion: { type: "none" }
+	}),
+	profile: arg(z.string().optional(), {
+		alias: "p",
+		description: "Workspace profile",
+		env: "TAILOR_PLATFORM_PROFILE",
+		completion: { type: "none" }
+	})
+};
+/**
+* Shared config arg for commands that accept a config file path
+*/
+const configArg = { config: arg(z.string().default("tailor.config.ts"), {
+	alias: "c",
+	description: "Path to SDK config file",
+	env: "TAILOR_PLATFORM_SDK_CONFIG_PATH",
+	completion: {
+		type: "file",
+		extensions: ["ts"]
+	}
+}) };
+/**
+* Shared config arg for commands that accept one or more comma-separated config file paths
+*/
+const multiConfigArg = { config: arg(z.string().default("tailor.config.ts"), {
+	alias: "c",
+	description: "Path to SDK config file. Use comma-separated paths to deploy multiple apps together.",
+	env: "TAILOR_PLATFORM_SDK_CONFIG_PATH",
+	completion: {
+		type: "file",
+		extensions: ["ts"]
+	}
+}) };
+/**
+* Arguments for commands that interact with deployed resources (includes config)
+*/
+const deploymentArgs = {
+	...workspaceArgs,
+	...configArg
+};
+/**
+* Arguments for commands that require confirmation
+*/
+const confirmationArgs = { yes: arg(z.boolean().default(false), {
+	alias: "y",
+	description: "Skip confirmation prompts"
+}) };
+/**
+* Arguments for commands that require organization context
+*/
+const organizationArgs = { "organization-id": arg(z.string(), {
+	alias: "o",
+	description: "Organization ID",
+	env: "TAILOR_PLATFORM_ORGANIZATION_ID",
+	completion: { type: "none" }
+}) };
+/**
+* Arguments for list commands that accept `--order` / `--limit`. Sort
+* order defaults to `desc` (newest first) because most callers want the
+* latest items; pass `--order asc` to opt in to ascending order. The
+* limit is unbounded by default so existing invocations keep returning
+* every item; pass `--limit N` to cap the result size.
+* @param defaultOrder - Default value for `--order` (defaults to `"desc"`)
+* @returns Argument shape suitable for spreading into a command schema
+*/
+const paginationArgs = (defaultOrder = "desc") => ({
+	order: arg(orderArg.default(defaultOrder), { description: "Sort order (asc or desc)" }),
+	limit: arg(nonNegativeIntArg.optional(), {
+		alias: "l",
+		description: "Maximum number of items to return (0 or omit: unlimited)"
+	})
+});
+/**
+* Arguments for time-series log list commands. Defaults to newest-first
+* (`desc`) and a 50-item cap so that listing stays responsive on busy
+* workspaces. Pass `--limit 0` to disable the cap and fetch all entries.
+*/
+const pagedLogArgs = {
+	order: arg(orderArg.default("desc"), { description: "Sort order (asc or desc)" }),
+	limit: arg(nonNegativeIntArg.default(50), {
+		alias: "l",
+		description: "Maximum number of items to return (0: unlimited)"
+	})
+};
+/**
+* Arguments for commands that require folder context
+*/
+const folderArgs = { "folder-id": arg(z.string(), {
+	alias: "f",
+	description: "Folder ID",
+	env: "TAILOR_PLATFORM_FOLDER_ID",
+	completion: { type: "none" }
+}) };
+let verboseMode = false;
+/**
+* Returns whether verbose mode is enabled.
+* Used by the global cleanup handler which doesn't have access to parsed args.
+* @returns Whether verbose mode is enabled
+*/
+function isVerbose() {
+	return verboseMode;
+}
+
+//#endregion
 //#region src/parser/app-config/log-level.ts
 const LOG_LEVELS = [
 	"DEBUG",
@@ -294,7 +547,7 @@ function initOAuth2Client(config) {
 */
 async function initOperatorClient(accessToken, config) {
 	const platformConfig = config ?? getPlatformConfigForToken(accessToken);
-	const [{ createTracingInterceptor }, { OperatorService }] = await Promise.all([import("./interceptor-D-q1rvRl.mjs"), import("./service_pb-D-PXRoMg.mjs")]);
+	const [{ createTracingInterceptor }, { OperatorService }] = await Promise.all([import("./interceptor-D-q1rvRl.mjs"), import("./service_pb-B2FF59sP.mjs")]);
 	const interceptors = [
 		await userAgentInterceptor(),
 		await bearerTokenInterceptor(accessToken),
@@ -1192,7 +1445,15 @@ async function loadMachineUserName(opts) {
 		message: "Machine user name cannot be empty.",
 		suggestion: "Pass a non-empty machine user name, or omit the option to use the environment variable or profile default."
 	});
-	const explicit = opts?.machineUser || process.env.TAILOR_PLATFORM_MACHINE_USER_NAME || void 0;
+	const envMachineUser = process.env.TAILOR_PLATFORM_MACHINE_USER_NAME || void 0;
+	const explicitMachineUser = opts?.machineUser ? {
+		source: opts.machineUserSource ?? "option",
+		value: opts.machineUser
+	} : envMachineUser ? {
+		source: "env",
+		value: envMachineUser
+	} : void 0;
+	const explicit = explicitMachineUser?.value;
 	const profile = opts?.profile || process.env.TAILOR_PLATFORM_PROFILE;
 	if (!profile) return explicit;
 	const entry = (await readPlatformConfig()).profiles[profile];
@@ -1201,12 +1462,15 @@ async function loadMachineUserName(opts) {
 		throw new Error(`Profile "${profile}" not found`);
 	}
 	if (entry.machine_user && entry.machine_user_override === "deny") {
-		if (explicit && explicit !== entry.machine_user) throw createCLIError({
-			code: "PROFILE_MACHINE_USER_OVERRIDE_DENIED",
-			message: `Profile "${profile}" denies overriding the machine user.`,
-			details: `This profile fixes the machine user to "${entry.machine_user}" for application-data commands.`,
-			suggestion: `Omit the machine user option, unset TAILOR_PLATFORM_MACHINE_USER_NAME, or run 'tailor-sdk profile update ${profile} --machine-user-override allow'.`
-		});
+		if (explicit && explicit !== entry.machine_user) {
+			const details = explicitMachineUser.source === "env" ? `The machine user is being set to "${explicit}" via the TAILOR_PLATFORM_MACHINE_USER_NAME environment variable, which conflicts with this profile's pinned machine user "${entry.machine_user}".` : `This profile fixes the machine user to "${entry.machine_user}" for application-data commands.`;
+			throw createCLIError({
+				code: "PROFILE_MACHINE_USER_OVERRIDE_DENIED",
+				message: `Profile "${profile}" denies overriding the machine user.`,
+				details,
+				suggestion: `Omit the machine user option, unset TAILOR_PLATFORM_MACHINE_USER_NAME, or run 'tailor-sdk profile update ${profile} --machine-user-override allow'.`
+			});
+		}
 		return entry.machine_user;
 	}
 	return explicit || entry.machine_user;
@@ -6582,5 +6846,5 @@ async function loadApplication(params) {
 }
 
 //#endregion
-export { getOAuth2ClientId as $, hasAnyUserTokenEntry as A, readPlatformConfig as B, createBundleCache as C, loadConfig as D, hashFile as E, loadMachineUserName as F, defaultPlatformBaseUrl as G, saveUserTokens as H, loadPlatformClientConfig as I, fetchMachineUserToken as J, fetchAll as K, loadStoredUserTokens as L, loadAccessToken as M, loadConfigPath as N, deleteUserTokens as O, loadConsoleBaseUrl as P, getConsoleBaseUrl as Q, loadWorkspaceId as R, hasGenerationHooks as S, hashContent as T, writePlatformConfig as U, resolveUserTokenKey as V, closeConnectionPool as W, fetchPlatformMachineUserToken as X, fetchPaged as Y, fetchUserInfo as Z, platformBundleDefinePlugin as _, resolveInlineSourcemap as a, resolveStaticWebsiteUrls as at, resolveBundleLogLevel as b, ResolverSchema as c, buildExecutorArgsExpr as d, getOrNull as et, buildResolverOperationHookExpr as f, stringifyFunction as g, TailorDBTypeSchema as h, resolverBundleKey as i, isDefaultPlatform as it, hasUserTokenEntry as j, fetchLatestToken as k, HTTP_METHODS as l, assertUniqueTailorDBTypeNamesWithExternal as m, generatePluginFilesIfNeeded as n, initOAuth2Client as nt, WorkflowJobFunctionExecutionPolicySchema as o, byName as ot, assertUniqueLocalTailorDBTypeNames as p, fetchAllTolerant as q, loadApplication as r, initOperatorClient as rt, WorkflowJobSchema as s, defineApplication as t, getPlatformBaseUrl as tt, INVOKER_EXPR as u, composeFunctionTreeshakeOptions as v, getDistDir as w, getPluginGenerationDependencies as x, createLogLevelTreeshakeOptions as y, platformConfigFromProfile as z };
-//# sourceMappingURL=application-DYshsH-K.mjs.map
+export { getOAuth2ClientId as $, hasAnyUserTokenEntry as A, readPlatformConfig as B, createBundleCache as C, toPageDirection as Ct, loadConfig as D, hashFile as E, loadMachineUserName as F, defaultPlatformBaseUrl as G, saveUserTokens as H, loadPlatformClientConfig as I, fetchMachineUserToken as J, fetchAll as K, loadStoredUserTokens as L, loadAccessToken as M, loadConfigPath as N, deleteUserTokens as O, loadConsoleBaseUrl as P, getConsoleBaseUrl as Q, loadWorkspaceId as R, hasGenerationHooks as S, resolveMachineUserInputSource as St, hashContent as T, writePlatformConfig as U, resolveUserTokenKey as V, closeConnectionPool as W, fetchPlatformMachineUserToken as X, fetchPaged as Y, fetchUserInfo as Z, platformBundleDefinePlugin as _, organizationArgs as _t, resolveInlineSourcemap as a, resolveStaticWebsiteUrls as at, resolveBundleLogLevel as b, parseDuration as bt, ResolverSchema as c, configArg as ct, buildExecutorArgsExpr as d, durationArg as dt, getOrNull as et, buildResolverOperationHookExpr as f, folderArgs as ft, stringifyFunction as g, orderArg as gt, TailorDBTypeSchema as h, nonNegativeIntArg as ht, resolverBundleKey as i, isDefaultPlatform as it, hasUserTokenEntry as j, fetchLatestToken as k, HTTP_METHODS as l, confirmationArgs as lt, assertUniqueTailorDBTypeNamesWithExternal as m, multiConfigArg as mt, generatePluginFilesIfNeeded as n, initOAuth2Client as nt, WorkflowJobFunctionExecutionPolicySchema as o, byName as ot, assertUniqueLocalTailorDBTypeNames as p, isVerbose as pt, fetchAllTolerant as q, loadApplication as r, initOperatorClient as rt, WorkflowJobSchema as s, commonArgs as st, defineApplication as t, getPlatformBaseUrl as tt, INVOKER_EXPR as u, deploymentArgs as ut, composeFunctionTreeshakeOptions as v, pagedLogArgs as vt, getDistDir as w, workspaceArgs as wt, getPluginGenerationDependencies as x, positiveIntArg as xt, createLogLevelTreeshakeOptions as y, paginationArgs as yt, platformConfigFromProfile as z };
+//# sourceMappingURL=application-BUfYmf0O.mjs.map