biz-a-cli 2.3.80-15224 → 2.3.80-15230

package/bin/hubEvent.js

@@ -298,6 +298,7 @@ const EngineRegistry = {
 	"bpm/workflowRT": () => import("../engine/bpm/workflow-runtime.js"),
 	"domain/system": () => import("../engine/domain/system.js"),
 	"domain/appConfig": () => import("../engine/domain/appConfig.js"),
+	"domain/applicationConfig": () => import("../engine/domain/applicationConfig.js"),
 };
 
 const handleCliCommand = async (data, cb, argv) => {

package/engine/bpm/bpm-agent.js

@@ -2,6 +2,7 @@ import {
 	executeEffect,
 	executeTimerJob,
 	executeBackgroundTransition,
+	initiate,
 } from "./workflow-runtime.js";
 import {
 	queryData,
@@ -65,6 +66,18 @@ export function initBpmAgent(broker, services = "") {
 		}
 	});
 
+	broker.on("bpm:initiate", async (payload) => {
+		try {
+			const { entityType, entityId } = payload || {};
+			await initiate({ ...payload, apiConfig: getGlobalConfig() });
+			console.log(
+				`[BPM Agent] Initiated workflow for ${entityType} ${entityId}.`,
+			);
+		} catch (error) {
+			console.error(`[BPM Agent] Initiate Failed:`, error.message);
+		}
+	});
+
 	broker.on("bpm:effect", async (payload, ackCallback) => {
 		if (!payload || (!payload.id && !payload.ID)) {
 			pollEffects();

package/engine/bpm/workflow-runtime.js

@@ -1227,10 +1227,25 @@ export async function executeEffect(effectData) {
 
 		if (effectType === "CLI_SCRIPT") {
 			console.log(`[BPM Engine] Bridging Script: ${eventName}`);
+			// Auto-inject the effect's own instanceId so the CLI script knows which workflow
+			// instance triggered it (per the BPM spec's payload-injection contract). Without
+			// this, a script that keys off scriptData.instanceId has no way to identify the
+			// instance when the effect carries no payloadTemplate.
+			const scriptData = Object.assign(
+				{},
+				parsedPayload && typeof parsedPayload === "object" && !Array.isArray(parsedPayload)
+					? parsedPayload
+					: {},
+				{
+					instanceId:
+						effectData.sys$bpm_wf_instance_id ||
+						effectData.SYS$BPM_WF_INSTANCE_ID,
+				},
+			);
 			const scriptResult = await execCLIScriptWorker(
 				apiConfig,
 				eventName,
-				parsedPayload,
+				scriptData,
 			);
 
 			// --- if cliScript of Effect need to run executeTransition ---

package/engine/domain/appConfig.js

@@ -429,12 +429,10 @@ const isFirebird25NotNullCheckForColumn = (check, columnName) => {
 		.replace(/^CHECK\s*/i, "")
 		.replace(/"/g, "")
 		.replace(/\s+/g, "")
-		.toUpperCase();
+		.toUpperCase()
+		.replace(/^\(+|\)+$/g, "");
 	const normalizedColumnName = toConstraintIdentifierPart(columnName);
-	return (
-		expression === `${normalizedColumnName}ISNOTNULL` ||
-		expression === `(${normalizedColumnName}ISNOTNULL)`
-	);
+	return expression === `${normalizedColumnName}ISNOTNULL`;
 };
 
 const resolveFirebird25NotNullCheckState = (tableName, columnName, actual) => {
@@ -451,6 +449,9 @@ const resolveFirebird25NotNullCheckState = (tableName, columnName, actual) => {
 	};
 };
 
+const getNotNullChecksForColumn = (actual, columnName) =>
+	(actual.checks ?? []).filter((check) => isFirebird25NotNullCheckForColumn(check, columnName));
+
 const describeColumnDependency = (dependency) => {
 	const dependentName = dependency.dependentName || "unnamed object";
 	return `dependency ${dependentName} (type ${dependency.dependentType})`;
@@ -588,11 +589,34 @@ export const buildTableSyncPlan = (expected, actual, options) => {
 	const migrationMode = options?.migrationMode ?? "safe";
 	const allowDestructiveChanges = migrationMode === "aggressive";
 	const compare = compareTableStructure(expected, actual);
-	if (compare.isSame) {
+	const expectedColumnsForCleanup = new Map(
+		(expected.columns ?? []).map((column) => [column.name.trim().toUpperCase(), column]),
+	);
+	const actualColumnsForCleanup = new Map(
+		(actual.columns ?? []).map((column) => [column.name.trim().toUpperCase(), column]),
+	);
+	const notNullChecksToDrop = [];
+	const seenNotNullChecks = new Set();
+	for (const [columnName, expectedColumn] of expectedColumnsForCleanup.entries()) {
+		if (expectedColumn.nullable === false || !actualColumnsForCleanup.has(columnName)) {
+			continue;
+		}
+		for (const check of getNotNullChecksForColumn(actual, expectedColumn.name)) {
+			const constraintName = String(check?.name ?? "").trim();
+			const constraintKey = constraintName.toUpperCase();
+			if (constraintName && !seenNotNullChecks.has(constraintKey)) {
+				seenNotNullChecks.add(constraintKey);
+				notNullChecksToDrop.push(constraintName);
+			}
+		}
+	}
+	if (compare.isSame && notNullChecksToDrop.length === 0) {
 		return { statements: [], warnings: [], differences: [] };
 	}
 
-	const statements = [];
+	const statements = notNullChecksToDrop.map(
+		(constraintName) => `ALTER TABLE ${expected.name} DROP CONSTRAINT ${constraintName};`,
+	);
 	const warnings = [];
 
 	const expectedColumns = new Map();
@@ -1236,6 +1260,11 @@ const buildEntityTable = (entityName, entity, defaultDbIndex) => {
 	const columns = attributeEntries.map((entry) => entry.column);
 	ensureIdentityPrimaryColumn(columns, entity?.identity);
 	const primaryKey = resolvePrimaryKey(entity, columns);
+	const identityPrimaryKey = toDbName(entity?.identity?.primaryKey ?? "");
+	const identityColumn = columns.find((column) => column.name === identityPrimaryKey);
+	if (identityColumn) {
+		identityColumn.nullable = false;
+	}
 	const uniqueKeys = buildUniqueKeys(tableName, attributeEntries, primaryKey);
 	const indexes = buildAttributeIndexes(tableName, attributeEntries, primaryKey, uniqueKeys);
 
@@ -2175,7 +2204,7 @@ const syncTable = async (table, ctx) => {
 	return executeSqlStatements(syncPlan.statements, tableDbIndex, ctx.config, ctx);
 };
 
-const resolveConfigFromPayload = (payload = {}, argv = {}) => {
+export const resolveConfigFromPayload = (payload = {}, argv = {}) => {
 	const resolvedDbIndex = toNonNegativeInteger(payload.dbIndex) ?? toNonNegativeInteger(argv.dbindex) ?? 2;
 	return {
 		dbindex: resolvedDbIndex,
@@ -2189,12 +2218,12 @@ const resolveConfigFromPayload = (payload = {}, argv = {}) => {
 	};
 };
 
-const buildPublishStatusConfigKey = (domainName, domainVersion) => ({
+export const buildPublishStatusConfigKey = (domainName, domainVersion) => ({
 	name: `${domainName}__PUBLISH_STATUS`,
 	version: domainVersion,
 });
 
-const writePublishStatus = async (name, version, statusPayload, config) => {
+export const writePublishStatus = async (name, version, statusPayload, config) => {
 	const upsertSql = getUpsertBlock(name, version, JSON.stringify(statusPayload));
 	await executeBlock(upsertSql, config);
 };

package/engine/domain/applicationConfig.js

@@ -0,0 +1,741 @@
+import { queryData } from "../../db/db.js";
+import { publishApp } from "./system.js";
+import {
+	getConfigByNameVersionParameters,
+	resolveConfigFromPayload,
+	buildPublishStatusConfigKey,
+	writePublishStatus,
+} from "./appConfig.js";
+
+export const parseConfigData = (rawConfig) => {
+	if (rawConfig == null) {
+		return null;
+	}
+	if (typeof rawConfig === "object") {
+		return rawConfig;
+	}
+
+	const rawText = String(rawConfig).trim();
+	if (!rawText) {
+		return null;
+	}
+
+	try {
+		return JSON.parse(rawText);
+	} catch {
+		try {
+			return Function(`${rawText}; return (typeof get === 'function') ? get() : null;`)();
+		} catch {
+			return null;
+		}
+	}
+};
+
+export const normalizeMenuNode = (menu) => {
+	const caption = typeof menu?.caption === "string" ? menu.caption : typeof menu?.label === "string" ? menu.label : "";
+	const rawRoute = typeof menu?.route === "string" ? menu.route.trim().toLowerCase() : "";
+	const entryPoint = typeof menu?.entryPoint === "string" && menu.entryPoint.trim().length > 0 ? menu.entryPoint.trim() : null;
+
+	const inferredLink =
+		rawRoute.endsWith("/form") || entryPoint
+			? ["./form", entryPoint ?? null, null]
+			: rawRoute.endsWith("/list")
+				? typeof menu?.id === "string" && menu.id.trim().length > 0
+					? ["./list", menu.id.trim()]
+					: ["./list"]
+				: [];
+
+	const sourceChildren = Array.isArray(menu?.subMenu) ? menu.subMenu : Array.isArray(menu?.menus) ? menu.menus : [];
+	const normalizedChildren = sourceChildren
+		.map((child) => normalizeMenuNode(child))
+		.filter(
+			(child) =>
+				String(child?.caption ?? "").trim().length > 0 ||
+				(Array.isArray(child?.link) && child.link.length > 0) ||
+				(Array.isArray(child?.subMenu) && child.subMenu.length > 0),
+		);
+
+	return {
+		menuName: typeof menu?.menuName === "string" ? menu.menuName : "",
+		caption,
+		link: Array.isArray(menu?.link) ? menu.link : inferredLink,
+		subMenu: normalizedChildren,
+	};
+};
+
+export const buildMenuStructureFromApplicationConfig = (parsedApplicationConfig) => {
+	const sourceMenus = Array.isArray(parsedApplicationConfig?.navigation?.menus) ? parsedApplicationConfig.navigation.menus : [];
+
+	const normalizedMenus = sourceMenus
+		.map((menu) => normalizeMenuNode(menu))
+		.filter(
+			(menu) =>
+				String(menu?.caption ?? "").trim().length > 0 ||
+				(Array.isArray(menu?.link) && menu.link.length > 0) ||
+				(Array.isArray(menu?.subMenu) && menu.subMenu.length > 0),
+		);
+
+	const nonHomeMenus = normalizedMenus.filter(
+		(menu) => !(menu?.caption === "Home" || (Array.isArray(menu?.link) && menu.link[0] === "./main")),
+	);
+
+	return [{ menuName: "", caption: "Home", link: ["./main"], subMenu: [] }].concat(nonHomeMenus);
+};
+
+export const normalizeTemplateFileName = (rawName) => {
+	const normalized = String(rawName ?? "")
+		.trim()
+		.toLowerCase()
+		.replace(/\s+/g, "");
+	return normalized.endsWith(".js") ? normalized : `${normalized}.js`;
+};
+
+export const collectFormTargets = (menuNode, inheritedDomainKey = null) => {
+	const targets = [];
+	const currentDomainKey =
+		typeof menuNode?.domain === "string" && menuNode.domain.trim().length > 0 ? menuNode.domain.trim() : inheritedDomainKey;
+	const explicitEntryPoint =
+		typeof menuNode?.entryPoint === "string" && menuNode.entryPoint.trim().length > 0 ? menuNode.entryPoint.trim() : null;
+	const menuLink = Array.isArray(menuNode?.link) ? menuNode.link : [];
+	const normalizedLinkTarget = String(menuLink?.[0] ?? "").trim().toLowerCase();
+	const linkedTemplateType =
+		normalizedLinkTarget === "./list" ? "list" : ["./form", "./main"].includes(normalizedLinkTarget) ? "form" : null;
+	const fallbackLinkedEntryPoint = normalizedLinkTarget === "./main" ? "main" : null;
+	const linkedEntryPoint = linkedTemplateType
+		? typeof menuLink?.[1] === "string" && menuLink[1].trim().length > 0
+			? menuLink[1].trim()
+			: fallbackLinkedEntryPoint
+		: null;
+	const resolvedEntryPoint = linkedEntryPoint ?? explicitEntryPoint;
+	if (resolvedEntryPoint) {
+		targets.push({
+			entryPointName: resolvedEntryPoint,
+			domainKey: currentDomainKey,
+			templateType: linkedTemplateType ?? "form",
+		});
+	}
+
+	const children = Array.isArray(menuNode?.menus) ? menuNode.menus : Array.isArray(menuNode?.subMenu) ? menuNode.subMenu : [];
+	for (const child of children) {
+		targets.push(...collectFormTargets(child, currentDomainKey));
+	}
+
+	return targets;
+};
+
+export const resolveDomainKeyByReference = (domainReference, domainMap) => {
+	const rawReference = String(domainReference ?? "").trim();
+	if (!rawReference) {
+		return null;
+	}
+	const domainKeys = Object.keys(domainMap ?? {});
+	if (domainKeys.length === 0) {
+		return null;
+	}
+
+	if (Object.prototype.hasOwnProperty.call(domainMap, rawReference)) {
+		return rawReference;
+	}
+
+	const normalizedReference = rawReference.toLowerCase();
+	const caseInsensitiveKeyMatch =
+		domainKeys.find((key) => String(key ?? "").trim().toLowerCase() === normalizedReference) ?? null;
+	if (caseInsensitiveKeyMatch) {
+		return caseInsensitiveKeyMatch;
+	}
+
+	for (const key of domainKeys) {
+		const domainDef = domainMap?.[key];
+		const source = String(domainDef?.source ?? "").trim();
+		const sourceName = String(source.split("@")[0] ?? "").trim();
+		const alias = String(domainDef?.alias ?? "").trim();
+		if (source && source.toLowerCase() === normalizedReference) {
+			return key;
+		}
+		if (sourceName && sourceName.toLowerCase() === normalizedReference) {
+			return key;
+		}
+		if (alias && alias.toLowerCase() === normalizedReference) {
+			return key;
+		}
+	}
+
+	return null;
+};
+
+export const resolveTemplateTargets = (parsedDomainConfig, parsedApplicationConfig) => {
+	const sourceMenus = Array.isArray(parsedApplicationConfig?.navigation?.menus) ? parsedApplicationConfig.navigation.menus : [];
+	const resolvedTargets = [];
+	const seenFileNames = new Set();
+
+	for (const menuNode of sourceMenus) {
+		const menuTargets = collectFormTargets(menuNode);
+		for (const menuTarget of menuTargets) {
+			const entryPointName = String(menuTarget.entryPointName ?? "").trim();
+			if (!entryPointName) {
+				continue;
+			}
+			const fileName = normalizeTemplateFileName(entryPointName);
+			if (seenFileNames.has(fileName)) {
+				continue;
+			}
+			seenFileNames.add(fileName);
+			resolvedTargets.push({
+				fileName,
+				entryPointName,
+				domainKey: menuTarget.domainKey ?? null,
+				templateType: menuTarget.templateType ?? "form",
+			});
+		}
+	}
+
+	const structures = parsedDomainConfig?.ui?.structures;
+	const entryPoints = parsedDomainConfig?.ui?.entryPoints;
+	const structureKeys =
+		structures && typeof structures === "object" ? Object.keys(structures).filter((key) => String(key ?? "").trim().length > 0) : [];
+	const entryPointKeys =
+		entryPoints && typeof entryPoints === "object" ? Object.keys(entryPoints).filter((key) => String(key ?? "").trim().length > 0) : [];
+	for (const entryPointName of entryPointKeys) {
+		const fileName = normalizeTemplateFileName(entryPointName);
+		if (seenFileNames.has(fileName)) {
+			continue;
+		}
+		const resolvedStructureRef = String(entryPoints?.[entryPointName]?.structureRef ?? "").trim() || entryPointName;
+		const resolvedStructure = structures?.[resolvedStructureRef];
+		seenFileNames.add(fileName);
+		resolvedTargets.push({
+			fileName,
+			entryPointName,
+			domainKey: null,
+			templateType: String(resolvedStructure?.type ?? "").trim().toLowerCase() === "list" ? "list" : "form",
+		});
+	}
+	if (resolvedTargets.length > 0) {
+		return resolvedTargets;
+	}
+	const entryPointName =
+		entryPointKeys.length > 0 ? String(entryPointKeys[0]) : structureKeys.length > 0 ? String(structureKeys[0]) : "appForm";
+	const resolvedStructureRef = String(entryPoints?.[entryPointName]?.structureRef ?? "").trim() || entryPointName;
+	const resolvedStructure = structures?.[resolvedStructureRef];
+	return [
+		{
+			fileName: normalizeTemplateFileName(entryPointName),
+			entryPointName,
+			domainKey: null,
+			templateType: String(resolvedStructure?.type ?? "").trim().toLowerCase() === "list" ? "list" : "form",
+		},
+	];
+};
+
+export const buildTemplateDomainConfigResolverSnippet = () => {
+	return `const ensureDomainConfig = (onResolved) => {
+				const callback = typeof onResolved === "function" ? onResolved : function () {};
+				const configuredSource = String("__DOMAIN_SOURCE__").trim();
+				const domainCacheKey = configuredSource || "__default__";
+				if (!this._resolvedDomainConfigBySource || typeof this._resolvedDomainConfigBySource !== "object" || Array.isArray(this._resolvedDomainConfigBySource)) {
+					this._resolvedDomainConfigBySource = {};
+				}
+				if (!this._pendingDomainConfigCallbacksBySource || typeof this._pendingDomainConfigCallbacksBySource !== "object" || Array.isArray(this._pendingDomainConfigCallbacksBySource)) {
+					this._pendingDomainConfigCallbacksBySource = {};
+				}
+				if (!this._isResolvingDomainConfigBySource || typeof this._isResolvingDomainConfigBySource !== "object" || Array.isArray(this._isResolvingDomainConfigBySource)) {
+					this._isResolvingDomainConfigBySource = {};
+				}
+				const cachedDomainConfig = this._resolvedDomainConfigBySource[domainCacheKey];
+				if (cachedDomainConfig) {
+					this.domainConfig = cachedDomainConfig;
+					callback(this.domainConfig);
+					return;
+				}
+				if (!Array.isArray(this._pendingDomainConfigCallbacksBySource[domainCacheKey])) {
+					this._pendingDomainConfigCallbacksBySource[domainCacheKey] = [];
+				}
+				this._pendingDomainConfigCallbacksBySource[domainCacheKey].push(callback);
+				if (this._isResolvingDomainConfigBySource[domainCacheKey]) {
+					return;
+				}
+				this._isResolvingDomainConfigBySource[domainCacheKey] = true;
+				const completeResolve = (resolvedConfig) => {
+					if (resolvedConfig) {
+						this._resolvedDomainConfigBySource[domainCacheKey] = resolvedConfig;
+						this.domainConfig = resolvedConfig;
+					}
+					const callbackConfig = resolvedConfig || this.domainConfig;
+					const queuedCallbacks = Array.isArray(this._pendingDomainConfigCallbacksBySource[domainCacheKey]) ? this._pendingDomainConfigCallbacksBySource[domainCacheKey].slice() : [];
+					delete this._pendingDomainConfigCallbacksBySource[domainCacheKey];
+					this._isResolvingDomainConfigBySource[domainCacheKey] = false;
+					for (let index = 0; index < queuedCallbacks.length; index += 1) {
+						try {
+							queuedCallbacks[index](callbackConfig);
+						} catch {}
+					}
+				};
+				const parseConfigData = (rawConfig) => {
+					if (rawConfig == null) {
+						return null;
+					}
+					if (typeof rawConfig === "object") {
+						if (rawConfig.metadata && rawConfig.model && rawConfig.ui) {
+							return rawConfig;
+						}
+						if (rawConfig.data != null) {
+							return parseConfigData(rawConfig.data);
+						}
+						return rawConfig;
+					}
+					const rawText = String(rawConfig).trim();
+					if (!rawText) {
+						return null;
+					}
+					try {
+						return JSON.parse(rawText);
+					} catch {
+						try {
+							return Function(rawText + "; return (typeof get === 'function') ? get() : null;")();
+						} catch {
+							return null;
+						}
+					}
+				};
+				const apiConfig = this._configApi != null ? this._configApi : this.config && this.config.api ? this.config.api : null;
+				this._configApi = apiConfig;
+				const queryDomainConfig = (domainName, domainVersion) => {
+					if (!domainName || !domainVersion) {
+						completeResolve(this.domainConfig);
+						return;
+					}
+					const domainQuery = {
+						start: 0,
+						length: 1,
+						order: [],
+						filter: [
+							{ junction: "", column: "NAME", operator: "=", value1: "'" + domainName.replace(/'/g, "''") + "'" },
+							{ junction: "AND", column: "VERSION", operator: "=", value1: "'" + domainVersion.replace(/'/g, "''") + "'" },
+						],
+						columns: [
+							{ data: "SYS$CONFIG.ID", key: "id" },
+							{ data: "SYS$CONFIG.NAME", key: "name" },
+							{ data: "SYS$CONFIG.VERSION", key: "version" },
+							{ data: "SYS$CONFIG.DATA", key: "data" },
+						],
+					};
+					this.dataService.queryData(domainQuery, apiConfig, true, true).subscribe({
+						next: (domainRows) => {
+							const domainData = domainRows && domainRows[0] ? domainRows[0].data : null;
+							const domainConfig = parseConfigData(domainData);
+							completeResolve(domainConfig || this.domainConfig);
+						},
+						error: (error) => {
+							console.log("[AppConfig] Failed to query domain config:", error);
+							completeResolve(this.domainConfig);
+						},
+					});
+				};
+				if (configuredSource) {
+					const sourceParts = configuredSource.split("@");
+					const domainName = String(sourceParts[0] || "").trim();
+					const domainVersion = String(sourceParts[1] || "").trim();
+					queryDomainConfig(domainName, domainVersion);
+					return;
+				}
+				const applicationQuery = {
+					start: 0,
+					length: 1,
+					order: [],
+					filter: [{ junction: "", column: "NAME", operator: "=", value1: "'APPLICATION_CONFIG'" }],
+					columns: [
+						{ data: "SYS$CONFIG.ID", key: "id" },
+						{ data: "SYS$CONFIG.NAME", key: "name" },
+						{ data: "SYS$CONFIG.VERSION", key: "version" },
+						{ data: "SYS$CONFIG.DATA", key: "data" },
+					],
+				};
+				this.dataService.queryData(applicationQuery, apiConfig, true, true).subscribe({
+					next: (applicationRows) => {
+						const applicationData = applicationRows && applicationRows[0] ? applicationRows[0].data : null;
+						const appConfig = parseConfigData(applicationData);
+						const domainDef = appConfig && appConfig.domains && appConfig.domains.salesOrderDomain ? appConfig.domains.salesOrderDomain : null;
+						const source = String(domainDef && domainDef.source ? domainDef.source : "").trim();
+						const sourceParts = source.split("@");
+						const domainName = String(sourceParts[0] || "").trim();
+						const domainVersion = String(sourceParts[1] || "").trim();
+						queryDomainConfig(domainName, domainVersion);
+					},
+					error: (error) => {
+						console.log("[AppConfig] Failed to query application config:", error);
+						completeResolve(this.domainConfig);
+					},
+				});
+			};
+			this._ensureDomainConfig = ensureDomainConfig;`;
+};
+
+export const buildHardcodedTemplateContent = (
+	entryPointName = "loginForm",
+	domainKey = null,
+	templateType = "form",
+	domainSource = null,
+) => {
+	const sharedDomainConfigResolverScript = buildTemplateDomainConfigResolverSnippet();
+	const formTemplateContent = `get = function () {
+	return {
+		model: {},
+		tableName: "",
+		fields: [],
+		functions: {
+			beforeLoadData: function (id) {
+${sharedDomainConfigResolverScript}
+				return new Promise((resolve) => {
+					ensureDomainConfig((resolvedConfig) => {
+						this.domainConfig = resolvedConfig || this.domainConfig;
+						console.log('Template Result :', this.domainConfig);
+						this.domainService.doBeforeLoadDataEvent({ config: this.domainConfig, entryPointName: "__ENTRY_POINT_NAME__", runtimeHost: this, id: String(id) });
+						resolve();
+					});
+				});
+			},
+			afterLoadData: function (id) {
+				const ensureDomainConfig =
+					typeof this._ensureDomainConfig === "function"
+						? this._ensureDomainConfig
+						: (onResolved) => {
+								const callback = typeof onResolved === "function" ? onResolved : function () {};
+								callback(this.domainConfig);
+							};
+				return new Promise((resolve) => {
+					ensureDomainConfig((resolvedConfig) => {
+						this.domainConfig = resolvedConfig || this.domainConfig;
+						this.domainService.doAfterLoadDataEvent({ config: this.domainConfig, entryPointName: "__ENTRY_POINT_NAME__", runtimeHost: this, id: String(id) });
+						resolve();
+					});
+				});
+			},
+			onInit: function (id) {
+				const ensureDomainConfig =
+					typeof this._ensureDomainConfig === "function"
+						? this._ensureDomainConfig
+						: (onResolved) => {
+								const callback = typeof onResolved === "function" ? onResolved : function () {};
+								callback(this.domainConfig);
+							};
+				ensureDomainConfig((resolvedConfig) => {
+					this.domainConfig = resolvedConfig || this.domainConfig;
+					if (!this.domainConfig) {
+						return;
+					}
+					const entryPointName = "__ENTRY_POINT_NAME__";
+					const uiProfile = typeof window !== "undefined" && window.matchMedia && window.matchMedia("(max-width: 767px)").matches ? "mobile" : "desktop";
+					const result = this.domainService.domainInit({ config: this.domainConfig, entryPointName, runtimeHost: this, uiProfile, id });
+					console.log('Domain Init Result :', result);
+				});
+			},
+			onDestroy: function () {
+				this.domainService.domainDestroy(this);
+			},
+		},
+	};
+};`;
+	const listTemplateContent = `get = function () {
+	return {
+		caption: "",
+		columns: [],
+		filter: [],
+		buttons: [],
+		distinct: false,
+		functions: {
+			beforeLoadData: function () {
+${sharedDomainConfigResolverScript}
+				return new Promise((resolve) => {
+					ensureDomainConfig((resolvedConfig) => {
+						this.domainConfig = resolvedConfig || this.domainConfig;
+						console.log('Template Result :', this.domainConfig);
+						this.domainService.doBeforeLoadDataEvent({
+							config: this.domainConfig,
+							entryPointName: "__ENTRY_POINT_NAME__",
+							runtimeHost: this,
+							id: this.id,
+							ctx: this.contex,
+						});
+
+						if (this._listDomainInitialized !== true) {
+							const rendered = this.domainService.domainInit({
+								config: this.domainConfig,
+								entryPointName: "__ENTRY_POINT_NAME__",
+								runtimeHost: this,
+								uiProfile: "desktop",
+							});
+							console.log('Domain Init Result :', rendered);
+
+							this.caption = rendered.caption || "";
+							this.columns = rendered.columns || [];
+							this.buttons = rendered.buttons || [];
+							this.filter = rendered.filter || [];
+							this.distinct = !!rendered.distinct;
+							this.functions = Object.assign(this.functions || {}, rendered.functions || {});
+							if (this.helper && typeof this.helper.bindFunctionInObj === "function") {
+								this.helper.bindFunctionInObj(this.functions, this);
+							}
+							this._listDomainInitialized = true;
+						}
+						resolve();
+					});
+				});
+			},
+			onPipe: function () {
+				const ensureDomainConfig =
+					typeof this._ensureDomainConfig === "function"
+						? this._ensureDomainConfig
+						: (onResolved) => {
+								const callback = typeof onResolved === "function" ? onResolved : function () {};
+								callback(this.domainConfig);
+							};
+				const rows = Array.prototype.slice.call(arguments);
+				let result = rows;
+				ensureDomainConfig((resolvedConfig) => {
+					this.domainConfig = resolvedConfig || this.domainConfig;
+					const uiProfile = typeof window !== "undefined" && window.matchMedia && window.matchMedia("(max-width: 767px)").matches ? "mobile" : "desktop";
+					result = this.domainService.domainPipe({
+						config: this.domainConfig,
+						entryPointName: "__ENTRY_POINT_NAME__",
+						runtimeHost: this,
+						uiProfile,
+						rows,
+					});
+				});
+				return result;
+			},
+			afterLoadData: function () {
+				const ensureDomainConfig =
+					typeof this._ensureDomainConfig === "function"
+						? this._ensureDomainConfig
+						: (onResolved) => {
+								const callback = typeof onResolved === "function" ? onResolved : function () {};
+								callback(this.domainConfig);
+							};
+				return new Promise((resolve) => {
+					ensureDomainConfig((resolvedConfig) => {
+						this.domainConfig = resolvedConfig || this.domainConfig;
+						this.domainService.doAfterLoadDataEvent({
+							config: this.domainConfig,
+							entryPointName: "__ENTRY_POINT_NAME__",
+							runtimeHost: this,
+							id: this.id,
+							ctx: this.contex,
+						});
+						resolve();
+					});
+				});
+			},
+		},
+	};
+};`;
+	const templateContent = templateType === "list" ? listTemplateContent : formTemplateContent;
+
+	const safeEntryPointName = String(entryPointName ?? "").trim() || "loginForm";
+	const safeDomainKey = typeof domainKey === "string" && domainKey.trim().length > 0 ? domainKey.trim() : "";
+	const safeDomainSource = typeof domainSource === "string" && domainSource.trim().length > 0 ? domainSource.trim() : "";
+	const domainResolverExpression = `(() => { const domains = appConfig && appConfig.domains && typeof appConfig.domains === 'object' ? appConfig.domains : null; if (!domains) { return null; } const preferredDomainKey = ${JSON.stringify(safeDomainKey)}; if (preferredDomainKey && domains[preferredDomainKey]) { return domains[preferredDomainKey]; } if (domains.salesOrderDomain) { return domains.salesOrderDomain; } const domainKeys = Object.keys(domains); return domainKeys.length > 0 ? domains[domainKeys[0]] : null; })()`;
+	const resolvedTemplateContent = templateContent
+		.replace(/"__ENTRY_POINT_NAME__"/g, JSON.stringify(safeEntryPointName))
+		.replace(/"__DOMAIN_SOURCE__"/g, JSON.stringify(safeDomainSource))
+		.replace(
+			"appConfig && appConfig.domains && appConfig.domains.salesOrderDomain ? appConfig.domains.salesOrderDomain : null",
+			domainResolverExpression,
+		);
+	const sanitizedTemplateContent = resolvedTemplateContent.replace(/\n\t+/g, " ");
+	return JSON.parse(JSON.stringify(sanitizedTemplateContent));
+};
+
+export const buildPublishBodyFromConfigs = (parsedApplicationConfig, parsedDomainConfig, configuredDomainName) => {
+	const safeApplicationConfig = parsedApplicationConfig ?? {};
+	const safeDomainConfig = parsedDomainConfig ?? {};
+
+	const menuStructure = buildMenuStructureFromApplicationConfig(safeApplicationConfig);
+	const menuContent = JSON.stringify(menuStructure);
+
+	const templateTargets = resolveTemplateTargets(safeDomainConfig, safeApplicationConfig);
+	const domainMap =
+		safeApplicationConfig?.domains && typeof safeApplicationConfig.domains === "object" ? safeApplicationConfig.domains : {};
+	const domainKeys = Object.keys(domainMap).filter((key) => String(key ?? "").trim().length > 0);
+	const safeConfiguredDomainName = String(configuredDomainName ?? "").trim();
+	const configuredDomainKey = safeConfiguredDomainName
+		? (resolveDomainKeyByReference(safeConfiguredDomainName, domainMap) ??
+				domainKeys.find((key) => {
+					const source = String(domainMap?.[key]?.source ?? "").trim();
+					const sourceName = String(source.split("@")[0] ?? "").trim();
+					return sourceName === safeConfiguredDomainName;
+				}) ??
+				null)
+		: null;
+	const primaryDomainKey = domainKeys.find((key) => key === "salesOrderDomain") ?? (domainKeys.length > 0 ? domainKeys[0] : null);
+	const unresolvedDomainKeys = configuredDomainKey ? domainKeys.filter((key) => key !== configuredDomainKey) : domainKeys;
+	const configuredEntryPointNames = new Set(
+		[...Object.keys(safeDomainConfig?.ui?.entryPoints ?? {}), ...Object.keys(safeDomainConfig?.ui?.structures ?? {})].filter(
+			(name) => String(name ?? "").trim().length > 0,
+		),
+	);
+	let unresolvedTargetIndex = 0;
+	const templateFiles = templateTargets.map((target, targetIndex) => {
+		const explicitDomainReference = String(target.domainKey ?? "").trim();
+		let resolvedDomainKey = explicitDomainReference.length > 0 ? resolveDomainKeyByReference(explicitDomainReference, domainMap) : null;
+		if (explicitDomainReference.length > 0 && !resolvedDomainKey) {
+			throw new Error(`Cannot resolve menu domain "${explicitDomainReference}" for entry point "${target.entryPointName}".`);
+		}
+		if (!resolvedDomainKey) {
+			const isConfiguredEntryPoint = configuredEntryPointNames.has(target.entryPointName);
+			if (isConfiguredEntryPoint && configuredDomainKey) {
+				resolvedDomainKey = configuredDomainKey;
+			} else if (configuredDomainKey) {
+				resolvedDomainKey =
+					unresolvedDomainKeys.length > 0
+						? unresolvedDomainKeys[Math.min(unresolvedTargetIndex, unresolvedDomainKeys.length - 1)]
+						: configuredDomainKey;
+				unresolvedTargetIndex += 1;
+			} else {
+				resolvedDomainKey =
+					configuredEntryPointNames.has(target.entryPointName) && primaryDomainKey
+						? primaryDomainKey
+						: domainKeys.length > 0
+							? domainKeys[Math.min(targetIndex, domainKeys.length - 1)]
+							: null;
+			}
+		}
+		const resolvedDomainSource =
+			resolvedDomainKey && domainMap && typeof domainMap === "object" ? String(domainMap?.[resolvedDomainKey]?.source ?? "").trim() : "";
+		return {
+			name: target.fileName,
+			content: buildHardcodedTemplateContent(target.entryPointName, resolvedDomainKey, target.templateType ?? "form", resolvedDomainSource),
+		};
+	});
+	const fileList = [{ name: "menu.json", content: menuContent }, ...templateFiles];
+
+	return { verbose: false, fileList };
+};
+
+export const publishApplicationConfig = async (payload = {}, argv = {}) => {
+	const applicationConfigName = String(payload?.applicationConfigName ?? "APPLICATION_CONFIG").trim() || "APPLICATION_CONFIG";
+	const applicationConfigVersion = String(payload?.applicationConfigVersion ?? "").trim();
+	if (!applicationConfigVersion) {
+		throw new Error("payload.applicationConfigVersion is required.");
+	}
+	const config = resolveConfigFromPayload(payload, argv);
+
+	const appRows = await queryData(getConfigByNameVersionParameters(applicationConfigName, applicationConfigVersion), config);
+	const appRow = appRows?.[0];
+	if (!appRow?.data) {
+		throw new Error(`SYS$CONFIG record ${applicationConfigName}@${applicationConfigVersion} was not found.`);
+	}
+	const parsedApplicationConfig = parseConfigData(appRow.data) ?? {};
+
+	/* An app bundle publish is a full replace (addApp() rebuilds the whole bundle from scratch every call), so
+	   template.js scaffolding must be generated for EVERY domain registered in application.js's `domains` map, not
+	   just whichever one this particular publish call cares about -- otherwise every other domain's screens silently
+	   drop out of the bundle on the next publish. Real incident: Supertail's own runtime-domain publish passed only
+	   `supertailruntime` as the domain to scan, which wiped out all 21 of supertailsetup's template files (they'd
+	   only ever been generated because the Admin's own editor happened to have supertailsetup loaded). */
+	const domainMap =
+		parsedApplicationConfig?.domains && typeof parsedApplicationConfig.domains === "object" ? parsedApplicationConfig.domains : {};
+	const domainsToScan = new Map();
+	for (const [domainKey, domainDef] of Object.entries(domainMap)) {
+		const source = String(domainDef?.source ?? "").trim();
+		const [sourceName, sourceVersion] = source.split("@").map((part) => String(part ?? "").trim());
+		if (sourceName && sourceVersion) {
+			domainsToScan.set(domainKey, { domainConfigName: sourceName, domainConfigVersion: sourceVersion });
+		}
+	}
+	const explicitDomainConfigName = String(payload?.domainConfigName ?? "").trim();
+	const explicitDomainConfigVersion = String(payload?.domainConfigVersion ?? "").trim();
+	if (explicitDomainConfigName && explicitDomainConfigVersion && !domainsToScan.has(explicitDomainConfigName)) {
+		domainsToScan.set(explicitDomainConfigName, { domainConfigName: explicitDomainConfigName, domainConfigVersion: explicitDomainConfigVersion });
+	}
+
+	const mergedFileList = [];
+	const seenFileNames = new Set();
+	const addFilesToMergedList = (fileList) => {
+		for (const file of fileList) {
+			if (seenFileNames.has(file.name)) {
+				continue;
+			}
+			seenFileNames.add(file.name);
+			mergedFileList.push(file);
+		}
+	};
+
+	if (domainsToScan.size === 0) {
+		addFilesToMergedList(buildPublishBodyFromConfigs(parsedApplicationConfig, {}, "").fileList);
+	} else {
+		for (const [domainKey, { domainConfigName, domainConfigVersion }] of domainsToScan) {
+			const domainRows = await queryData(getConfigByNameVersionParameters(domainConfigName, domainConfigVersion), config);
+			const domainRow = domainRows?.[0];
+			const parsedDomainConfig = domainRow?.data ? (parseConfigData(domainRow.data) ?? {}) : {};
+			addFilesToMergedList(buildPublishBodyFromConfigs(parsedApplicationConfig, parsedDomainConfig, domainKey).fileList);
+		}
+	}
+
+	const publishBody = { verbose: false, fileList: mergedFileList };
+
+	const response = await publishApp(
+		{
+			domainId: payload?.domainId ?? payload?.subdomain ?? undefined,
+			data: publishBody,
+		},
+		argv,
+	);
+	if (!response || response.success !== true) {
+		throw new Error(response?.error ? String(response.error) : "Application Config publish failed without an error message from the server.");
+	}
+	return response;
+};
+
+export const publishApplicationConfigAsync = async (payload = {}, argv = {}) => {
+	const applicationConfigName = String(payload?.applicationConfigName ?? "APPLICATION_CONFIG").trim() || "APPLICATION_CONFIG";
+	const applicationConfigVersion = String(payload?.applicationConfigVersion ?? "").trim();
+	if (!applicationConfigVersion) {
+		return { success: false, error: "payload.applicationConfigVersion is required." };
+	}
+
+	const config = resolveConfigFromPayload(payload, argv);
+	const { name, version } = buildPublishStatusConfigKey(applicationConfigName, applicationConfigVersion);
+	const startedAt = new Date().toISOString();
+
+	await writePublishStatus(name, version, { status: "IN_PROGRESS", applicationConfigName, applicationConfigVersion, startedAt }, config);
+
+	publishApplicationConfig(payload, argv)
+		.then((result) =>
+			writePublishStatus(
+				name,
+				version,
+				{
+					success: true,
+					status: "SUCCESS",
+					applicationConfigName,
+					applicationConfigVersion,
+					startedAt,
+					finishedAt: new Date().toISOString(),
+					result,
+				},
+				config,
+			),
+		)
+		.catch((error) =>
+			writePublishStatus(
+				name,
+				version,
+				{
+					success: false,
+					status: "FAILED",
+					applicationConfigName,
+					applicationConfigVersion,
+					startedAt,
+					finishedAt: new Date().toISOString(),
+					error: error?.message ?? String(error),
+				},
+				config,
+			),
+		)
+		.catch((error) => {
+			console.error(`[ApplicationConfig Publish] Failed to record publish status for ${applicationConfigName}@${applicationConfigVersion}:`, error);
+		});
+
+	return { success: true, status: "IN_PROGRESS", applicationConfigName, applicationConfigVersion, startedAt };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "biz-a-cli",
-	"version": "2.3.80-15224",
+	"version": "2.3.80-15230",
 	"description": "",
 	"main": "bin/index.js",
 	"type": "module",