@tailor-platform/sdk 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @tailor-platform/sdk
 
+## 1.4.0
+
+### Minor Changes
+
+- [#452](https://github.com/tailor-platform/sdk/pull/452) [`2428441`](https://github.com/tailor-platform/sdk/commit/2428441fd9df34428520adc578c6016f448f776c) Thanks [@toiroakr](https://github.com/toiroakr)! - feat(seed): improve exec script with colors and embedded config
+
+  - Remove yaml package dependency by embedding entity config in exec.mjs
+  - Replace entityNamespaces with namespaceEntities (Map<namespace, entities[]>)
+  - Add --yes flag to skip confirmation prompts
+  - Use node:util styleText for colored output (cyan, green, red, yellow, dim)
+  - Remove config.yaml generation (no longer needed)
+  - Improve array formatting in namespaceEntities (one element per line)
+
+### Patch Changes
+
+- [#453](https://github.com/tailor-platform/sdk/pull/453) [`9589142`](https://github.com/tailor-platform/sdk/commit/95891421eb3bcd645d6a15dbad2935fee9cd7a90) Thanks [@riku99](https://github.com/riku99)! - Updated jsdoc rules and jsdoc comments
+
+- [#451](https://github.com/tailor-platform/sdk/pull/451) [`46b42c4`](https://github.com/tailor-platform/sdk/commit/46b42c4e157026b891490e9ebc080dc8bbf05513) Thanks [@k1LoW](https://github.com/k1LoW)! - Add `publishSessionEvents` option to auth configuration
+
+- [#446](https://github.com/tailor-platform/sdk/pull/446) [`d57daaa`](https://github.com/tailor-platform/sdk/commit/d57daaaefa48744a0918a409f726564867759955) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency bufbuild/buf to v1.64.0
+
+- [#447](https://github.com/tailor-platform/sdk/pull/447) [`58dc5e1`](https://github.com/tailor-platform/sdk/commit/58dc5e1ffefd3c483c4dcd244a45742c01c52918) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency @jackchuka/gql-ingest to v3
+
+- [#448](https://github.com/tailor-platform/sdk/pull/448) [`3e27e60`](https://github.com/tailor-platform/sdk/commit/3e27e60a639291b6efe0ceef9ff6321f01ada338) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency turbo to v2.7.5
+
+- [#450](https://github.com/tailor-platform/sdk/pull/450) [`89e315c`](https://github.com/tailor-platform/sdk/commit/89e315c49c659790dc9448a90dcd89788ad7134e) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency @typescript/native-preview to v7.0.0-dev.20260117.1
+
+- [#454](https://github.com/tailor-platform/sdk/pull/454) [`e6bfac2`](https://github.com/tailor-platform/sdk/commit/e6bfac254900e301def16b8b7f9dbacea70e8fbf) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency aquaproj/aqua to v2.56.5
+
+- [#455](https://github.com/tailor-platform/sdk/pull/455) [`386c5bf`](https://github.com/tailor-platform/sdk/commit/386c5bf728a1e9a95febb52468af6921718b22fe) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency aquaproj/aqua-registry to v4.459.0
+
+- [#456](https://github.com/tailor-platform/sdk/pull/456) [`77ee396`](https://github.com/tailor-platform/sdk/commit/77ee396d645248dad1f201f7d219b036e66a6f93) Thanks [@renovate](https://github.com/apps/renovate)! - chore(deps): update dependency eslint-plugin-jsdoc to v62.1.0
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/cli/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "../chunk-CIV_ash9.mjs";
-import "../config-BmQRlW1j.mjs";
-import { $ as withCommonArgs, B as loadWorkspaceId, D as tokenCommand, F as loadConfig, G as initOAuth2Client, H as writePlatformConfig, J as PATScope, K as initOperatorClient, L as apiCommand, N as applyCommand, O as listCommand$5, Q as jsonArgs, R as fetchLatestToken, S as listCommand$6, U as fetchAll, V as readPlatformConfig, W as fetchUserInfo, X as confirmationArgs, Y as commonArgs, Z as deploymentArgs, a as createCommand$3, d as listCommand$7, et as workspaceArgs, h as executionsCommand, j as generateCommand, l as startCommand, p as getCommand$2, q as readPackageJson, r as deleteCommand$3, s as resumeCommand, t as listCommand$8, tt as logger, w as getCommand$1, x as removeCommand, y as showCommand, z as loadAccessToken } from "../list-BCl3ViG0.mjs";
+import "../config-CBpYlVa-.mjs";
+import { $ as deploymentArgs, A as listCommand$5, B as fetchLatestToken, C as removeCommand, E as getCommand$1, F as applyCommand, G as fetchAll, H as loadWorkspaceId, J as initOperatorClient, K as fetchUserInfo, L as loadConfig, N as generateCommand, Q as confirmationArgs, U as readPlatformConfig, V as loadAccessToken, W as writePlatformConfig, X as PATScope, Y as readPackageJson, Z as commonArgs, a as createCommand$3, d as listCommand$7, et as jsonArgs, h as executionsCommand, k as tokenCommand, l as startCommand, nt as workspaceArgs, p as getCommand$2, q as initOAuth2Client, r as deleteCommand$3, rt as logger, s as resumeCommand, t as listCommand$8, tt as withCommonArgs, w as listCommand$6, x as showCommand, y as truncateCommand, z as apiCommand } from "../list-1cs_CGF8.mjs";
 import { createRequire, register } from "node:module";
 import { defineCommand, runCommand, runMain } from "citty";
 import * as fs$1 from "node:fs";
@@ -518,8 +518,8 @@ function secretInfo(secret) {
 }
 /**
 * List secrets in a Secret Manager vault.
-* @param {SecretListOptions} options - Secret listing options
-* @returns {Promise<SecretInfo[]>} List of secrets
+* @param options - Secret listing options
+* @returns List of secrets
 */
 async function secretList(options) {
 	const client = await initOperatorClient(await loadAccessToken({
@@ -695,8 +695,8 @@ function vaultInfo(vault) {
 }
 /**
 * List Secret Manager vaults in the workspace.
-* @param {VaultListOptions} [options] - Vault listing options
-* @returns {Promise<VaultInfo[]>} List of vaults
+* @param options - Vault listing options
+* @returns List of vaults
 */
 async function vaultList(options) {
 	const client = await initOperatorClient(await loadAccessToken({
@@ -774,9 +774,9 @@ const secretCommand = defineCommand({
 //#region src/cli/utils/progress.ts
 /**
 * Create a simple progress reporter that writes updates to stderr.
-* @param {string} label - Label to prefix progress output
-* @param {number} total - Total number of steps
-* @returns {{ update: () => void; finish: () => void }} Progress helpers
+* @param label - Label to prefix progress output
+* @param total - Total number of steps
+* @returns Progress helpers
 */
 function createProgress(label, total) {
 	let current = 0;
@@ -796,10 +796,10 @@ function createProgress(label, total) {
 /**
 * Wrap a promise with a timeout, rejecting if the timeout elapses first.
 * @template T
-* @param {Promise<T>} p - Promise to await
-* @param {number} ms - Timeout in milliseconds
-* @param {string} message - Error message on timeout
-* @returns {Promise<T>} Result of the original promise if it completes in time
+* @param p - Promise to await
+* @param ms - Timeout in milliseconds
+* @param message - Error message on timeout
+* @returns Result of the original promise if it completes in time
 */
 async function withTimeout(p, ms, message) {
 	return await Promise.race([p, setTimeout$1(ms).then(() => {
@@ -821,12 +821,12 @@ function shouldIgnoreFile(filePath) {
 }
 /**
 * Deploy a static website by creating a deployment, uploading files, and publishing it.
-* @param {OperatorClient} client - Operator client instance
-* @param {string} workspaceId - Workspace ID
-* @param {string} name - Static website name
-* @param {string} distDir - Directory containing static site files
-* @param {boolean} [showProgress=true] - Whether to show upload progress
-* @returns {Promise<DeployResult>} Deployment result with URL and skipped files
+* @param client - Operator client instance
+* @param workspaceId - Workspace ID
+* @param name - Static website name
+* @param distDir - Directory containing static site files
+* @param showProgress - Whether to show upload progress
+* @returns Deployment result with URL and skipped files
 */
 async function deployStaticWebsite(client, workspaceId, name, distDir, showProgress = true) {
 	const { deploymentId } = await client.createDeployment({
@@ -864,9 +864,9 @@ async function uploadDirectory(client, workspaceId, deploymentId, rootDir, showP
 }
 /**
 * Recursively collect all deployable files under the given directory.
-* @param {string} rootDir - Root directory to scan
-* @param {string} [currentDir=""] - Current relative directory (for recursion)
-* @returns {Promise<string[]>} List of file paths relative to rootDir
+* @param rootDir - Root directory to scan
+* @param currentDir - Current relative directory (for recursion)
+* @returns List of file paths relative to rootDir
 */
 async function collectFiles(rootDir, currentDir = "") {
 	const dirPath = path.join(rootDir, currentDir);
@@ -920,8 +920,7 @@ async function uploadSingleFile(client, workspaceId, deploymentId, rootDir, file
 }
 /**
 * Log skipped files after a deployment, including reasons for skipping.
-* @param {string[]} skippedFiles - List of skipped file descriptions
-* @returns {void}
+* @param skippedFiles - List of skipped file descriptions
 */
 function logSkippedFiles(skippedFiles) {
 	if (skippedFiles.length === 0) return;
@@ -1029,10 +1028,8 @@ const getCommand = defineCommand({
 //#region src/cli/staticwebsite/list.ts
 /**
 * List static websites in the workspace.
-* @param {{ workspaceId?: string; profile?: string }} [options] - Static website listing options
-* @param {string} [options.workspaceId] - Workspace ID
-* @param {string} [options.profile] - Workspace profile
-* @returns {Promise<StaticWebsiteInfo[]>} List of static websites
+* @param options - Static website listing options
+* @returns List of static websites
 */
 async function listStaticWebsites(options) {
 	const client = await initOperatorClient(await loadAccessToken({
@@ -1109,10 +1106,11 @@ const staticwebsiteCommand = defineCommand({
 //#region src/cli/utils/resolve-cli-bin.ts
 /**
 * Resolve a CLI binary path from the caller's project dependencies.
-* @param {ResolveCliBinOptions} options - Resolution options for locating the CLI binary.
-* @returns {string} Absolute path to the CLI binary entry.
+* @param options - Resolution options for locating the CLI binary.
+* @returns Absolute path to the CLI binary entry.
 */
-function resolveCliBinPath({ cwd, packageName, binName, installHint }) {
+function resolveCliBinPath(options) {
+	const { cwd, packageName, binName, installHint } = options;
 	const projectPackageJsonPath = findUpSync("package.json", { cwd });
 	if (!projectPackageJsonPath) throw new Error(`Failed to locate package.json from ${cwd}.`);
 	const requireFromProject = createRequire(projectPackageJsonPath);
@@ -1131,9 +1129,9 @@ function resolveCliBinPath({ cwd, packageName, binName, installHint }) {
 //#region src/cli/tailordb/erd/schema.ts
 /**
 * Convert TailorDB field config to tbls column definition.
-* @param {string} fieldName - Field name
-* @param {TailorDBType_FieldConfig} fieldConfig - TailorDB field configuration
-* @returns {TblsColumn} tbls column definition
+* @param fieldName - Field name
+* @param fieldConfig - TailorDB field configuration
+* @returns tbls column definition
 */
 function toTblsColumn(fieldName, fieldConfig) {
 	const baseType = fieldConfig.type || "string";
@@ -1146,9 +1144,9 @@ function toTblsColumn(fieldName, fieldConfig) {
 }
 /**
 * Build tbls schema JSON from TailorDB types.
-* @param {TailorDBProtoType[]} types - TailorDB types fetched from platform
-* @param {string} namespace - TailorDB namespace
-* @returns {TblsSchema} tbls-compatible schema representation
+* @param types - TailorDB types fetched from platform
+* @param namespace - TailorDB namespace
+* @returns tbls-compatible schema representation
 */
 function buildTblsSchema(types, namespace) {
 	const tables = [];
@@ -1242,8 +1240,8 @@ function buildTblsSchema(types, namespace) {
 }
 /**
 * Export apply-applied TailorDB schema for a namespace as tbls-compatible JSON.
-* @param {TailorDBSchemaOptions} options - Export options
-* @returns {Promise<TblsSchema>} tbls schema representation
+* @param options - Export options
+* @returns tbls schema representation
 */
 async function exportTailorDBSchema(options) {
 	const { client, workspaceId, namespace } = options;
@@ -1265,7 +1263,7 @@ async function exportTailorDBSchema(options) {
 }
 /**
 * Writes the TailorDB schema to a file in tbls-compatible JSON format.
-* @param {WriteSchemaOptions} options - The options for writing the schema file.
+* @param options - The options for writing the schema file.
 */
 async function writeTblsSchemaToFile(options) {
 	const schema = await exportTailorDBSchema(options);
@@ -1290,11 +1288,8 @@ function logErdBetaWarning() {
 //#region src/cli/tailordb/erd/utils.ts
 /**
 * Initialize shared ERD command context.
-* @param {{ profile?: string; workspaceId?: string; config?: string }} args - CLI arguments.
-* @param {string | undefined} args.profile - Workspace profile.
-* @param {string | undefined} args.workspaceId - Workspace ID override.
-* @param {string | undefined} args.config - Config path override.
-* @returns {Promise<ErdCommandContext>} Initialized context.
+* @param args - CLI arguments.
+* @returns Initialized context.
 */
 async function initErdContext(args) {
 	logErdBetaWarning();
@@ -1319,9 +1314,9 @@ async function initErdContext(args) {
 const DEFAULT_ERD_BASE_DIR = ".tailor-sdk/erd";
 /**
 * Resolve TailorDB config and namespace.
-* @param {AppConfig} config - Loaded Tailor SDK config.
-* @param {string | undefined} explicitNamespace - Namespace override.
-* @returns {{ namespace: string; erdSite: string | undefined }} Resolved namespace and erdSite.
+* @param config - Loaded Tailor SDK config.
+* @param explicitNamespace - Namespace override.
+* @returns Resolved namespace and erdSite.
 */
 function resolveDbConfig(config, explicitNamespace) {
 	const namespace = explicitNamespace ?? Object.keys(config.db ?? {})[0];
@@ -1335,8 +1330,8 @@ function resolveDbConfig(config, explicitNamespace) {
 }
 /**
 * Get all namespaces with erdSite configured.
-* @param {AppConfig} config - Loaded Tailor SDK config.
-* @returns {Array<{ namespace: string; erdSite: string }>} Namespaces with erdSite.
+* @param config - Loaded Tailor SDK config.
+* @returns Namespaces with erdSite.
 */
 function resolveAllErdSites(config) {
 	const results = [];
@@ -1348,9 +1343,9 @@ function resolveAllErdSites(config) {
 }
 /**
 * Run the liam CLI to build an ERD static site from a schema file.
-* @param {string} schemaPath - Path to the ERD schema JSON file
-* @param {string} cwd - Working directory where liam will run (dist is created here)
-* @returns {Promise<void>} Resolves when the build completes successfully
+* @param schemaPath - Path to the ERD schema JSON file
+* @param cwd - Working directory where liam will run (dist is created here)
+* @returns Resolves when the build completes successfully
 */
 async function runLiamBuild(schemaPath, cwd) {
 	fs$1.mkdirSync(cwd, { recursive: true });
@@ -1395,7 +1390,7 @@ async function runLiamBuild(schemaPath, cwd) {
 }
 /**
 * Export TailorDB schema and build ERD artifacts via liam.
-* @param {TailorDBSchemaOptions & { outputPath: string; erdDir: string }} options - Build options.
+* @param options - Build options.
 */
 async function prepareErdBuild(options) {
 	await writeTblsSchemaToFile(options);
@@ -1403,13 +1398,8 @@ async function prepareErdBuild(options) {
 }
 /**
 * Prepare ERD builds for one or more namespaces.
-* @param {{ client: OperatorClient; workspaceId: string; config: AppConfig; namespace?: string; outputDir?: string }} options - Build options.
-* @param {OperatorClient} options.client - Operator client.
-* @param {string} options.workspaceId - Workspace ID.
-* @param {AppConfig} options.config - Loaded Tailor config.
-* @param {string | undefined} options.namespace - Namespace override.
-* @param {string | undefined} options.outputDir - Output directory override.
-* @returns {Promise<ErdBuildResult[]>} Build results by namespace.
+* @param options - Build options.
+* @returns Build results by namespace.
 */
 async function prepareErdBuilds(options) {
 	const { client, workspaceId, config } = options;
@@ -1622,177 +1612,6 @@ const erdCommand = defineCommand({
 	}
 });
 
-//#endregion
-//#region src/cli/tailordb/truncate.ts
-async function truncateSingleType(options, client) {
-	await client.truncateTailorDBType({
-		workspaceId: options.workspaceId,
-		namespaceName: options.namespaceName,
-		tailordbTypeName: options.typeName
-	});
-	logger.success(`Truncated type "${options.typeName}" in namespace "${options.namespaceName}"`);
-}
-async function truncateNamespace(workspaceId, namespaceName, client) {
-	await client.truncateTailorDBTypes({
-		workspaceId,
-		namespaceName
-	});
-	logger.success(`Truncated all types in namespace "${namespaceName}"`);
-}
-async function getAllNamespaces(configPath) {
-	const { config } = await loadConfig(configPath);
-	const namespaces = /* @__PURE__ */ new Set();
-	if (config.db) for (const [namespaceName] of Object.entries(config.db)) namespaces.add(namespaceName);
-	return Array.from(namespaces);
-}
-async function getTypeNamespace(workspaceId, typeName, client, configPath) {
-	const namespaces = await getAllNamespaces(configPath);
-	for (const namespace of namespaces) try {
-		const { tailordbTypes } = await client.listTailorDBTypes({
-			workspaceId,
-			namespaceName: namespace
-		});
-		if (tailordbTypes.some((type) => type.name === typeName)) return namespace;
-	} catch {
-		continue;
-	}
-	return null;
-}
-/**
-* Truncate TailorDB data based on the given options.
-* @param {TruncateOptions} [options] - Truncate options (all, namespace, or types)
-* @returns {Promise<void>} Promise that resolves when truncation completes
-*/
-async function truncate(options) {
-	const client = await initOperatorClient(await loadAccessToken({
-		useProfile: true,
-		profile: options?.profile
-	}));
-	const workspaceId = loadWorkspaceId({
-		workspaceId: options?.workspaceId,
-		profile: options?.profile
-	});
-	const hasTypes = options?.types && options.types.length > 0;
-	const hasNamespace = !!options?.namespace;
-	const hasAll = !!options?.all;
-	const optionCount = [
-		hasAll,
-		hasNamespace,
-		hasTypes
-	].filter(Boolean).length;
-	if (optionCount === 0) throw new Error("Please specify one of: --all, --namespace <name>, or type names");
-	if (optionCount > 1) throw new Error("Options --all, --namespace, and type names are mutually exclusive. Please specify only one.");
-	const namespaces = await getAllNamespaces(options?.configPath);
-	if (hasAll) {
-		if (namespaces.length === 0) {
-			logger.warn("No namespaces found in config file.");
-			return;
-		}
-		if (!options?.yes) {
-			const namespaceList = namespaces.join(", ");
-			if (!await logger.prompt(`This will truncate ALL tables in the following namespaces: ${namespaceList}. Continue? (yes/no)`, {
-				type: "confirm",
-				initial: false
-			})) {
-				logger.info("Truncate cancelled.");
-				return;
-			}
-		}
-		for (const namespace of namespaces) await truncateNamespace(workspaceId, namespace, client);
-		logger.success("Truncated all tables in all namespaces");
-		return;
-	}
-	if (hasNamespace && options?.namespace) {
-		const namespace = options.namespace;
-		if (!namespaces.includes(namespace)) throw new Error(`Namespace "${namespace}" not found in config. Available namespaces: ${namespaces.join(", ")}`);
-		if (!options.yes) {
-			if (!await logger.prompt(`This will truncate ALL tables in namespace "${namespace}". Continue? (yes/no)`, {
-				type: "confirm",
-				initial: false
-			})) {
-				logger.info("Truncate cancelled.");
-				return;
-			}
-		}
-		await truncateNamespace(workspaceId, namespace, client);
-		return;
-	}
-	if (hasTypes && options?.types) {
-		const typeNames = options.types;
-		const typeNamespaceMap = /* @__PURE__ */ new Map();
-		const notFoundTypes = [];
-		for (const typeName of typeNames) {
-			const namespace = await getTypeNamespace(workspaceId, typeName, client, options.configPath);
-			if (namespace) typeNamespaceMap.set(typeName, namespace);
-			else notFoundTypes.push(typeName);
-		}
-		if (notFoundTypes.length > 0) throw new Error(`The following types were not found in any namespace: ${notFoundTypes.join(", ")}`);
-		if (!options.yes) {
-			const typeList = typeNames.join(", ");
-			if (!await logger.prompt(`This will truncate the following types: ${typeList}. Continue? (yes/no)`, {
-				type: "confirm",
-				initial: false
-			})) {
-				logger.info("Truncate cancelled.");
-				return;
-			}
-		}
-		for (const typeName of typeNames) {
-			const namespace = typeNamespaceMap.get(typeName);
-			if (!namespace) continue;
-			await truncateSingleType({
-				workspaceId,
-				namespaceName: namespace,
-				typeName
-			}, client);
-		}
-	}
-}
-const truncateCommand = defineCommand({
-	meta: {
-		name: "truncate",
-		description: "Truncate TailorDB tables"
-	},
-	args: {
-		...commonArgs,
-		types: {
-			type: "positional",
-			description: "Type names to truncate",
-			required: false
-		},
-		all: {
-			type: "boolean",
-			description: "Truncate all tables in all namespaces",
-			default: false,
-			alias: "a"
-		},
-		namespace: {
-			type: "string",
-			description: "Truncate all tables in specified namespace",
-			alias: "n"
-		},
-		yes: {
-			type: "boolean",
-			description: "Skip confirmation prompt",
-			alias: "y",
-			default: false
-		},
-		...deploymentArgs
-	},
-	run: withCommonArgs(async (args) => {
-		const types = args._.length > 0 ? args._.map((arg) => String(arg)).filter(Boolean) : void 0;
-		await truncate({
-			workspaceId: args["workspace-id"],
-			profile: args.profile,
-			configPath: args.config,
-			all: args.all,
-			namespace: args.namespace,
-			types,
-			yes: args.yes
-		});
-	})
-});
-
 //#endregion
 //#region src/cli/tailordb/index.ts
 const tailordbCommand = defineCommand({
@@ -1871,8 +1690,8 @@ function patScopeToString(scope) {
 }
 /**
 * Transform a PersonalAccessToken into CLI-friendly info.
-* @param {PersonalAccessToken} pat - Personal access token resource
-* @returns {PersonalAccessTokenInfo} Flattened token info
+* @param pat - Personal access token resource
+* @returns Flattened token info
 */
 function transformPersonalAccessToken(pat) {
 	return {
@@ -1882,8 +1701,8 @@ function transformPersonalAccessToken(pat) {
 }
 /**
 * Get PAT scopes from a write flag.
-* @param {boolean} write - Whether write access is required
-* @returns {PATScope[]} Scopes to apply to the token
+* @param write - Whether write access is required
+* @returns Scopes to apply to the token
 */
 function getScopesFromWriteFlag(write) {
 	return write ? [PATScope.PAT_SCOPE_READ, PATScope.PAT_SCOPE_WRITE] : [PATScope.PAT_SCOPE_READ];
@@ -1893,11 +1712,10 @@ function getScopeStringsFromWriteFlag(write) {
 }
 /**
 * Print the created or updated personal access token to the logger.
-* @param {string} name - Token name
-* @param {string} token - Token value
-* @param {boolean} write - Whether the token has write scope
-* @param {"created" | "updated"} action - Action performed
-* @returns {void}
+* @param name - Token name
+* @param token - Token value
+* @param write - Whether the token has write scope
+* @param action - Action performed
 */
 function printCreatedToken(name, token, write, action) {
 	const scopes = getScopeStringsFromWriteFlag(write);