@tailor-platform/sdk 2.0.0-next.1 → 2.0.0-next.10

package/dist/logger-CXQq9YIp.mjs

@@ -0,0 +1,317 @@
+import { formatWithOptions } from "node:util";
+import chalk from "chalk";
+import { formatDistanceToNowStrict } from "date-fns";
+import { eastAsianWidth } from "get-east-asian-width";
+
+//#region src/cli/shared/ascii-table.ts
+const ANSI_ESCAPE_PATTERN = /\x1b\[[0-9;]*m/g;
+const CARRIAGE_RETURN_PATTERN = /\r\n?/g;
+const graphemeSegmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+function maxOf(values, fallback = 0) {
+	return values.reduce((max, value) => value > max ? value : max, fallback);
+}
+const TAB_WIDTH = 8;
+function isStrippableControlCharacter(char) {
+	const codePoint = char.codePointAt(0) ?? 0;
+	if (char === "\n") return false;
+	return codePoint <= 31 || codePoint === 127;
+}
+function normalizeControlCharacters(value) {
+	const sgrSequences = value.match(ANSI_ESCAPE_PATTERN) ?? [];
+	return value.split(ANSI_ESCAPE_PATTERN).map((segment) => {
+		const chars = [];
+		for (const char of segment) if (char === "	") chars.push(" ".repeat(TAB_WIDTH));
+		else if (!isStrippableControlCharacter(char)) chars.push(char);
+		return chars.join("");
+	}).reduce((result, segment, i) => result + segment + (sgrSequences[i] ?? ""), "");
+}
+function sanitizeCell(cell) {
+	return normalizeControlCharacters(String(cell ?? "").replace(CARRIAGE_RETURN_PATTERN, "\n"));
+}
+const ZERO_WIDTH_CLUSTER_PATTERN = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Format}|\p{Nonspacing_Mark}|\p{Enclosing_Mark}|\p{Surrogate})+$/v;
+const RGI_EMOJI_PATTERN = /^\p{RGI_Emoji}$/v;
+function displayWidth(value) {
+	let width = 0;
+	for (const { segment } of graphemeSegmenter.segment(value.replace(ANSI_ESCAPE_PATTERN, ""))) {
+		if (ZERO_WIDTH_CLUSTER_PATTERN.test(segment)) continue;
+		if (RGI_EMOJI_PATTERN.test(segment)) {
+			width += 2;
+			continue;
+		}
+		const codePoint = segment.codePointAt(0);
+		width += codePoint === void 0 ? 0 : eastAsianWidth(codePoint);
+	}
+	return width;
+}
+function toCellLines(cell) {
+	return cell.split("\n").map((text) => ({
+		text,
+		width: displayWidth(text)
+	}));
+}
+function padCell(cellLine, width) {
+	return cellLine.text + " ".repeat(Math.max(0, width - cellLine.width));
+}
+function renderBorder(left, join, right, columnWidths) {
+	return left + columnWidths.map((width) => "─".repeat(width + 2)).join(join) + right;
+}
+function validateConsistentColumnCount(rows) {
+	const columnCount = rows[0]?.length;
+	if (columnCount === void 0) return;
+	rows.forEach((row, index) => {
+		if (row.length !== columnCount) throw new Error(`renderTable: all rows must have the same number of columns (expected ${columnCount}, row ${index} has ${row.length}).`);
+	});
+}
+/**
+* Renders a 2D array of values as a table using single-line Unicode box-drawing borders.
+* Column widths account for East Asian wide characters (measured per grapheme cluster,
+* so combining marks and ZWJ emoji sequences aren't overcounted, non-printing clusters
+* such as a lone joiner or combining mark measure as 0, and flags, keycaps, and
+* VS16-forced emoji presentation are measured as 2 columns) and strip ANSI SGR (color/style)
+* escape codes before measuring. Use this instead of importing a table-rendering package
+* directly.
+* @param data - Table rows; every row must have the same number of columns. Each cell is
+* stringified (`null`/`undefined` become an empty string rather than the literal text
+* "null"/"undefined"), may contain embedded newlines, has `\r`/`\r\n` normalized to `\n`,
+* has tabs expanded to spaces, and has other control characters stripped.
+* @param config - Rendering options
+* @returns The rendered table terminated with a trailing newline, or `""` when there are no
+* rows or no columns to display
+*/
+function renderTable(data, config = {}) {
+	const rows = data.map((row) => row.map(sanitizeCell));
+	validateConsistentColumnCount(rows);
+	const rowCount = rows.length;
+	const columnCount = rows[0]?.length ?? 0;
+	if (rowCount === 0 || columnCount === 0) return "";
+	const rowsCellLines = rows.map((row) => Array.from({ length: columnCount }, (_, col) => toCellLines(row[col] ?? "")));
+	const columnWidths = Array.from({ length: columnCount }, (_, col) => maxOf(rowsCellLines.map((row) => maxOf((row[col] ?? []).map((line) => line.width)))));
+	const shouldDrawLine = (lineIndex) => config.singleLine ? lineIndex === 0 || lineIndex === rowCount : (config.drawHorizontalLine ?? (() => true))(lineIndex, rowCount);
+	const lines = [];
+	if (shouldDrawLine(0)) lines.push(renderBorder("┌", "┬", "┐", columnWidths));
+	rowsCellLines.forEach((cellLines, rowIndex) => {
+		const rowHeight = maxOf(cellLines.map((columnLines) => columnLines.length), 1);
+		for (let line = 0; line < rowHeight; line++) {
+			const cells = cellLines.map((columnLines, col) => padCell(columnLines[line] ?? {
+				text: "",
+				width: 0
+			}, columnWidths[col] ?? 0));
+			lines.push(`│ ${cells.join(" │ ")} │`);
+		}
+		if (rowIndex < rowCount - 1 && shouldDrawLine(rowIndex + 1)) lines.push(renderBorder("├", "┼", "┤", columnWidths));
+	});
+	if (shouldDrawLine(rowCount)) lines.push(renderBorder("└", "┴", "┘", columnWidths));
+	return `${lines.join("\n")}\n`;
+}
+
+//#endregion
+//#region src/cli/shared/parse-boolean.ts
+const TRUTHY_VALUES = /* @__PURE__ */ new Set([
+	"true",
+	"t",
+	"yes",
+	"y",
+	"on",
+	"1"
+]);
+const FALSY_VALUES = /* @__PURE__ */ new Set([
+	"false",
+	"f",
+	"no",
+	"n",
+	"off",
+	"0"
+]);
+/**
+* Parse a string value as a boolean.
+*
+* Recognized values (case-insensitive, trimmed) follow Python's
+* `distutils.util.strtobool` convention:
+* - truthy: `true, t, yes, y, on, 1`
+* - falsy: `false, f, no, n, off, 0`
+*
+* Undefined, empty strings, and unrecognized values return `undefined` so
+* that callers can fall back to their own defaults.
+* @param value - The input string (e.g. an environment variable or CLI flag value)
+* @returns `true`, `false`, or `undefined` when the value is unset or unrecognized
+*/
+function parseBoolean(value) {
+	if (value === void 0) return void 0;
+	const normalized = value.trim().toLowerCase();
+	if (normalized === "") return void 0;
+	if (TRUTHY_VALUES.has(normalized)) return true;
+	if (FALSY_VALUES.has(normalized)) return false;
+}
+
+//#endregion
+//#region src/cli/shared/logger.ts
+/**
+* Error thrown when a prompt is attempted in a non-interactive environment
+*/
+var CIPromptError = class extends Error {
+	constructor(message) {
+		super(message ?? "Interactive prompts are not available in this environment. Provide the required options explicitly.");
+		this.name = "CIPromptError";
+	}
+};
+/**
+* Semantic style functions for inline text styling
+*/
+const styles = {
+	success: chalk.green,
+	error: chalk.red,
+	warning: chalk.yellow,
+	info: chalk.cyan,
+	create: chalk.green,
+	update: chalk.yellow,
+	delete: chalk.red,
+	unchanged: chalk.gray,
+	bold: chalk.bold,
+	dim: chalk.gray,
+	highlight: chalk.cyanBright,
+	successBright: chalk.greenBright,
+	errorBright: chalk.redBright,
+	resourceType: chalk.bold,
+	resourceName: chalk.cyan,
+	path: chalk.cyan,
+	value: chalk.white,
+	placeholder: chalk.gray.italic
+};
+/**
+* Standardized symbols for CLI output
+*/
+const symbols = {
+	success: chalk.green("✓"),
+	error: chalk.red("✖"),
+	warning: chalk.yellow("⚠"),
+	info: chalk.cyan("i"),
+	create: chalk.green("+"),
+	update: chalk.yellow("~"),
+	delete: chalk.red("-"),
+	replace: chalk.magenta("±"),
+	bullet: chalk.gray("•"),
+	arrow: chalk.gray("→")
+};
+let _jsonMode = false;
+const TYPE_ICONS = {
+	info: "ℹ",
+	success: "✔",
+	warn: "⚠",
+	error: "✖",
+	debug: "⚙",
+	trace: "→",
+	log: ""
+};
+const TYPE_COLORS = {
+	info: chalk.cyan,
+	success: chalk.green,
+	warn: chalk.yellow,
+	error: chalk.red,
+	debug: chalk.gray,
+	trace: chalk.gray,
+	log: (text) => text
+};
+/**
+* Formats a log line with the appropriate prefix and indentation
+* @param opts - Formatting options
+* @returns Formatted log line
+*/
+function formatLogLine(opts) {
+	const { mode, indent, type, message, timestamp } = opts;
+	const indentPrefix = indent > 0 ? " ".repeat(indent) : "";
+	const colorFn = TYPE_COLORS[type] || ((text) => text);
+	if (mode === "plain") return `${indentPrefix}${colorFn(message)}\n`;
+	const icon = TYPE_ICONS[type] || "";
+	const coloredOutput = colorFn(`${icon ? `${icon} ` : ""}${message}`);
+	return `${indentPrefix}${timestamp ?? ""}${coloredOutput}\n`;
+}
+/**
+* Writes a formatted log line to stderr.
+* @param type - Log type (info, success, warn, error, log)
+* @param message - Log message
+* @param opts - Log options (mode and indent)
+*/
+function writeLog(type, message, opts) {
+	const mode = opts?.mode ?? "default";
+	const output = formatLogLine({
+		mode,
+		indent: opts?.indent ?? 0,
+		type,
+		message: formatWithOptions({ breakLength: process.stdout.columns || 80 }, message),
+		timestamp: mode === "stream" ? `${(/* @__PURE__ */ new Date()).toLocaleTimeString()} ` : ""
+	});
+	process.stderr.write(output);
+}
+const logger = {
+	get jsonMode() {
+		return _jsonMode;
+	},
+	set jsonMode(value) {
+		_jsonMode = value;
+	},
+	info(message, opts) {
+		writeLog("info", message, opts);
+	},
+	success(message, opts) {
+		writeLog("success", message, opts);
+	},
+	warn(message, opts) {
+		writeLog("warn", message, opts);
+	},
+	error(message, opts) {
+		writeLog("error", message, opts);
+	},
+	log(message) {
+		writeLog("log", message, { mode: "plain" });
+	},
+	newline() {
+		process.stderr.write("\n");
+	},
+	debug(message) {
+		if (parseBoolean(process.env.DEBUG) === true) writeLog("log", styles.dim(message), { mode: "plain" });
+	},
+	out(data, options) {
+		if (typeof data === "string") {
+			process.stdout.write(data.endsWith("\n") ? data : data + "\n");
+			return;
+		}
+		if (this.jsonMode) {
+			console.log(JSON.stringify(data));
+			return;
+		}
+		const display = options?.display;
+		const formatValue = (value, pretty = false) => {
+			if (options?.showNull && value === null) return "NULL";
+			if (value === null || value === void 0) return "N/A";
+			if (value instanceof Date) return formatDistanceToNowStrict(value, { addSuffix: true });
+			if (typeof value === "object") return pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value);
+			return String(value);
+		};
+		const isExcluded = (key) => {
+			return display !== void 0 && key in display && display[key] === null;
+		};
+		const transformValue = (key, value, item, pretty = false) => {
+			if (display && key in display) {
+				const transformer = display[key];
+				if (transformer) return transformer(value, item);
+			}
+			return formatValue(value, pretty);
+		};
+		if (!Array.isArray(data)) {
+			const t = renderTable(Object.entries(data).filter(([key]) => !isExcluded(key)).map(([key, value]) => [key, transformValue(key, value, data, true)]), { singleLine: false });
+			process.stdout.write(t);
+			return;
+		}
+		if (data.length === 0) return;
+		const headers = Array.from(new Set(data.flatMap((item) => Object.keys(item)))).filter((h) => !isExcluded(h));
+		if (headers.length === 0) return;
+		const t = renderTable([headers, ...data.map((item) => headers.map((header) => transformValue(header, item[header], item)))], { drawHorizontalLine: (lineIndex, rowCount) => {
+			return lineIndex === 0 || lineIndex === 1 || lineIndex === rowCount;
+		} });
+		process.stdout.write(t);
+	}
+};
+
+//#endregion
+export { parseBoolean as a, symbols as i, logger as n, renderTable as o, styles as r, CIPromptError as t };
+//# sourceMappingURL=logger-CXQq9YIp.mjs.map

