@xapi-js/core 1.4.1 → 1.6.0

package/dist/index.cjs

@@ -522,9 +522,7 @@ function _unescapeXml(str) {
 	if (!str) return str;
 	if (str.indexOf("&") === -1) return str;
 	let result = str.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&apos;/g, "'").replace(/&amp;/g, "&");
-	result = result.replace(CONTROL_CHAR_ENTITY_REGEX, (match) => {
-		return ENTITY_MAP.get(match) || match;
-	});
+	result = result.replace(CONTROL_CHAR_ENTITY_REGEX, (match) => ENTITY_MAP.get(match));
 	return result;
 }
 function isXapiRoot(value) {
@@ -630,7 +628,7 @@ var XmlStringBuilder = class {
 * @returns An array of parsed XML nodes.
 */
 function parseXml(xml) {
-	if (!xml || xml.trim() === "") return [];
+	if (!xml) return [];
 	return new XapiXmlParser(xml).parse();
 }
 /**
@@ -645,6 +643,50 @@ const CHAR_SLASH = 47;
 const CHAR_EQUALS = 61;
 const CHAR_QUOTE = 34;
 const CHAR_APOS = 39;
+/** Reuse the small, fixed X-API vocabulary instead of allocating a name per node. */
+function xapiXmlName(xml, start, end) {
+	switch (end - start) {
+		case 2:
+			if (xml.startsWith("id", start)) return "id";
+			break;
+		case 3:
+			if (xml.startsWith("Col", start)) return "Col";
+			if (xml.startsWith("Row", start)) return "Row";
+			break;
+		case 4:
+			if (xml.startsWith("Root", start)) return "Root";
+			if (xml.startsWith("Rows", start)) return "Rows";
+			if (xml.startsWith("size", start)) return "size";
+			if (xml.startsWith("type", start)) return "type";
+			break;
+		case 5:
+			if (xml.startsWith("value", start)) return "value";
+			if (xml.startsWith("xmlns", start)) return "xmlns";
+			break;
+		case 6:
+			if (xml.startsWith("Column", start)) return "Column";
+			if (xml.startsWith("OrgRow", start)) return "OrgRow";
+			break;
+		case 7:
+			if (xml.startsWith("Dataset", start)) return "Dataset";
+			if (xml.startsWith("version", start)) return "version";
+			break;
+		case 8:
+			if (xml.startsWith("Datasets", start)) return "Datasets";
+			break;
+		case 9:
+			if (xml.startsWith("Parameter", start)) return "Parameter";
+			break;
+		case 10:
+			if (xml.startsWith("ColumnInfo", start)) return "ColumnInfo";
+			if (xml.startsWith("Parameters", start)) return "Parameters";
+			break;
+		case 11:
+			if (xml.startsWith("ConstColumn", start)) return "ConstColumn";
+			break;
+	}
+	return xml.substring(start, end);
+}
 /**
 * A lightweight XML parser optimized for X-API structure.
 */
@@ -658,20 +700,26 @@ var XapiXmlParser = class {
 	}
 	parse() {
 		const nodes = [];
-		while (this.pos < this.length) {
-			this.skipWhitespace();
-			if (this.pos >= this.length) break;
-			if (this.matches("<?xml")) {
-				this.skipUntil("?>");
-				this.pos += 2;
+		const xml = this.xml;
+		const length = this.length;
+		while (this.pos < length) {
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
+				this.pos++;
+			}
+			if (this.pos >= length) break;
+			if (xml.startsWith("<?xml", this.pos)) {
+				const end = xml.indexOf("?>", this.pos + 5);
+				this.pos = end < 0 ? length : end + 2;
 				continue;
 			}
-			if (this.matches("<!--")) {
-				this.skipUntil("-->");
-				this.pos += 3;
+			if (xml.startsWith("<!--", this.pos)) {
+				const end = xml.indexOf("-->", this.pos + 4);
+				this.pos = end < 0 ? length : end + 3;
 				continue;
 			}
-			if (this.current() === "<") {
+			if (xml.charCodeAt(this.pos) === 60) {
 				const node = this.parseElement();
 				if (node) nodes.push(node);
 			} else this.pos++;
@@ -679,10 +727,17 @@ var XapiXmlParser = class {
 		return nodes;
 	}
 	parseElement() {
-		if (this.current() !== "<") return null;
+		const xml = this.xml;
+		const length = this.length;
 		this.pos++;
-		if (this.current() === "/") return null;
-		const tagName = this.parseTagName();
+		if (xml.charCodeAt(this.pos) === CHAR_SLASH) return null;
+		const nameStart = this.pos;
+		while (this.pos < length) {
+			const code = xml.charCodeAt(this.pos);
+			if (code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+			this.pos++;
+		}
+		const tagName = xapiXmlName(xml, nameStart, this.pos);
 		if (!tagName) return null;
 		const node = {
 			tagName,
@@ -690,155 +745,110 @@ var XapiXmlParser = class {
 			children: void 0
 		};
 		const attributes = this.parseAttributes();
-		if (attributes && Object.keys(attributes).length > 0) node.attributes = attributes;
-		this.skipWhitespace();
-		if (this.matches("/>")) {
+		if (attributes) node.attributes = attributes;
+		if (xml.charCodeAt(this.pos) === CHAR_SLASH && xml.charCodeAt(this.pos + 1) === CHAR_GT) {
 			this.pos += 2;
 			return node;
 		}
-		if (this.current() === ">") this.pos++;
-		const children = [];
+		if (xml.charCodeAt(this.pos) === CHAR_GT) this.pos++;
+		let children;
 		let textContent = "";
-		while (this.pos < this.length) {
-			if (this.matches("<![CDATA[")) {
-				const cdataText = this.parseCDATA();
-				if (cdataText !== null) textContent += cdataText;
+		while (this.pos < length) {
+			const markup = xml.indexOf("<", this.pos);
+			if (markup < 0) {
+				this.pos = length;
+				break;
+			}
+			if (markup > this.pos) {
+				const text = xml.substring(this.pos, markup);
+				textContent = textContent ? textContent + text : text;
+				this.pos = markup;
+			}
+			if (xml.startsWith("<![CDATA[", this.pos)) {
+				const start = this.pos + 9;
+				const end = xml.indexOf("]]>", start);
+				if (end < 0) {
+					textContent += xml.substring(start);
+					this.pos = length;
+					break;
+				}
+				textContent += xml.substring(start, end);
+				this.pos = end + 3;
 				continue;
 			}
-			if (this.matches("</")) {
-				if (textContent) children.push(textContent);
+			if (xml.charCodeAt(this.pos + 1) === CHAR_SLASH) {
+				if (textContent && (!children || textContent.trim())) (children ??= []).push(textContent);
 				this.pos += 2;
-				this.skipUntil(">");
-				this.pos++;
+				const end = xml.indexOf(">", this.pos);
+				this.pos = end < 0 ? length : end + 1;
 				break;
 			}
-			if (this.current() === "<") {
-				if (textContent.trim()) {
-					children.push(textContent);
-					textContent = "";
-				}
-				const child = this.parseElement();
-				if (child) children.push(child);
-			} else {
-				textContent += this.current();
-				this.pos++;
+			if (xml.startsWith("<!--", this.pos)) {
+				const end = xml.indexOf("-->", this.pos + 4);
+				this.pos = end < 0 ? length : end + 3;
+				continue;
 			}
+			if (textContent && textContent.trim()) (children ??= []).push(textContent);
+			textContent = "";
+			const child = this.parseElement();
+			if (child) (children ??= []).push(child);
 		}
-		if (children.length > 0) node.children = children;
+		if (children) node.children = children;
 		return node;
 	}
-	parseTagName() {
-		const start = this.pos;
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
 	parseAttributes() {
-		const attrs = {};
-		while (this.pos < this.length) {
-			this.skipWhitespace();
-			const ch = this.current();
-			if (ch === ">" || ch === "/" || this.matches("/>")) break;
-			const attrName = this.parseAttributeName();
+		const xml = this.xml;
+		const length = this.length;
+		let attrs;
+		while (this.pos < length) {
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
+				this.pos++;
+			}
+			const code = xml.charCodeAt(this.pos);
+			if (code === CHAR_GT || code === CHAR_SLASH) break;
+			const nameStart = this.pos;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code === CHAR_EQUALS || code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+				this.pos++;
+			}
+			const attrName = xapiXmlName(xml, nameStart, this.pos);
 			if (!attrName) break;
-			this.skipWhitespace();
-			if (this.current() === "=") this.pos++;
-			this.skipWhitespace();
-			attrs[attrName] = this.parseAttributeValue();
-		}
-		return Object.keys(attrs).length > 0 ? attrs : void 0;
-	}
-	parseAttributeName() {
-		const start = this.pos;
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (code === CHAR_EQUALS || this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
-	parseAttributeValue() {
-		const quoteCode = this.currentCharCode();
-		if (quoteCode !== CHAR_QUOTE && quoteCode !== CHAR_APOS) {
-			const start = this.pos;
-			while (this.pos < this.length) {
-				const code = this.currentCharCode();
-				if (this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
 				this.pos++;
 			}
-			return this.xml.substring(start, this.pos);
-		}
-		this.pos++;
-		const start = this.pos;
-		while (this.pos < this.length) {
-			if (this.currentCharCode() === quoteCode) {
-				const value = this.xml.substring(start, this.pos);
+			if (xml.charCodeAt(this.pos) === CHAR_EQUALS) this.pos++;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
 				this.pos++;
-				return value;
 			}
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
-	parseCDATA() {
-		if (!this.matches("<![CDATA[")) return null;
-		this.pos += 9;
-		const endPos = this.findString("]]>");
-		if (endPos === -1) {
-			const content = this.xml.substring(this.pos);
-			this.pos = this.length;
-			return content;
-		}
-		const content = this.xml.substring(this.pos, endPos);
-		this.pos = endPos + 3;
-		return content;
-	}
-	skipWhitespace() {
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
-			this.pos++;
+			const quote = xml.charCodeAt(this.pos);
+			let valueStart;
+			let valueEnd;
+			if (quote === CHAR_QUOTE || quote === CHAR_APOS) {
+				valueStart = ++this.pos;
+				valueEnd = xml.indexOf(quote === CHAR_QUOTE ? "\"" : "'", valueStart);
+				if (valueEnd < 0) {
+					valueEnd = length;
+					this.pos = length;
+				} else this.pos = valueEnd + 1;
+			} else {
+				valueStart = this.pos;
+				while (this.pos < length) {
+					const code = xml.charCodeAt(this.pos);
+					if (code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+					this.pos++;
+				}
+				valueEnd = this.pos;
+			}
+			(attrs ??= {})[attrName] = xml.substring(valueStart, valueEnd);
 		}
-	}
-	isWhitespace(code) {
-		return code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR;
-	}
-	skipUntil(target) {
-		const pos = this.findString(target);
-		if (pos !== -1) this.pos = pos;
-		else this.pos = this.length;
-	}
-	current() {
-		return this.xml[this.pos];
-	}
-	currentCharCode() {
-		return this.xml.charCodeAt(this.pos);
-	}
-	/**
-	* Checks if the string at the given position matches the target string.
-	* This avoids creating substring instances for comparison.
-	* @param str - The target string to match
-	* @param pos - The position to check from (default: current position)
-	*/
-	matches(str, pos = this.pos) {
-		const len = str.length;
-		if (pos + len > this.length) return false;
-		for (let i = 0; i < len; i++) if (this.xml.charCodeAt(pos + i) !== str.charCodeAt(i)) return false;
-		return true;
-	}
-	/**
-	* Finds the position of a target string starting from the given position.
-	* @param str - The string to find
-	* @param startPos - Starting position (default: current position)
-	* @returns The position where the string is found, or -1 if not found
-	*/
-	findString(str, startPos = this.pos) {
-		const maxPos = this.length - str.length;
-		for (let pos = startPos; pos <= maxPos; pos++) if (this.matches(str, pos)) return pos;
-		return -1;
+		return attrs;
 	}
 };
 //#endregion
@@ -934,7 +944,6 @@ function parseColumnInfo(columnInfoElement, dataset) {
 	}
 }
 function parseRows(rowsElement, dataset) {
-	if (typeof rowsElement === "string") return;
 	const rows = rowsElement?.children;
 	if (!rows) return;
 	const datasetRows = dataset.rows;
@@ -985,8 +994,6 @@ function parseRows(rowsElement, dataset) {
 	}
 }
 function parseParameters(parametersElement, xapiRoot) {
-	if (typeof parametersElement === "string") return;
-	if (!parametersElement) return;
 	const children = parametersElement.children;
 	if (!children) return;
 	for (let i = 0; i < children.length; i++) {
@@ -1021,19 +1028,17 @@ function write(root) {
 	return builder.toString();
 }
 function writeParameters(builder, parameters) {
-	if (parameters) {
-		builder.writeStartElement("Parameters");
-		for (const parameter of parameters) {
-			const attrs = { id: parameter.id };
-			if (parameter.type !== void 0) attrs.type = parameter.type;
-			if (parameter.value !== void 0) if (typeof parameter.value === "string") attrs.value = parameter.value;
-			else if (parameter.value instanceof Date) attrs.value = dateToString(parameter.value, parameter.type);
-			else if (parameter.value instanceof Uint8Array) attrs.value = uint8ArrayToBase64(parameter.value);
-			else attrs.value = String(parameter.value);
-			builder.writeStartElement("Parameter", attrs, true);
-		}
-		builder.writeEndElement("Parameters");
-	}
+	builder.writeStartElement("Parameters");
+	for (const parameter of parameters) {
+		const attrs = { id: parameter.id };
+		if (parameter.type !== void 0) attrs.type = parameter.type;
+		if (parameter.value !== void 0) if (typeof parameter.value === "string") attrs.value = parameter.value;
+		else if (parameter.value instanceof Date) attrs.value = dateToString(parameter.value, parameter.type);
+		else if (parameter.value instanceof Uint8Array) attrs.value = uint8ArrayToBase64(parameter.value);
+		else attrs.value = String(parameter.value);
+		builder.writeStartElement("Parameter", attrs, true);
+	}
+	builder.writeEndElement("Parameters");
 }
 function writeDataset(builder, dataset) {
 	builder.writeStartElement("Dataset", { id: dataset.id });
@@ -1147,7 +1152,12 @@ function encodeRoot(schema, value) {
 		const rows = value.datasets[datasetId];
 		for (const row of rows) {
 			const rowIndex = dataset.newRow();
+			dataset.rows[rowIndex].type = row.$rowType;
 			for (const id of Object.keys(datasetSchema.columns)) dataset.setColumn(rowIndex, id, row[id]);
+			if (row.$orgRow) dataset.rows[rowIndex].orgRow = Object.entries(row.$orgRow).map(([id, value]) => ({
+				id,
+				value
+			}));
 		}
 		root.addDataset(dataset);
 	}
@@ -1170,6 +1180,8 @@ function decodeRoot(schema, root) {
 		datasets[datasetId] = dataset.getRows().map((row) => {
 			const value = { ...constants };
 			for (const column of row.cols) if (column.id in datasetSchema.columns) value[column.id] = column.value;
+			if (row.type) value.$rowType = row.type;
+			if (row.orgRow) value.$orgRow = Object.fromEntries(row.orgRow.map((column) => [column.id, column.value]));
 			return value;
 		});
 	}
@@ -1179,6 +1191,130 @@ function decodeRoot(schema, root) {
 	};
 }
 //#endregion
+//#region src/codec.ts
+const rowTypes = {
+	N: void 0,
+	I: "insert",
+	U: "update",
+	D: "delete",
+	O: void 0
+};
+function sizeOf(size, type) {
+	if (size !== void 0) return Number(size);
+	return type === "STRING" ? 255 : 0;
+}
+function jsonValue(value, type) {
+	if (value === null || value === void 0) return void 0;
+	if (type === "DATE" || type === "DATETIME" || type === "TIME") return typeof value === "string" ? convertToColumnType(value, type) : value;
+	if (type === "BLOB" && typeof value === "string") return convertToColumnType(value, type);
+	return value;
+}
+function jsonWireValue(value, type) {
+	if (value === void 0) return void 0;
+	if (value instanceof Date) return dateToString(value, type);
+	if (value instanceof Uint8Array) return uint8ArrayToBase64(value);
+	return value;
+}
+function columnsToObject(columns) {
+	return Object.fromEntries(columns.map((column) => [column.id, column.value]));
+}
+function readRow(dataset, row) {
+	const rowType = rowTypes[row._RowType_ ?? "N"];
+	if (row._RowType_ === "O") {
+		const previous = dataset.rows[dataset.rows.length - 1];
+		if (previous?.type !== "update") return;
+		previous.orgRow = dataset.getColumns().filter((column) => Object.prototype.hasOwnProperty.call(row, column.id)).map((column) => ({
+			id: column.id,
+			value: jsonValue(row[column.id], column.type)
+		}));
+		return;
+	}
+	const index = dataset.newRow();
+	dataset.rows[index].type = rowType;
+	for (const column of dataset.getColumns()) if (Object.prototype.hasOwnProperty.call(row, column.id)) dataset.rows[index].cols.push({
+		id: column.id,
+		value: jsonValue(row[column.id], column.type)
+	});
+}
+function readJson(value) {
+	const root = new XapiRoot();
+	for (const parameter of value.Parameters ?? []) root.addParameter({
+		id: parameter.id,
+		type: parameter.type,
+		value: jsonValue(parameter.value, parameter.type)
+	});
+	for (const source of value.Datasets ?? []) {
+		const dataset = new Dataset(source.id);
+		for (const column of source.ColumnInfo.ConstColumn ?? []) {
+			const type = column.type ?? "STRING";
+			dataset.addConstColumn({
+				id: column.id,
+				type,
+				size: sizeOf(column.size, type),
+				value: jsonValue(column.value, type)
+			});
+		}
+		for (const column of source.ColumnInfo.Column) {
+			const type = column.type ?? "STRING";
+			dataset.addColumn({
+				id: column.id,
+				type,
+				size: sizeOf(column.size, type)
+			});
+		}
+		for (const row of source.Rows) readRow(dataset, row);
+		root.addDataset(dataset);
+	}
+	return root;
+}
+function writeJson(root) {
+	return {
+		version: "1.0",
+		...root.parameterSize() ? { Parameters: root.getParameters().map((parameter) => ({
+			id: parameter.id,
+			...parameter.type ? { type: parameter.type } : {},
+			...parameter.value !== void 0 ? { value: jsonWireValue(parameter.value, parameter.type ?? "STRING") } : {}
+		})) } : {},
+		...root.datasetSize() ? { Datasets: root.getDatasets().map((dataset) => ({
+			id: dataset.id,
+			ColumnInfo: {
+				...dataset.constColumnSize() ? { ConstColumn: dataset.getConstColumns().map((column) => ({
+					id: column.id,
+					type: column.type,
+					size: column.size,
+					value: jsonWireValue(column.value, column.type)
+				})) } : {},
+				Column: dataset.getColumns().map((column) => ({
+					id: column.id,
+					type: column.type,
+					size: column.size
+				}))
+			},
+			Rows: dataset.getRows().flatMap((row) => {
+				const current = {
+					_RowType_: row.type === "insert" ? "I" : row.type === "update" ? "U" : row.type === "delete" ? "D" : "N",
+					...columnsToObject(row.cols)
+				};
+				if (!row.orgRow) return [current];
+				return [current, {
+					_RowType_: "O",
+					...columnsToObject(row.orgRow)
+				}];
+			})
+		})) } : {}
+	};
+}
+const nexacroJsonCodec = {
+	serialize: writeJson,
+	deserialize: readJson
+};
+function parseJson(value) {
+	return nexacroJsonCodec.deserialize(JSON.parse(value));
+}
+function writeJsonString(root) {
+	return JSON.stringify(nexacroJsonCodec.serialize(root));
+}
+//#endregion
 exports.ColumnTypeError = ColumnTypeError;
 exports.Dataset = Dataset;
 exports.InvalidXmlError = InvalidXmlError;
@@ -1204,11 +1340,14 @@ exports.escapeXml = escapeXml;
 exports.initXapi = initXapi;
 exports.isXapiRoot = isXapiRoot;
 exports.makeParseEntities = makeParseEntities;
+exports.nexacroJsonCodec = nexacroJsonCodec;
 exports.parse = parse;
+exports.parseJson = parseJson;
 exports.parseXml = parseXml;
 exports.rowType = rowType;
 exports.stringToDate = stringToDate;
 exports.stringToReadableStream = stringToReadableStream;
 exports.uint8ArrayToBase64 = uint8ArrayToBase64;
 exports.write = write;
+exports.writeJsonString = writeJsonString;
 exports.xapi = xapi;

package/dist/index.d.cts

@@ -506,7 +506,15 @@ interface XapiOperation<Request extends XapiRootSchema = XapiRootSchema, Respons
 type RequiredColumnKeys<Columns extends XapiColumns> = { [Key in keyof Columns]-?: Columns[Key]["optional"] extends true ? never : Key; }[keyof Columns];
 type OptionalColumnKeys<Columns extends XapiColumns> = { [Key in keyof Columns]-?: Columns[Key]["optional"] extends true ? Key : never; }[keyof Columns];
 type InferColumns<Columns extends XapiColumns> = { [Key in RequiredColumnKeys<Columns>]: XapiTypeMap[Columns[Key]["type"]]; } & { [Key in OptionalColumnKeys<Columns>]?: XapiTypeMap[Columns[Key]["type"]]; };
-type InferDataset<Schema extends XapiDatasetSchema> = InferColumns<Schema["columns"]>[];
+/**
+ * A schema row remains assignable from the old plain object shape, while
+ * retaining the Nexacro row metadata when an operation needs it.
+ */
+type InferDatasetRow<Schema extends XapiDatasetSchema> = InferColumns<Schema["columns"]> & {
+  $rowType?: RowType;
+  $orgRow?: Partial<InferColumns<Schema["columns"]>>;
+};
+type InferDataset<Schema extends XapiDatasetSchema> = InferDatasetRow<Schema>[];
 type InferRoot<Schema extends XapiRootSchema> = {
   parameters: InferColumns<Schema["parameters"]>;
   datasets: { [Key in keyof Schema["datasets"]]: InferDataset<Schema["datasets"][Key]>; };
@@ -543,4 +551,43 @@ declare const xapi: {
 declare function encodeRoot<Schema extends XapiRootSchema>(schema: Schema, value: InferRoot<Schema>): XapiRoot;
 declare function decodeRoot<Schema extends XapiRootSchema>(schema: Schema, root: XapiRoot): InferRoot<Schema>;
 //#endregion
-export { Col, Column, ColumnInfo, ColumnType, ColumnTypeError, ConstColumn, Dataset, InferColumns, InferDataset, InferRoot, InvalidXmlError, NexaVersion, Parameter, RequestOf, ResponseOf, Row, RowType, Rows, StringWritableStream, XapiColumnSchema, XapiColumns, XapiDatasetSchema, XapiDatasets, XapiOperation, XapiOptions, XapiParameters, XapiRoot, XapiRootSchema, XapiTypeMap, XapiValueType, XapiVersion, XmlNode, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, parse, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, xapi };
+//#region src/codec.d.ts
+/** The wire representation used by Nexacro's Dataset JSON format. */
+interface NexacroJsonParameter {
+  id: string;
+  type?: ColumnType;
+  value?: string | number;
+}
+interface NexacroJsonColumn {
+  id: string;
+  type?: ColumnType;
+  size?: number | string;
+  value?: string | number;
+}
+interface NexacroJsonRow {
+  _RowType_?: "N" | "I" | "U" | "D" | "O";
+  [columnId: string]: unknown;
+}
+interface NexacroJsonDataset {
+  id: string;
+  ColumnInfo: {
+    ConstColumn?: NexacroJsonColumn[];
+    Column: NexacroJsonColumn[];
+  };
+  Rows: NexacroJsonRow[];
+}
+interface NexacroJsonRoot {
+  version: "1.0";
+  Parameters?: NexacroJsonParameter[];
+  Datasets?: NexacroJsonDataset[];
+}
+/** A serializer boundary around the X-API internal model. */
+interface XapiCodec<Serialized> {
+  serialize(root: XapiRoot): Serialized;
+  deserialize(value: Serialized): XapiRoot;
+}
+declare const nexacroJsonCodec: XapiCodec<NexacroJsonRoot>;
+declare function parseJson(value: string): XapiRoot;
+declare function writeJsonString(root: XapiRoot): string;
+//#endregion
+export { Col, Column, ColumnInfo, ColumnType, ColumnTypeError, ConstColumn, Dataset, InferColumns, InferDataset, InferDatasetRow, InferRoot, InvalidXmlError, NexaVersion, NexacroJsonColumn, NexacroJsonDataset, NexacroJsonParameter, NexacroJsonRoot, NexacroJsonRow, Parameter, RequestOf, ResponseOf, Row, RowType, Rows, StringWritableStream, XapiCodec, XapiColumnSchema, XapiColumns, XapiDatasetSchema, XapiDatasets, XapiOperation, XapiOptions, XapiParameters, XapiRoot, XapiRootSchema, XapiTypeMap, XapiValueType, XapiVersion, XmlNode, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, nexacroJsonCodec, parse, parseJson, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, writeJsonString, xapi };

package/dist/index.d.ts

@@ -506,7 +506,15 @@ interface XapiOperation<Request extends XapiRootSchema = XapiRootSchema, Respons
 type RequiredColumnKeys<Columns extends XapiColumns> = { [Key in keyof Columns]-?: Columns[Key]["optional"] extends true ? never : Key; }[keyof Columns];
 type OptionalColumnKeys<Columns extends XapiColumns> = { [Key in keyof Columns]-?: Columns[Key]["optional"] extends true ? Key : never; }[keyof Columns];
 type InferColumns<Columns extends XapiColumns> = { [Key in RequiredColumnKeys<Columns>]: XapiTypeMap[Columns[Key]["type"]]; } & { [Key in OptionalColumnKeys<Columns>]?: XapiTypeMap[Columns[Key]["type"]]; };
-type InferDataset<Schema extends XapiDatasetSchema> = InferColumns<Schema["columns"]>[];
+/**
+ * A schema row remains assignable from the old plain object shape, while
+ * retaining the Nexacro row metadata when an operation needs it.
+ */
+type InferDatasetRow<Schema extends XapiDatasetSchema> = InferColumns<Schema["columns"]> & {
+  $rowType?: RowType;
+  $orgRow?: Partial<InferColumns<Schema["columns"]>>;
+};
+type InferDataset<Schema extends XapiDatasetSchema> = InferDatasetRow<Schema>[];
 type InferRoot<Schema extends XapiRootSchema> = {
   parameters: InferColumns<Schema["parameters"]>;
   datasets: { [Key in keyof Schema["datasets"]]: InferDataset<Schema["datasets"][Key]>; };
@@ -543,4 +551,43 @@ declare const xapi: {
 declare function encodeRoot<Schema extends XapiRootSchema>(schema: Schema, value: InferRoot<Schema>): XapiRoot;
 declare function decodeRoot<Schema extends XapiRootSchema>(schema: Schema, root: XapiRoot): InferRoot<Schema>;
 //#endregion
-export { Col, Column, ColumnInfo, ColumnType, ColumnTypeError, ConstColumn, Dataset, InferColumns, InferDataset, InferRoot, InvalidXmlError, NexaVersion, Parameter, RequestOf, ResponseOf, Row, RowType, Rows, StringWritableStream, XapiColumnSchema, XapiColumns, XapiDatasetSchema, XapiDatasets, XapiOperation, XapiOptions, XapiParameters, XapiRoot, XapiRootSchema, XapiTypeMap, XapiValueType, XapiVersion, XmlNode, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, parse, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, xapi };
+//#region src/codec.d.ts
+/** The wire representation used by Nexacro's Dataset JSON format. */
+interface NexacroJsonParameter {
+  id: string;
+  type?: ColumnType;
+  value?: string | number;
+}
+interface NexacroJsonColumn {
+  id: string;
+  type?: ColumnType;
+  size?: number | string;
+  value?: string | number;
+}
+interface NexacroJsonRow {
+  _RowType_?: "N" | "I" | "U" | "D" | "O";
+  [columnId: string]: unknown;
+}
+interface NexacroJsonDataset {
+  id: string;
+  ColumnInfo: {
+    ConstColumn?: NexacroJsonColumn[];
+    Column: NexacroJsonColumn[];
+  };
+  Rows: NexacroJsonRow[];
+}
+interface NexacroJsonRoot {
+  version: "1.0";
+  Parameters?: NexacroJsonParameter[];
+  Datasets?: NexacroJsonDataset[];
+}
+/** A serializer boundary around the X-API internal model. */
+interface XapiCodec<Serialized> {
+  serialize(root: XapiRoot): Serialized;
+  deserialize(value: Serialized): XapiRoot;
+}
+declare const nexacroJsonCodec: XapiCodec<NexacroJsonRoot>;
+declare function parseJson(value: string): XapiRoot;
+declare function writeJsonString(root: XapiRoot): string;
+//#endregion
+export { Col, Column, ColumnInfo, ColumnType, ColumnTypeError, ConstColumn, Dataset, InferColumns, InferDataset, InferDatasetRow, InferRoot, InvalidXmlError, NexaVersion, NexacroJsonColumn, NexacroJsonDataset, NexacroJsonParameter, NexacroJsonRoot, NexacroJsonRow, Parameter, RequestOf, ResponseOf, Row, RowType, Rows, StringWritableStream, XapiCodec, XapiColumnSchema, XapiColumns, XapiDatasetSchema, XapiDatasets, XapiOperation, XapiOptions, XapiParameters, XapiRoot, XapiRootSchema, XapiTypeMap, XapiValueType, XapiVersion, XmlNode, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, nexacroJsonCodec, parse, parseJson, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, writeJsonString, xapi };

package/dist/index.js

@@ -521,9 +521,7 @@ function _unescapeXml(str) {
 	if (!str) return str;
 	if (str.indexOf("&") === -1) return str;
 	let result = str.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&apos;/g, "'").replace(/&amp;/g, "&");
-	result = result.replace(CONTROL_CHAR_ENTITY_REGEX, (match) => {
-		return ENTITY_MAP.get(match) || match;
-	});
+	result = result.replace(CONTROL_CHAR_ENTITY_REGEX, (match) => ENTITY_MAP.get(match));
 	return result;
 }
 function isXapiRoot(value) {
@@ -629,7 +627,7 @@ var XmlStringBuilder = class {
 * @returns An array of parsed XML nodes.
 */
 function parseXml(xml) {
-	if (!xml || xml.trim() === "") return [];
+	if (!xml) return [];
 	return new XapiXmlParser(xml).parse();
 }
 /**
@@ -644,6 +642,50 @@ const CHAR_SLASH = 47;
 const CHAR_EQUALS = 61;
 const CHAR_QUOTE = 34;
 const CHAR_APOS = 39;
+/** Reuse the small, fixed X-API vocabulary instead of allocating a name per node. */
+function xapiXmlName(xml, start, end) {
+	switch (end - start) {
+		case 2:
+			if (xml.startsWith("id", start)) return "id";
+			break;
+		case 3:
+			if (xml.startsWith("Col", start)) return "Col";
+			if (xml.startsWith("Row", start)) return "Row";
+			break;
+		case 4:
+			if (xml.startsWith("Root", start)) return "Root";
+			if (xml.startsWith("Rows", start)) return "Rows";
+			if (xml.startsWith("size", start)) return "size";
+			if (xml.startsWith("type", start)) return "type";
+			break;
+		case 5:
+			if (xml.startsWith("value", start)) return "value";
+			if (xml.startsWith("xmlns", start)) return "xmlns";
+			break;
+		case 6:
+			if (xml.startsWith("Column", start)) return "Column";
+			if (xml.startsWith("OrgRow", start)) return "OrgRow";
+			break;
+		case 7:
+			if (xml.startsWith("Dataset", start)) return "Dataset";
+			if (xml.startsWith("version", start)) return "version";
+			break;
+		case 8:
+			if (xml.startsWith("Datasets", start)) return "Datasets";
+			break;
+		case 9:
+			if (xml.startsWith("Parameter", start)) return "Parameter";
+			break;
+		case 10:
+			if (xml.startsWith("ColumnInfo", start)) return "ColumnInfo";
+			if (xml.startsWith("Parameters", start)) return "Parameters";
+			break;
+		case 11:
+			if (xml.startsWith("ConstColumn", start)) return "ConstColumn";
+			break;
+	}
+	return xml.substring(start, end);
+}
 /**
 * A lightweight XML parser optimized for X-API structure.
 */
@@ -657,20 +699,26 @@ var XapiXmlParser = class {
 	}
 	parse() {
 		const nodes = [];
-		while (this.pos < this.length) {
-			this.skipWhitespace();
-			if (this.pos >= this.length) break;
-			if (this.matches("<?xml")) {
-				this.skipUntil("?>");
-				this.pos += 2;
+		const xml = this.xml;
+		const length = this.length;
+		while (this.pos < length) {
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
+				this.pos++;
+			}
+			if (this.pos >= length) break;
+			if (xml.startsWith("<?xml", this.pos)) {
+				const end = xml.indexOf("?>", this.pos + 5);
+				this.pos = end < 0 ? length : end + 2;
 				continue;
 			}
-			if (this.matches("<!--")) {
-				this.skipUntil("-->");
-				this.pos += 3;
+			if (xml.startsWith("<!--", this.pos)) {
+				const end = xml.indexOf("-->", this.pos + 4);
+				this.pos = end < 0 ? length : end + 3;
 				continue;
 			}
-			if (this.current() === "<") {
+			if (xml.charCodeAt(this.pos) === 60) {
 				const node = this.parseElement();
 				if (node) nodes.push(node);
 			} else this.pos++;
@@ -678,10 +726,17 @@ var XapiXmlParser = class {
 		return nodes;
 	}
 	parseElement() {
-		if (this.current() !== "<") return null;
+		const xml = this.xml;
+		const length = this.length;
 		this.pos++;
-		if (this.current() === "/") return null;
-		const tagName = this.parseTagName();
+		if (xml.charCodeAt(this.pos) === CHAR_SLASH) return null;
+		const nameStart = this.pos;
+		while (this.pos < length) {
+			const code = xml.charCodeAt(this.pos);
+			if (code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+			this.pos++;
+		}
+		const tagName = xapiXmlName(xml, nameStart, this.pos);
 		if (!tagName) return null;
 		const node = {
 			tagName,
@@ -689,155 +744,110 @@ var XapiXmlParser = class {
 			children: void 0
 		};
 		const attributes = this.parseAttributes();
-		if (attributes && Object.keys(attributes).length > 0) node.attributes = attributes;
-		this.skipWhitespace();
-		if (this.matches("/>")) {
+		if (attributes) node.attributes = attributes;
+		if (xml.charCodeAt(this.pos) === CHAR_SLASH && xml.charCodeAt(this.pos + 1) === CHAR_GT) {
 			this.pos += 2;
 			return node;
 		}
-		if (this.current() === ">") this.pos++;
-		const children = [];
+		if (xml.charCodeAt(this.pos) === CHAR_GT) this.pos++;
+		let children;
 		let textContent = "";
-		while (this.pos < this.length) {
-			if (this.matches("<![CDATA[")) {
-				const cdataText = this.parseCDATA();
-				if (cdataText !== null) textContent += cdataText;
+		while (this.pos < length) {
+			const markup = xml.indexOf("<", this.pos);
+			if (markup < 0) {
+				this.pos = length;
+				break;
+			}
+			if (markup > this.pos) {
+				const text = xml.substring(this.pos, markup);
+				textContent = textContent ? textContent + text : text;
+				this.pos = markup;
+			}
+			if (xml.startsWith("<![CDATA[", this.pos)) {
+				const start = this.pos + 9;
+				const end = xml.indexOf("]]>", start);
+				if (end < 0) {
+					textContent += xml.substring(start);
+					this.pos = length;
+					break;
+				}
+				textContent += xml.substring(start, end);
+				this.pos = end + 3;
 				continue;
 			}
-			if (this.matches("</")) {
-				if (textContent) children.push(textContent);
+			if (xml.charCodeAt(this.pos + 1) === CHAR_SLASH) {
+				if (textContent && (!children || textContent.trim())) (children ??= []).push(textContent);
 				this.pos += 2;
-				this.skipUntil(">");
-				this.pos++;
+				const end = xml.indexOf(">", this.pos);
+				this.pos = end < 0 ? length : end + 1;
 				break;
 			}
-			if (this.current() === "<") {
-				if (textContent.trim()) {
-					children.push(textContent);
-					textContent = "";
-				}
-				const child = this.parseElement();
-				if (child) children.push(child);
-			} else {
-				textContent += this.current();
-				this.pos++;
+			if (xml.startsWith("<!--", this.pos)) {
+				const end = xml.indexOf("-->", this.pos + 4);
+				this.pos = end < 0 ? length : end + 3;
+				continue;
 			}
+			if (textContent && textContent.trim()) (children ??= []).push(textContent);
+			textContent = "";
+			const child = this.parseElement();
+			if (child) (children ??= []).push(child);
 		}
-		if (children.length > 0) node.children = children;
+		if (children) node.children = children;
 		return node;
 	}
-	parseTagName() {
-		const start = this.pos;
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
 	parseAttributes() {
-		const attrs = {};
-		while (this.pos < this.length) {
-			this.skipWhitespace();
-			const ch = this.current();
-			if (ch === ">" || ch === "/" || this.matches("/>")) break;
-			const attrName = this.parseAttributeName();
+		const xml = this.xml;
+		const length = this.length;
+		let attrs;
+		while (this.pos < length) {
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
+				this.pos++;
+			}
+			const code = xml.charCodeAt(this.pos);
+			if (code === CHAR_GT || code === CHAR_SLASH) break;
+			const nameStart = this.pos;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code === CHAR_EQUALS || code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+				this.pos++;
+			}
+			const attrName = xapiXmlName(xml, nameStart, this.pos);
 			if (!attrName) break;
-			this.skipWhitespace();
-			if (this.current() === "=") this.pos++;
-			this.skipWhitespace();
-			attrs[attrName] = this.parseAttributeValue();
-		}
-		return Object.keys(attrs).length > 0 ? attrs : void 0;
-	}
-	parseAttributeName() {
-		const start = this.pos;
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (code === CHAR_EQUALS || this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
-	parseAttributeValue() {
-		const quoteCode = this.currentCharCode();
-		if (quoteCode !== CHAR_QUOTE && quoteCode !== CHAR_APOS) {
-			const start = this.pos;
-			while (this.pos < this.length) {
-				const code = this.currentCharCode();
-				if (this.isWhitespace(code) || code === CHAR_GT || code === CHAR_SLASH) break;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
 				this.pos++;
 			}
-			return this.xml.substring(start, this.pos);
-		}
-		this.pos++;
-		const start = this.pos;
-		while (this.pos < this.length) {
-			if (this.currentCharCode() === quoteCode) {
-				const value = this.xml.substring(start, this.pos);
+			if (xml.charCodeAt(this.pos) === CHAR_EQUALS) this.pos++;
+			while (this.pos < length) {
+				const code = xml.charCodeAt(this.pos);
+				if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
 				this.pos++;
-				return value;
 			}
-			this.pos++;
-		}
-		return this.xml.substring(start, this.pos);
-	}
-	parseCDATA() {
-		if (!this.matches("<![CDATA[")) return null;
-		this.pos += 9;
-		const endPos = this.findString("]]>");
-		if (endPos === -1) {
-			const content = this.xml.substring(this.pos);
-			this.pos = this.length;
-			return content;
-		}
-		const content = this.xml.substring(this.pos, endPos);
-		this.pos = endPos + 3;
-		return content;
-	}
-	skipWhitespace() {
-		while (this.pos < this.length) {
-			const code = this.currentCharCode();
-			if (code !== CHAR_SPACE && code !== CHAR_TAB && code !== CHAR_LF && code !== CHAR_CR) break;
-			this.pos++;
+			const quote = xml.charCodeAt(this.pos);
+			let valueStart;
+			let valueEnd;
+			if (quote === CHAR_QUOTE || quote === CHAR_APOS) {
+				valueStart = ++this.pos;
+				valueEnd = xml.indexOf(quote === CHAR_QUOTE ? "\"" : "'", valueStart);
+				if (valueEnd < 0) {
+					valueEnd = length;
+					this.pos = length;
+				} else this.pos = valueEnd + 1;
+			} else {
+				valueStart = this.pos;
+				while (this.pos < length) {
+					const code = xml.charCodeAt(this.pos);
+					if (code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR || code === CHAR_GT || code === CHAR_SLASH) break;
+					this.pos++;
+				}
+				valueEnd = this.pos;
+			}
+			(attrs ??= {})[attrName] = xml.substring(valueStart, valueEnd);
 		}
-	}
-	isWhitespace(code) {
-		return code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LF || code === CHAR_CR;
-	}
-	skipUntil(target) {
-		const pos = this.findString(target);
-		if (pos !== -1) this.pos = pos;
-		else this.pos = this.length;
-	}
-	current() {
-		return this.xml[this.pos];
-	}
-	currentCharCode() {
-		return this.xml.charCodeAt(this.pos);
-	}
-	/**
-	* Checks if the string at the given position matches the target string.
-	* This avoids creating substring instances for comparison.
-	* @param str - The target string to match
-	* @param pos - The position to check from (default: current position)
-	*/
-	matches(str, pos = this.pos) {
-		const len = str.length;
-		if (pos + len > this.length) return false;
-		for (let i = 0; i < len; i++) if (this.xml.charCodeAt(pos + i) !== str.charCodeAt(i)) return false;
-		return true;
-	}
-	/**
-	* Finds the position of a target string starting from the given position.
-	* @param str - The string to find
-	* @param startPos - Starting position (default: current position)
-	* @returns The position where the string is found, or -1 if not found
-	*/
-	findString(str, startPos = this.pos) {
-		const maxPos = this.length - str.length;
-		for (let pos = startPos; pos <= maxPos; pos++) if (this.matches(str, pos)) return pos;
-		return -1;
+		return attrs;
 	}
 };
 //#endregion
@@ -933,7 +943,6 @@ function parseColumnInfo(columnInfoElement, dataset) {
 	}
 }
 function parseRows(rowsElement, dataset) {
-	if (typeof rowsElement === "string") return;
 	const rows = rowsElement?.children;
 	if (!rows) return;
 	const datasetRows = dataset.rows;
@@ -984,8 +993,6 @@ function parseRows(rowsElement, dataset) {
 	}
 }
 function parseParameters(parametersElement, xapiRoot) {
-	if (typeof parametersElement === "string") return;
-	if (!parametersElement) return;
 	const children = parametersElement.children;
 	if (!children) return;
 	for (let i = 0; i < children.length; i++) {
@@ -1020,19 +1027,17 @@ function write(root) {
 	return builder.toString();
 }
 function writeParameters(builder, parameters) {
-	if (parameters) {
-		builder.writeStartElement("Parameters");
-		for (const parameter of parameters) {
-			const attrs = { id: parameter.id };
-			if (parameter.type !== void 0) attrs.type = parameter.type;
-			if (parameter.value !== void 0) if (typeof parameter.value === "string") attrs.value = parameter.value;
-			else if (parameter.value instanceof Date) attrs.value = dateToString(parameter.value, parameter.type);
-			else if (parameter.value instanceof Uint8Array) attrs.value = uint8ArrayToBase64(parameter.value);
-			else attrs.value = String(parameter.value);
-			builder.writeStartElement("Parameter", attrs, true);
-		}
-		builder.writeEndElement("Parameters");
-	}
+	builder.writeStartElement("Parameters");
+	for (const parameter of parameters) {
+		const attrs = { id: parameter.id };
+		if (parameter.type !== void 0) attrs.type = parameter.type;
+		if (parameter.value !== void 0) if (typeof parameter.value === "string") attrs.value = parameter.value;
+		else if (parameter.value instanceof Date) attrs.value = dateToString(parameter.value, parameter.type);
+		else if (parameter.value instanceof Uint8Array) attrs.value = uint8ArrayToBase64(parameter.value);
+		else attrs.value = String(parameter.value);
+		builder.writeStartElement("Parameter", attrs, true);
+	}
+	builder.writeEndElement("Parameters");
 }
 function writeDataset(builder, dataset) {
 	builder.writeStartElement("Dataset", { id: dataset.id });
@@ -1146,7 +1151,12 @@ function encodeRoot(schema, value) {
 		const rows = value.datasets[datasetId];
 		for (const row of rows) {
 			const rowIndex = dataset.newRow();
+			dataset.rows[rowIndex].type = row.$rowType;
 			for (const id of Object.keys(datasetSchema.columns)) dataset.setColumn(rowIndex, id, row[id]);
+			if (row.$orgRow) dataset.rows[rowIndex].orgRow = Object.entries(row.$orgRow).map(([id, value]) => ({
+				id,
+				value
+			}));
 		}
 		root.addDataset(dataset);
 	}
@@ -1169,6 +1179,8 @@ function decodeRoot(schema, root) {
 		datasets[datasetId] = dataset.getRows().map((row) => {
 			const value = { ...constants };
 			for (const column of row.cols) if (column.id in datasetSchema.columns) value[column.id] = column.value;
+			if (row.type) value.$rowType = row.type;
+			if (row.orgRow) value.$orgRow = Object.fromEntries(row.orgRow.map((column) => [column.id, column.value]));
 			return value;
 		});
 	}
@@ -1178,4 +1190,128 @@ function decodeRoot(schema, root) {
 	};
 }
 //#endregion
-export { ColumnTypeError, Dataset, InvalidXmlError, NexaVersion, StringWritableStream, XapiRoot, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, parse, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, xapi };
+//#region src/codec.ts
+const rowTypes = {
+	N: void 0,
+	I: "insert",
+	U: "update",
+	D: "delete",
+	O: void 0
+};
+function sizeOf(size, type) {
+	if (size !== void 0) return Number(size);
+	return type === "STRING" ? 255 : 0;
+}
+function jsonValue(value, type) {
+	if (value === null || value === void 0) return void 0;
+	if (type === "DATE" || type === "DATETIME" || type === "TIME") return typeof value === "string" ? convertToColumnType(value, type) : value;
+	if (type === "BLOB" && typeof value === "string") return convertToColumnType(value, type);
+	return value;
+}
+function jsonWireValue(value, type) {
+	if (value === void 0) return void 0;
+	if (value instanceof Date) return dateToString(value, type);
+	if (value instanceof Uint8Array) return uint8ArrayToBase64(value);
+	return value;
+}
+function columnsToObject(columns) {
+	return Object.fromEntries(columns.map((column) => [column.id, column.value]));
+}
+function readRow(dataset, row) {
+	const rowType = rowTypes[row._RowType_ ?? "N"];
+	if (row._RowType_ === "O") {
+		const previous = dataset.rows[dataset.rows.length - 1];
+		if (previous?.type !== "update") return;
+		previous.orgRow = dataset.getColumns().filter((column) => Object.prototype.hasOwnProperty.call(row, column.id)).map((column) => ({
+			id: column.id,
+			value: jsonValue(row[column.id], column.type)
+		}));
+		return;
+	}
+	const index = dataset.newRow();
+	dataset.rows[index].type = rowType;
+	for (const column of dataset.getColumns()) if (Object.prototype.hasOwnProperty.call(row, column.id)) dataset.rows[index].cols.push({
+		id: column.id,
+		value: jsonValue(row[column.id], column.type)
+	});
+}
+function readJson(value) {
+	const root = new XapiRoot();
+	for (const parameter of value.Parameters ?? []) root.addParameter({
+		id: parameter.id,
+		type: parameter.type,
+		value: jsonValue(parameter.value, parameter.type)
+	});
+	for (const source of value.Datasets ?? []) {
+		const dataset = new Dataset(source.id);
+		for (const column of source.ColumnInfo.ConstColumn ?? []) {
+			const type = column.type ?? "STRING";
+			dataset.addConstColumn({
+				id: column.id,
+				type,
+				size: sizeOf(column.size, type),
+				value: jsonValue(column.value, type)
+			});
+		}
+		for (const column of source.ColumnInfo.Column) {
+			const type = column.type ?? "STRING";
+			dataset.addColumn({
+				id: column.id,
+				type,
+				size: sizeOf(column.size, type)
+			});
+		}
+		for (const row of source.Rows) readRow(dataset, row);
+		root.addDataset(dataset);
+	}
+	return root;
+}
+function writeJson(root) {
+	return {
+		version: "1.0",
+		...root.parameterSize() ? { Parameters: root.getParameters().map((parameter) => ({
+			id: parameter.id,
+			...parameter.type ? { type: parameter.type } : {},
+			...parameter.value !== void 0 ? { value: jsonWireValue(parameter.value, parameter.type ?? "STRING") } : {}
+		})) } : {},
+		...root.datasetSize() ? { Datasets: root.getDatasets().map((dataset) => ({
+			id: dataset.id,
+			ColumnInfo: {
+				...dataset.constColumnSize() ? { ConstColumn: dataset.getConstColumns().map((column) => ({
+					id: column.id,
+					type: column.type,
+					size: column.size,
+					value: jsonWireValue(column.value, column.type)
+				})) } : {},
+				Column: dataset.getColumns().map((column) => ({
+					id: column.id,
+					type: column.type,
+					size: column.size
+				}))
+			},
+			Rows: dataset.getRows().flatMap((row) => {
+				const current = {
+					_RowType_: row.type === "insert" ? "I" : row.type === "update" ? "U" : row.type === "delete" ? "D" : "N",
+					...columnsToObject(row.cols)
+				};
+				if (!row.orgRow) return [current];
+				return [current, {
+					_RowType_: "O",
+					...columnsToObject(row.orgRow)
+				}];
+			})
+		})) } : {}
+	};
+}
+const nexacroJsonCodec = {
+	serialize: writeJson,
+	deserialize: readJson
+};
+function parseJson(value) {
+	return nexacroJsonCodec.deserialize(JSON.parse(value));
+}
+function writeJsonString(root) {
+	return JSON.stringify(nexacroJsonCodec.serialize(root));
+}
+//#endregion
+export { ColumnTypeError, Dataset, InvalidXmlError, NexaVersion, StringWritableStream, XapiRoot, XmlStringBuilder, XplatformVersion, _unescapeXml, arrayBufferToString, base64ToUint8Array, columnType, convertToColumnType, convertToString, dateToString, decodeRoot, defineDataset, defineOperation, defineRoot, encodeControlChars, encodeRoot, escapeXml, initXapi, isXapiRoot, makeParseEntities, nexacroJsonCodec, parse, parseJson, parseXml, rowType, stringToDate, stringToReadableStream, uint8ArrayToBase64, write, writeJsonString, xapi };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xapi-js/core",
   "type": "module",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",