package/dist/logger-CXQq9YIp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CXQq9YIp.mjs","names":[],"sources":["../src/cli/shared/ascii-table.ts","../src/cli/shared/parse-boolean.ts","../src/cli/shared/logger.ts"],"sourcesContent":["import { eastAsianWidth } from \"get-east-asian-width\";\n\n// eslint-disable-next-line no-control-regex\nconst ANSI_ESCAPE_PATTERN = /\\x1b\\[[0-9;]*m/g;\nconst CARRIAGE_RETURN_PATTERN = /\\r\\n?/g;\n\nconst graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: \"grapheme\" });\n\nexport interface AsciiTableConfig {\n  /** Suppress horizontal lines between rows, keeping only the outer border. */\n  singleLine?: boolean;\n  /** Decide whether to draw the horizontal line at `lineIndex` (range `[0, rowCount]` inclusive). */\n  drawHorizontalLine?: (lineIndex: number, rowCount: number) => boolean;\n}\n\ninterface CellLine {\n  text: string;\n  width: number;\n}\n\nfunction maxOf(values: number[], fallback = 0): number {\n  return values.reduce((max, value) => (value > max ? value : max), fallback);\n}\n\nconst TAB_WIDTH = 8;\n\nfunction isStrippableControlCharacter(char: string): boolean {\n  const codePoint = char.codePointAt(0) ?? 0;\n  if (char === \"\\n\") {\n    return false;\n  }\n  return codePoint <= 0x1f || codePoint === 0x7f;\n}\n\n// Only SGR (color/style) escape sequences are meant to survive; a bare ESC\n// that isn't part of a recognized SGR sequence (e.g. a screen-clear CSI\n// sequence, or a BEL-terminated OSC sequence) is treated like any other\n// control character below and stripped, rather than passed through to the\n// terminal or left with its terminator removed.\nfunction normalizeControlCharacters(value: string): string {\n  const sgrSequences = value.match(ANSI_ESCAPE_PATTERN) ?? [];\n  return value\n    .split(ANSI_ESCAPE_PATTERN)\n    .map((segment) => {\n      const chars: string[] = [];\n      for (const char of segment) {\n        if (char === \"\\t\") {\n          chars.push(\" \".repeat(TAB_WIDTH));\n        } else if (!isStrippableControlCharacter(char)) {\n          chars.push(char);\n        }\n      }\n      return chars.join(\"\");\n    })\n    .reduce((result, segment, i) => result + segment + (sgrSequences[i] ?? \"\"), \"\");\n}\n\nfunction sanitizeCell(cell: unknown): string {\n  return normalizeControlCharacters(String(cell ?? \"\").replace(CARRIAGE_RETURN_PATTERN, \"\\n\"));\n}\n\n// Clusters made up entirely of non-printing code points (lone joiners,\n// variation selectors, combining marks, etc.) render with no visible glyph.\nconst ZERO_WIDTH_CLUSTER_PATTERN =\n  /^(?:\\p{Default_Ignorable_Code_Point}|\\p{Control}|\\p{Format}|\\p{Nonspacing_Mark}|\\p{Enclosing_Mark}|\\p{Surrogate})+$/v;\n// RGI_Emoji covers flags, keycaps, and VS16-forced presentation sequences,\n// which render as 2 columns in terminals even though their first code point\n// alone would measure as narrow/neutral.\nconst RGI_EMOJI_PATTERN = /^\\p{RGI_Emoji}$/v;\n\nfunction displayWidth(value: string): number {\n  let width = 0;\n  for (const { segment } of graphemeSegmenter.segment(value.replace(ANSI_ESCAPE_PATTERN, \"\"))) {\n    if (ZERO_WIDTH_CLUSTER_PATTERN.test(segment)) {\n      continue;\n    }\n    if (RGI_EMOJI_PATTERN.test(segment)) {\n      width += 2;\n      continue;\n    }\n    const codePoint = segment.codePointAt(0);\n    width += codePoint === undefined ? 0 : eastAsianWidth(codePoint);\n  }\n  return width;\n}\n\nfunction toCellLines(cell: string): CellLine[] {\n  return cell.split(\"\\n\").map((text) => ({ text, width: displayWidth(text) }));\n}\n\nfunction padCell(cellLine: CellLine, width: number): string {\n  return cellLine.text + \" \".repeat(Math.max(0, width - cellLine.width));\n}\n\nfunction renderBorder(left: string, join: string, right: string, columnWidths: number[]): string {\n  return left + columnWidths.map((width) => \"─\".repeat(width + 2)).join(join) + right;\n}\n\nfunction validateConsistentColumnCount(rows: string[][]): void {\n  const columnCount = rows[0]?.length;\n  if (columnCount === undefined) {\n    return;\n  }\n  rows.forEach((row, index) => {\n    if (row.length !== columnCount) {\n      throw new Error(\n        `renderTable: all rows must have the same number of columns (expected ${columnCount}, row ${index} has ${row.length}).`,\n      );\n    }\n  });\n}\n\n/**\n * Renders a 2D array of values as a table using single-line Unicode box-drawing borders.\n * Column widths account for East Asian wide characters (measured per grapheme cluster,\n * so combining marks and ZWJ emoji sequences aren't overcounted, non-printing clusters\n * such as a lone joiner or combining mark measure as 0, and flags, keycaps, and\n * VS16-forced emoji presentation are measured as 2 columns) and strip ANSI SGR (color/style)\n * escape codes before measuring. Use this instead of importing a table-rendering package\n * directly.\n * @param data - Table rows; every row must have the same number of columns. Each cell is\n * stringified (`null`/`undefined` become an empty string rather than the literal text\n * \"null\"/\"undefined\"), may contain embedded newlines, has `\\r`/`\\r\\n` normalized to `\\n`,\n * has tabs expanded to spaces, and has other control characters stripped.\n * @param config - Rendering options\n * @returns The rendered table terminated with a trailing newline, or `\"\"` when there are no\n * rows or no columns to display\n */\nexport function renderTable(data: unknown[][], config: AsciiTableConfig = {}): string {\n  const rows = data.map((row) => row.map(sanitizeCell));\n  validateConsistentColumnCount(rows);\n\n  const rowCount = rows.length;\n  const columnCount = rows[0]?.length ?? 0;\n  if (rowCount === 0 || columnCount === 0) {\n    return \"\";\n  }\n\n  const rowsCellLines = rows.map((row) =>\n    Array.from({ length: columnCount }, (_, col) => toCellLines(row[col] ?? \"\")),\n  );\n  const columnWidths = Array.from({ length: columnCount }, (_, col) =>\n    maxOf(rowsCellLines.map((row) => maxOf((row[col] ?? []).map((line) => line.width)))),\n  );\n\n  const shouldDrawLine = (lineIndex: number): boolean =>\n    config.singleLine\n      ? lineIndex === 0 || lineIndex === rowCount\n      : (config.drawHorizontalLine ?? (() => true))(lineIndex, rowCount);\n\n  const lines: string[] = [];\n  if (shouldDrawLine(0)) {\n    lines.push(renderBorder(\"┌\", \"┬\", \"┐\", columnWidths));\n  }\n\n  rowsCellLines.forEach((cellLines, rowIndex) => {\n    const rowHeight = maxOf(\n      cellLines.map((columnLines) => columnLines.length),\n      1,\n    );\n    for (let line = 0; line < rowHeight; line++) {\n      const cells = cellLines.map((columnLines, col) =>\n        padCell(columnLines[line] ?? { text: \"\", width: 0 }, columnWidths[col] ?? 0),\n      );\n      lines.push(`│ ${cells.join(\" │ \")} │`);\n    }\n    if (rowIndex < rowCount - 1 && shouldDrawLine(rowIndex + 1)) {\n      lines.push(renderBorder(\"├\", \"┼\", \"┤\", columnWidths));\n    }\n  });\n\n  if (shouldDrawLine(rowCount)) {\n    lines.push(renderBorder(\"└\", \"┴\", \"┘\", columnWidths));\n  }\n\n  return `${lines.join(\"\\n\")}\\n`;\n}\n","const TRUTHY_VALUES = new Set([\"true\", \"t\", \"yes\", \"y\", \"on\", \"1\"]);\nconst FALSY_VALUES = new Set([\"false\", \"f\", \"no\", \"n\", \"off\", \"0\"]);\n\n/**\n * Parse a string value as a boolean.\n *\n * Recognized values (case-insensitive, trimmed) follow Python's\n * `distutils.util.strtobool` convention:\n * - truthy: `true, t, yes, y, on, 1`\n * - falsy: `false, f, no, n, off, 0`\n *\n * Undefined, empty strings, and unrecognized values return `undefined` so\n * that callers can fall back to their own defaults.\n * @param value - The input string (e.g. an environment variable or CLI flag value)\n * @returns `true`, `false`, or `undefined` when the value is unset or unrecognized\n */\nexport function parseBoolean(value: string | undefined): boolean | undefined {\n  if (value === undefined) return undefined;\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"\") return undefined;\n  if (TRUTHY_VALUES.has(normalized)) return true;\n  if (FALSY_VALUES.has(normalized)) return false;\n  return undefined;\n}\n","import { formatWithOptions, type InspectOptions } from \"node:util\";\nimport chalk from \"chalk\";\nimport { formatDistanceToNowStrict } from \"date-fns\";\nimport { renderTable } from \"./ascii-table\";\nimport { parseBoolean } from \"./parse-boolean\";\n\n/**\n * Error thrown when a prompt is attempted in a non-interactive environment\n */\nexport class CIPromptError extends Error {\n  constructor(message?: string) {\n    super(\n      message ??\n        \"Interactive prompts are not available in this environment. Provide the required options explicitly.\",\n    );\n    this.name = \"CIPromptError\";\n  }\n}\n\n/**\n * Semantic style functions for inline text styling\n */\nexport const styles = {\n  // Status colors\n  success: chalk.green,\n  error: chalk.red,\n  warning: chalk.yellow,\n  info: chalk.cyan,\n\n  // Action colors (for change sets)\n  create: chalk.green,\n  update: chalk.yellow,\n  delete: chalk.red,\n  unchanged: chalk.gray,\n\n  // Emphasis\n  bold: chalk.bold,\n  dim: chalk.gray,\n  highlight: chalk.cyanBright,\n  successBright: chalk.greenBright,\n  errorBright: chalk.redBright,\n\n  // Resource types\n  resourceType: chalk.bold,\n  resourceName: chalk.cyan,\n\n  // File paths\n  path: chalk.cyan,\n\n  // Values\n  value: chalk.white,\n  placeholder: chalk.gray.italic,\n};\n\n/**\n * Standardized symbols for CLI output\n */\nexport const symbols = {\n  success: chalk.green(\"\\u2713\"),\n  error: chalk.red(\"\\u2716\"),\n  warning: chalk.yellow(\"\\u26a0\"),\n  info: chalk.cyan(\"i\"),\n  create: chalk.green(\"+\"),\n  update: chalk.yellow(\"~\"),\n  delete: chalk.red(\"-\"),\n  replace: chalk.magenta(\"\\u00b1\"),\n  bullet: chalk.gray(\"\\u2022\"),\n  arrow: chalk.gray(\"\\u2192\"),\n};\n\n/**\n * Log output modes\n */\nexport type LogMode = \"default\" | \"stream\" | \"plain\";\n\nexport interface LogOptions {\n  /** Output mode (default: \"default\") */\n  mode?: LogMode;\n  /** Number of spaces to indent the entire line (default: 0) */\n  indent?: number;\n}\n\n/** Field transformer function. null excludes the field from table output. */\nexport type FieldTransformer = ((value: unknown, item: object) => string) | null;\n\nexport interface OutOptions {\n  /** Table display field transform/exclude settings. Only applied in table mode (not JSON). */\n  display?: Record<string, FieldTransformer>;\n\n  /** Show null values in table output (default: false) */\n  showNull?: boolean;\n}\n\n// In JSON mode, all logs go to stderr to keep stdout clean for JSON data\nlet _jsonMode = false;\n\n// Type icons for log output\nconst TYPE_ICONS: Record<string, string> = {\n  info: \"ℹ\",\n  success: \"✔\",\n  warn: \"⚠\",\n  error: \"✖\",\n  debug: \"⚙\",\n  trace: \"→\",\n  log: \"\",\n};\n\n// Color functions for icon and message text\nconst TYPE_COLORS: Record<string, (text: string) => string> = {\n  info: chalk.cyan,\n  success: chalk.green,\n  warn: chalk.yellow,\n  error: chalk.red,\n  debug: chalk.gray,\n  trace: chalk.gray,\n  log: (text) => text,\n};\n\ninterface FormatLogLineOptions {\n  mode: string;\n  indent: number;\n  type: string;\n  message: string;\n  timestamp?: string;\n}\n\n/**\n * Formats a log line with the appropriate prefix and indentation\n * @param opts - Formatting options\n * @returns Formatted log line\n */\nexport function formatLogLine(opts: FormatLogLineOptions): string {\n  const { mode, indent, type, message, timestamp } = opts;\n  const indentPrefix = indent > 0 ? \" \".repeat(indent) : \"\";\n  const colorFn = TYPE_COLORS[type] || ((text: string) => text);\n\n  // Plain mode: color only, no icon, no timestamp\n  if (mode === \"plain\") {\n    return `${indentPrefix}${colorFn(message)}\\n`;\n  }\n\n  // Default/Stream mode: with icon and color\n  const icon = TYPE_ICONS[type] || \"\";\n  const prefix = icon ? `${icon} ` : \"\";\n  const coloredOutput = colorFn(`${prefix}${message}`);\n  const timestampPrefix = timestamp ?? \"\";\n\n  return `${indentPrefix}${timestampPrefix}${coloredOutput}\\n`;\n}\n\n/**\n * Writes a formatted log line to stderr.\n * @param type - Log type (info, success, warn, error, log)\n * @param message - Log message\n * @param opts - Log options (mode and indent)\n */\nfunction writeLog(type: string, message: string, opts?: LogOptions): void {\n  const mode = opts?.mode ?? \"default\";\n  const indent = opts?.indent ?? 0;\n  const inspectOpts: InspectOptions = {\n    breakLength: process.stdout.columns || 80,\n  };\n  const formattedMessage = formatWithOptions(inspectOpts, message);\n  const timestamp = mode === \"stream\" ? `${new Date().toLocaleTimeString()} ` : \"\";\n  const output = formatLogLine({ mode, indent, type, message: formattedMessage, timestamp });\n  process.stderr.write(output);\n}\n\nexport const logger = {\n  get jsonMode(): boolean {\n    return _jsonMode;\n  },\n  set jsonMode(value: boolean) {\n    _jsonMode = value;\n  },\n\n  info(message: string, opts?: LogOptions): void {\n    writeLog(\"info\", message, opts);\n  },\n\n  success(message: string, opts?: LogOptions): void {\n    writeLog(\"success\", message, opts);\n  },\n\n  warn(message: string, opts?: LogOptions): void {\n    writeLog(\"warn\", message, opts);\n  },\n\n  error(message: string, opts?: LogOptions): void {\n    writeLog(\"error\", message, opts);\n  },\n\n  log(message: string): void {\n    writeLog(\"log\", message, { mode: \"plain\" });\n  },\n\n  newline(): void {\n    process.stderr.write(\"\\n\");\n  },\n\n  debug(message: string): void {\n    if (parseBoolean(process.env.DEBUG) === true) {\n      writeLog(\"log\", styles.dim(message), { mode: \"plain\" });\n    }\n  },\n\n  out(data: string | object | object[], options?: OutOptions): void {\n    if (typeof data === \"string\") {\n      process.stdout.write(data.endsWith(\"\\n\") ? data : data + \"\\n\");\n      return;\n    }\n\n    if (this.jsonMode) {\n      // eslint-disable-next-line no-restricted-syntax\n      console.log(JSON.stringify(data));\n      return;\n    }\n\n    const display = options?.display;\n\n    // Helper to format a value for table display\n    const formatValue = (value: unknown, pretty = false): string => {\n      if (options?.showNull && value === null) return \"NULL\";\n      if (value === null || value === undefined) return \"N/A\";\n      if (value instanceof Date) {\n        return formatDistanceToNowStrict(value, { addSuffix: true });\n      }\n      if (typeof value === \"object\") {\n        return pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value);\n      }\n      return String(value);\n    };\n\n    // Helper to check if field should be excluded\n    const isExcluded = (key: string): boolean => {\n      return display !== undefined && key in display && display[key] === null;\n    };\n\n    // Helper to apply transformer or default formatting\n    const transformValue = (key: string, value: unknown, item: object, pretty = false): string => {\n      if (display && key in display) {\n        const transformer = display[key];\n        if (transformer) {\n          return transformer(value, item);\n        }\n      }\n      return formatValue(value, pretty);\n    };\n\n    if (!Array.isArray(data)) {\n      const entries = Object.entries(data).filter(([key]) => !isExcluded(key));\n      const formattedEntries = entries.map(([key, value]) => [\n        key,\n        transformValue(key, value, data, true),\n      ]);\n      const t = renderTable(formattedEntries, { singleLine: false });\n      process.stdout.write(t);\n      return;\n    }\n\n    if (data.length === 0) {\n      return;\n    }\n\n    const allHeaders = Array.from(new Set(data.flatMap((item) => Object.keys(item))));\n    const headers = allHeaders.filter((h) => !isExcluded(h));\n    if (headers.length === 0) {\n      return;\n    }\n    const rows = data.map((item) =>\n      headers.map((header) =>\n        transformValue(header, (item as Record<string, unknown>)[header], item),\n      ),\n    );\n\n    const t = renderTable([headers, ...rows], {\n      drawHorizontalLine: (lineIndex, rowCount) => {\n        return lineIndex === 0 || lineIndex === 1 || lineIndex === rowCount;\n      },\n    });\n    process.stdout.write(t);\n  },\n};\n"],"mappings":"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"}

package/dist/parser/service/auth/index.d.mts

@@ -0,0 +1 @@
+import "./schema.mjs";

package/dist/parser/service/auth/schema.d.mts

@@ -0,0 +1,3 @@
+import "../../../configure/services/auth/types.mjs";
+import "../tailordb/types.mjs";
+import { z } from "zod";

package/dist/parser/service/http-adapter/index.d.mts

@@ -0,0 +1 @@
+import "./schema.mjs";

package/dist/parser/service/http-adapter/schema.d.mts

@@ -0,0 +1 @@
+import { z } from "zod";

package/dist/parser/service/idp/types.d.mts

@@ -0,0 +1,5 @@
+import "../../../configure/services/auth/types.mjs";
+//#region src/parser/service/idp/types.d.ts
+type IdPUserField = "id" | "name" | "disabled";
+//#endregion
+export { IdPUserField };

package/dist/parser/service/tailordb/type-source.d.mts

@@ -0,0 +1,10 @@
+import { PluginGeneratedTypeSource, TypeSourceInfoEntry } from "./types.mjs";
+//#region src/parser/service/tailordb/type-source.d.ts
+/**
+ * Checks if a type source is generated by a plugin.
+ * @param source - The type source entry to check.
+ * @returns True if the source was generated by a plugin.
+ */
+declare function isPluginGeneratedType(source: TypeSourceInfoEntry): source is PluginGeneratedTypeSource;
+//#endregion
+export { isPluginGeneratedType };

package/dist/parser/service/tailordb/types.d.mts

@@ -0,0 +1,131 @@
+import { EnumValue } from "../../../configure/types/field.types.mjs";
+import { TailorDBTypeParsedSettings } from "../../../types/tailordb.generated.mjs";
+import { RawRelationConfig, TailorDBTypeMetadata } from "../../../configure/services/tailordb/types.mjs";
+import { ValueOperand } from "../../../configure/services/auth/types.mjs";
+//#region src/parser/service/tailordb/types.d.ts
+interface UserDefinedTypeSource {
+  filePath: string;
+  exportName: string;
+  pluginId?: never;
+}
+interface PluginGeneratedTypeSource {
+  filePath?: never;
+  exportName: string;
+  pluginId: string;
+  pluginImportPath: string;
+  originalFilePath: string;
+  originalExportName: string;
+  generatedTypeKind?: string;
+  pluginConfig?: unknown;
+  namespace?: string;
+}
+type TypeSourceInfoEntry = UserDefinedTypeSource | PluginGeneratedTypeSource;
+interface Script {
+  expr: string;
+}
+interface OperatorValidateConfig {
+  script: Script;
+  errorMessage: string;
+}
+interface OperatorFieldHook {
+  create?: Script;
+  update?: Script;
+}
+interface OperatorFieldConfig {
+  type: string;
+  required?: boolean;
+  description?: string;
+  allowedValues?: EnumValue[];
+  array?: boolean;
+  index?: boolean;
+  unique?: boolean;
+  vector?: boolean;
+  foreignKey?: boolean;
+  foreignKeyType?: string;
+  foreignKeyField?: string;
+  rawRelation?: RawRelationConfig;
+  validate?: OperatorValidateConfig[];
+  hooks?: OperatorFieldHook;
+  serial?: {
+    start: number;
+    maxValue?: number;
+    format?: string;
+  };
+  scale?: number;
+  default?: unknown;
+  fields?: Record<string, OperatorFieldConfig>;
+}
+type GqlPermissionAction = "read" | "create" | "update" | "delete" | "aggregate" | "bulkUpsert";
+type StandardPermissionOperator = "eq" | "ne" | "in" | "nin" | "hasAny" | "nhasAny";
+type UserOperand = {
+  user: string;
+};
+type StandardRecordOperand<Update extends boolean = false> = Update extends true ? {
+  oldRecord: string;
+} | {
+  newRecord: string;
+} : {
+  record: string;
+};
+type PermissionOperand<Level extends "record" | "gql" = "record" | "gql", Update extends boolean = boolean> = UserOperand | ValueOperand | (Level extends "record" ? StandardRecordOperand<Update> : never);
+type StandardPermissionCondition<Level extends "record" | "gql" = "record" | "gql", Update extends boolean = boolean> = readonly [PermissionOperand<Level, Update>, StandardPermissionOperator, PermissionOperand<Level, Update>];
+type StandardActionPermission<Level extends "record" | "gql" = "record" | "gql", Update extends boolean = boolean> = {
+  conditions: readonly StandardPermissionCondition<Level, Update>[];
+  description?: string;
+  permit: "allow" | "deny";
+};
+type StandardTailorTypePermission = {
+  create: readonly StandardActionPermission<"record", false>[];
+  read: readonly StandardActionPermission<"record", false>[];
+  update: readonly StandardActionPermission<"record", true>[];
+  delete: readonly StandardActionPermission<"record", false>[];
+};
+type StandardGqlPermissionPolicy = {
+  conditions: readonly StandardPermissionCondition<"gql">[];
+  actions: readonly ["all"] | readonly GqlPermissionAction[];
+  permit: "allow" | "deny";
+  description?: string;
+};
+type StandardTailorTypeGqlPermission = readonly StandardGqlPermissionPolicy[];
+interface Permissions {
+  record?: StandardTailorTypePermission;
+  gql?: StandardTailorTypeGqlPermission;
+}
+interface ParsedField {
+  name: string;
+  config: OperatorFieldConfig;
+  relation?: {
+    targetType: string;
+    forwardName: string;
+    backwardName: string;
+    key: string;
+    unique: boolean;
+  };
+}
+interface ParsedRelationship {
+  name: string;
+  targetType: string;
+  targetField: string;
+  sourceField: string;
+  isArray: boolean;
+  description: string;
+}
+interface TailorDBType {
+  name: string;
+  pluralForm: string;
+  description?: string;
+  fields: Record<string, ParsedField>;
+  forwardRelationships: Record<string, ParsedRelationship>;
+  backwardRelationships: Record<string, ParsedRelationship>;
+  settings: TailorDBTypeParsedSettings;
+  permissions: Permissions;
+  indexes?: TailorDBTypeMetadata["indexes"];
+  files?: TailorDBTypeMetadata["files"];
+  typeHookExpr?: {
+    create?: string;
+    update?: string;
+  };
+  typeValidateExpr?: string;
+}
+//#endregion
+export { OperatorFieldConfig, ParsedField, ParsedRelationship, PermissionOperand, Permissions, PluginGeneratedTypeSource, Script, StandardActionPermission, StandardGqlPermissionPolicy, StandardPermissionCondition, StandardTailorTypeGqlPermission, StandardTailorTypePermission, TailorDBType, TypeSourceInfoEntry, UserDefinedTypeSource };

package/dist/platform-serialize-RoRtBS0v.mjs

@@ -0,0 +1,46 @@
+//#region src/utils/test/platform-serialize.ts
+/**
+* Validate and serialize a value as it would cross the Platform JSON boundary.
+*
+* Mirrors the runtime checks the platform performs on workflow arguments,
+* wait payloads, and trigger inputs so that local tests fail in the same
+* places production fails.
+*
+* Throws on:
+* - `NaN` / `Infinity` / `-Infinity` (`JSON.stringify` would silently emit `null`)
+* - `BigInt` (TypeError is thrown by `JSON.stringify`; we emit a clearer message)
+* - Non-plain objects (class instances, including `Date`, `Map`, `Set`, `Error`,
+*   and user-defined DTOs whose prototype is not `Object.prototype`)
+*
+* The replacer reads `this[key]` so the check sees the original value before
+* any `toJSON` conversion (e.g. `Date.prototype.toJSON`).
+* @param value - Value to validate and round-trip
+* @returns The JSON-normalized value (undefined/function properties stripped, etc.)
+*/
+function platformSerialize(value) {
+	if (value === void 0) return void 0;
+	if (typeof value === "function") throw new TypeError("platformSerialize: function is not JSON-serializable at <root>");
+	if (typeof value === "symbol") throw new TypeError("platformSerialize: Symbol is not JSON-serializable at <root>");
+	const serialized = JSON.stringify(value, function(key, val) {
+		if (typeof val === "number" && !Number.isFinite(val)) throw new TypeError(`platformSerialize: non-finite number at ${formatPath(key)}: ${String(val)}`);
+		if (typeof val === "bigint") throw new TypeError(`platformSerialize: BigInt is not JSON-serializable at ${formatPath(key)}`);
+		const raw = this[key];
+		if (raw !== null && typeof raw === "object" && !Array.isArray(raw)) {
+			const proto = Object.getPrototypeOf(raw);
+			if (proto !== Object.prototype && proto !== null) {
+				const ctor = raw.constructor?.name ?? "anonymous";
+				throw new TypeError(`platformSerialize: non-plain object at ${formatPath(key)} (${ctor} instance)`);
+			}
+		}
+		return val;
+	});
+	if (serialized === void 0) throw new TypeError("platformSerialize: value is not JSON-serializable at <root>");
+	return JSON.parse(serialized);
+}
+function formatPath(key) {
+	return key === "" ? "<root>" : `"${key}"`;
+}
+
+//#endregion
+export { platformSerialize as t };
+//# sourceMappingURL=platform-serialize-RoRtBS0v.mjs.map

package/dist/platform-serialize-RoRtBS0v.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-serialize-RoRtBS0v.mjs","names":[],"sources":["../src/utils/test/platform-serialize.ts"],"sourcesContent":["/**\n * Validate and serialize a value as it would cross the Platform JSON boundary.\n *\n * Mirrors the runtime checks the platform performs on workflow arguments,\n * wait payloads, and trigger inputs so that local tests fail in the same\n * places production fails.\n *\n * Throws on:\n * - `NaN` / `Infinity` / `-Infinity` (`JSON.stringify` would silently emit `null`)\n * - `BigInt` (TypeError is thrown by `JSON.stringify`; we emit a clearer message)\n * - Non-plain objects (class instances, including `Date`, `Map`, `Set`, `Error`,\n *   and user-defined DTOs whose prototype is not `Object.prototype`)\n *\n * The replacer reads `this[key]` so the check sees the original value before\n * any `toJSON` conversion (e.g. `Date.prototype.toJSON`).\n * @param value - Value to validate and round-trip\n * @returns The JSON-normalized value (undefined/function properties stripped, etc.)\n */\nexport function platformSerialize<T>(value: T): T {\n  // Top-level undefined is allowed (jobs may take no input).\n  if (value === undefined) return undefined as T;\n\n  // Root function/symbol stringify to `undefined`; throw a specific message here.\n  if (typeof value === \"function\") {\n    throw new TypeError(\"platformSerialize: function is not JSON-serializable at <root>\");\n  }\n  if (typeof value === \"symbol\") {\n    throw new TypeError(\"platformSerialize: Symbol is not JSON-serializable at <root>\");\n  }\n\n  const serialized = JSON.stringify(value, function (key, val) {\n    if (typeof val === \"number\" && !Number.isFinite(val)) {\n      throw new TypeError(\n        `platformSerialize: non-finite number at ${formatPath(key)}: ${String(val)}`,\n      );\n    }\n    if (typeof val === \"bigint\") {\n      throw new TypeError(\n        `platformSerialize: BigInt is not JSON-serializable at ${formatPath(key)}`,\n      );\n    }\n    // Look at the pre-toJSON value so Date/Map/Set/etc. can be detected.\n    const raw = (this as Record<string, unknown>)[key];\n    if (raw !== null && typeof raw === \"object\" && !Array.isArray(raw)) {\n      const proto = Object.getPrototypeOf(raw);\n      if (proto !== Object.prototype && proto !== null) {\n        const ctor = (raw as { constructor?: { name?: string } }).constructor?.name ?? \"anonymous\";\n        throw new TypeError(\n          `platformSerialize: non-plain object at ${formatPath(key)} (${ctor} instance)`,\n        );\n      }\n    }\n    return val;\n  });\n\n  // `JSON.stringify` returns `undefined` when the root collapses (e.g. a `toJSON`\n  // returning `undefined`); parsing that would throw opaquely.\n  // JSON.stringify returns undefined for non-serializable values\n  // oxlint-disable-next-line typescript/no-unnecessary-condition\n  if (serialized === undefined) {\n    throw new TypeError(\"platformSerialize: value is not JSON-serializable at <root>\");\n  }\n\n  return JSON.parse(serialized) as T;\n}\n\nfunction formatPath(key: string): string {\n  return key === \"\" ? \"<root>\" : `\"${key}\"`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,kBAAqB,OAAa;CAEhD,IAAI,UAAU,QAAW,OAAO;CAGhC,IAAI,OAAO,UAAU,YACnB,MAAM,IAAI,UAAU,gEAAgE;CAEtF,IAAI,OAAO,UAAU,UACnB,MAAM,IAAI,UAAU,8DAA8D;CAGpF,MAAM,aAAa,KAAK,UAAU,OAAO,SAAU,KAAK,KAAK;EAC3D,IAAI,OAAO,QAAQ,YAAY,CAAC,OAAO,SAAS,GAAG,GACjD,MAAM,IAAI,UACR,2CAA2C,WAAW,GAAG,EAAE,IAAI,OAAO,GAAG,GAC3E;EAEF,IAAI,OAAO,QAAQ,UACjB,MAAM,IAAI,UACR,yDAAyD,WAAW,GAAG,GACzE;EAGF,MAAM,MAAO,KAAiC;EAC9C,IAAI,QAAQ,QAAQ,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG,GAAG;GAClE,MAAM,QAAQ,OAAO,eAAe,GAAG;GACvC,IAAI,UAAU,OAAO,aAAa,UAAU,MAAM;IAChD,MAAM,OAAQ,IAA4C,aAAa,QAAQ;IAC/E,MAAM,IAAI,UACR,0CAA0C,WAAW,GAAG,EAAE,IAAI,KAAK,WACrE;GACF;EACF;EACA,OAAO;CACT,CAAC;CAMD,IAAI,eAAe,QACjB,MAAM,IAAI,UAAU,6DAA6D;CAGnF,OAAO,KAAK,MAAM,UAAU;AAC9B;AAEA,SAAS,WAAW,KAAqB;CACvC,OAAO,QAAQ,KAAK,WAAW,IAAI,IAAI;AACzC"}

package/dist/plugin/builtin/enum-constants/index.d.mts

@@ -1,2 +1,16 @@
-import { n as enumConstantsPlugin, t as EnumConstantsGeneratorID } from "../../../index-DjUdWlzf.mjs";
+import { Plugin } from "../../types.mjs";
+//#region src/plugin/builtin/enum-constants/index.d.ts
+/** Unique identifier for the enum constants generator plugin. */
+declare const EnumConstantsGeneratorID = "@tailor-platform/enum-constants";
+type EnumConstantsPluginOptions = {
+  distPath: string;
+};
+/**
+ * Plugin that generates enum constants from TailorDB type definitions.
+ * @param options - Plugin options
+ * @param options.distPath - Output file path for generated constants
+ * @returns Plugin instance with onTailorDBReady hook
+ */
+declare function enumConstantsPlugin(options: EnumConstantsPluginOptions): Plugin<unknown, EnumConstantsPluginOptions>;
+//#endregion
 export { EnumConstantsGeneratorID, enumConstantsPlugin };

package/dist/plugin/builtin/file-utils/index.d.mts

@@ -1,2 +1,16 @@
-import { n as fileUtilsPlugin, t as FileUtilsGeneratorID } from "../../../index-CNYe5lnW.mjs";
+import { Plugin } from "../../types.mjs";
+//#region src/plugin/builtin/file-utils/index.d.ts
+/** Unique identifier for the file utilities generator plugin. */
+declare const FileUtilsGeneratorID = "@tailor-platform/file-utils";
+type FileUtilsPluginOptions = {
+  distPath: string;
+};
+/**
+ * Plugin that generates TypeWithFiles interface from TailorDB type definitions.
+ * @param options - Plugin options
+ * @param options.distPath - Output file path for generated file utilities
+ * @returns Plugin instance with onTailorDBReady hook
+ */
+declare function fileUtilsPlugin(options: FileUtilsPluginOptions): Plugin<unknown, FileUtilsPluginOptions>;
+//#endregion
 export { FileUtilsGeneratorID, fileUtilsPlugin };

package/dist/plugin/builtin/file-utils/index.mjs

@@ -1,3 +1,3 @@
-import { n as fileUtilsPlugin, t as FileUtilsGeneratorID } from "../../../file-utils-DcyIPFQh.mjs";
+import { n as fileUtilsPlugin, t as FileUtilsGeneratorID } from "../../../file-utils-yEiIS4nJ.mjs";
 
 export { FileUtilsGeneratorID, fileUtilsPlugin };

package/dist/plugin/builtin/kysely-type/index.d.mts

@@ -1,2 +1,16 @@
-import { n as kyselyTypePlugin, t as KyselyGeneratorID } from "../../../index-5vPyRu1y.mjs";
+import { Plugin } from "../../types.mjs";
+//#region src/plugin/builtin/kysely-type/index.d.ts
+/** Unique identifier for the Kysely type generator plugin. */
+declare const KyselyGeneratorID = "@tailor-platform/kysely-type";
+type KyselyTypePluginOptions = {
+  distPath: string;
+};
+/**
+ * Plugin that generates Kysely type definitions for TailorDB types.
+ * @param options - Plugin options
+ * @param options.distPath - Output file path for generated types
+ * @returns Plugin instance with onTailorDBReady hook
+ */
+declare function kyselyTypePlugin(options: KyselyTypePluginOptions): Plugin<unknown, KyselyTypePluginOptions>;
+//#endregion
 export { KyselyGeneratorID, kyselyTypePlugin };

package/dist/plugin/builtin/kysely-type/index.mjs

@@ -1,3 +1,3 @@
-import { n as kyselyTypePlugin, t as KyselyGeneratorID } from "../../../kysely-type-DR8uzZTA.mjs";
+import { n as kyselyTypePlugin, t as KyselyGeneratorID } from "../../../kysely-type-DqIRgDYR.mjs";
 
 export { KyselyGeneratorID, kyselyTypePlugin };