abra-flexi 0.5.6 → 0.6.0

package/dist/index.cjs

@@ -96,7 +96,7 @@ function parsePropertyValue(propertyType, annot, obj) {
 			return new Date(parseInt(s[0], parseInt(s[1]) - 1));
 		case PropertyType.Numeric: return new big_js.Big(obj).round(annot?.decimals ?? 2);
 		case PropertyType.Logic: return obj.toLowerCase() === "true";
-		case PropertyType.Blob: return Buffer.from(obj, "base64");
+		case PropertyType.Blob: return base64ToBytes(obj);
 		case PropertyType.Array:
 			if (!annot?.itemType) throw new AFError(AFErrorCode.ITEM_TYPE_MISSING, "itemType is required for Array");
 			const myAnnot = { ...annot };
@@ -121,7 +121,7 @@ function serializePropertyValue(propertyType, annot, val) {
 			if (val instanceof big_js.Big) return val.toString();
 			return val;
 		case PropertyType.Logic: return !!val ? "true" : "false";
-		case PropertyType.Blob: return val.toString("base64");
+		case PropertyType.Blob: return bytesToBase64(val);
 		case PropertyType.Array:
 			if (!annot?.itemType) throw new AFError(AFErrorCode.ITEM_TYPE_MISSING, "itemType is required for Array");
 			const myAnnot = { ...annot };
@@ -146,6 +146,22 @@ function dateToLocalIso(date) {
 	const offset = -date.getTimezoneOffset();
 	return `${yyyy}-${mm}-${dd}T${hh}:${mi}:${ss}.${ms}${offset >= 0 ? "+" : "-"}${pad(Math.floor(Math.abs(offset) / 60))}:${pad(Math.abs(offset) % 60)}`;
 }
+function base64ToBytes(base64) {
+	if (typeof Buffer !== "undefined") {
+		const buf = Buffer.from(base64, "base64");
+		return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+	}
+	const binary = atob(base64);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+function bytesToBase64(bytes) {
+	if (typeof Buffer !== "undefined") return Buffer.from(bytes).toString("base64");
+	let binary = "";
+	for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
+	return btoa(binary);
+}
 function arraysEqual(a, b) {
 	if (a === b) return true;
 	if (a.length !== b.length) return false;
@@ -170,6 +186,7 @@ var AFEntity = class AFEntity {
 	}
 	constructor(stitkyCache) {
 		this._orig = {};
+		this._isNew = true;
 		this._stitkyCache = stitkyCache;
 	}
 	getPropertyTypeAnnotation(key) {
@@ -185,7 +202,7 @@ var AFEntity = class AFEntity {
 		return !this.hasChanged();
 	}
 	get isNew() {
-		return !this.id && !this.kod;
+		return this._isNew;
 	}
 	getCotr() {
 		return this.constructor;
@@ -66562,6 +66579,29 @@ function extractEvidence(inUrl) {
 	return split[3];
 }
 
+//#endregion
+//#region src/abra/AFNestedEntityResolver.ts
+function resolveNestedEntityPathPrefix(entityPath, options) {
+	switch (entityPath) {
+		case "individualni-cenik": {
+			const sel = serializeParentSelector(options.adresarId, "adresarId", entityPath);
+			if (sel === void 0) return "";
+			return `adresar/${sel}/`;
+		}
+		default: return "";
+	}
+}
+function serializeParentSelector(value, optionName, entityPath) {
+	if (value === void 0 || value === null) return void 0;
+	if (value instanceof AFFilter) {
+		const piece = value.toUrlComponent();
+		if (!piece.length) throw new AFError(AFErrorCode.MISSING_ID, `'${optionName}' for ${entityPath} resolved to empty URL component.`);
+		return piece;
+	}
+	if (typeof value === "string" && !value.length) throw new AFError(AFErrorCode.MISSING_ID, `'${optionName}' for ${entityPath} must be a non-empty id.`);
+	return String(value);
+}
+
 //#endregion
 //#region src/abra/AFStitkyCache.ts
 const DEBOUNCE_MS = 5 * 1e3;
@@ -66580,51 +66620,61 @@ var AFStitkyCache = class {
 		if (this._strategy === StitkyCacheStrategy.None) return;
 		const now = /* @__PURE__ */ new Date();
 		if (this._lastUpdate && now.getTime() - this._lastUpdate.getTime() < DEBOUNCE_MS) return;
-		const skupOpts = {
-			limit: NO_LIMIT,
-			detail: AFQueryDetail.FULL,
-			noUpdateStitkyCache: true
-		};
-		if (this._lastUpdate) skupOpts.filter = Filter(`lastUpdate > ':date'`, { date: this._lastUpdate });
-		const skUpdate = await this._client.query(AFSkupinaStitku, skupOpts);
-		for (const sk of skUpdate) {
-			let found = this._stitekSkupiny.find((ss) => ss.id === sk.id);
-			if (!found) {
-				this._stitekSkupiny.push(sk);
-				continue;
-			}
-			Object.assign(found, sk);
-		}
-		const stitOpts = {
-			limit: NO_LIMIT,
-			detail: [
-				"id",
-				"kod",
-				"lastUpdate",
-				"nazev",
-				"nazevA",
-				"nazevB",
-				"nazevC",
-				"nazevD",
-				"poznam",
-				"popis",
-				"platiOd",
-				"platiDo",
-				"skupVybKlic"
-			],
-			noUpdateStitkyCache: true
-		};
-		if (this._lastUpdate) skupOpts.filter = Filter(`lastUpdate > ':date'`, { date: this._lastUpdate });
-		const stUpdate = await this._client.query(AFStitek, stitOpts);
-		for (const st of stUpdate) {
-			st.skupVybKlic = this._stitekSkupiny.find((ss) => ss.kod === st.skupVybKlic?.kod);
-			const found = this._stitky.find((s) => s.id === st.id);
-			if (!found) {
-				this._stitky.push(st);
-				continue;
+		if (this._inflight) return this._inflight;
+		this._inflight = (async () => {
+			try {
+				const sinceTs = this._lastUpdate ? formatAbraTimestamp(this._lastUpdate) : void 0;
+				const skupOpts = {
+					limit: NO_LIMIT,
+					detail: AFQueryDetail.FULL,
+					noUpdateStitkyCache: true
+				};
+				if (sinceTs) skupOpts.filter = Filter(`lastUpdate > :date`, { date: sinceTs });
+				const skUpdate = await this._client.query(AFSkupinaStitku, skupOpts);
+				for (const sk of skUpdate) {
+					let found = this._stitekSkupiny.find((ss) => ss.id === sk.id);
+					if (!found) {
+						this._stitekSkupiny.push(sk);
+						continue;
+					}
+					Object.assign(found, sk);
+				}
+				const stitOpts = {
+					limit: NO_LIMIT,
+					detail: [
+						"id",
+						"kod",
+						"lastUpdate",
+						"nazev",
+						"nazevA",
+						"nazevB",
+						"nazevC",
+						"nazevD",
+						"poznam",
+						"popis",
+						"platiOd",
+						"platiDo",
+						"skupVybKlic"
+					],
+					noUpdateStitkyCache: true
+				};
+				if (sinceTs) stitOpts.filter = Filter(`lastUpdate > :date`, { date: sinceTs });
+				const stUpdate = await this._client.query(AFStitek, stitOpts);
+				for (const st of stUpdate) {
+					st.skupVybKlic = this._stitekSkupiny.find((ss) => ss.kod === st.skupVybKlic?.kod);
+					const found = this._stitky.find((s) => s.id === st.id);
+					if (!found) {
+						this._stitky.push(st);
+						continue;
+					}
+					Object.assign(found, st);
+				}
+				this._lastUpdate = now;
+			} finally {
+				this._inflight = void 0;
 			}
-			Object.assign(found, st);
-		}
+		})();
+		return this._inflight;
 	}
 	stitkyWithString(keys, groupFilter) {
 		if (!keys) return void 0;
@@ -66644,15 +66694,27 @@ var AFStitkyCache = class {
 		return list;
 	}
 };
+function formatAbraTimestamp(d) {
+	const pad = (n) => String(n).padStart(2, "0");
+	return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
 
 //#endregion
 //#region src/abra/AFApiClient.ts
 const ABRA_API_FORMAT = "json";
+const LOG_LEVEL_RANK = {
+	none: 0,
+	error: 1,
+	warn: 2,
+	info: 3,
+	debug: 4
+};
 var AFApiClient = class {
 	constructor(config) {
 		this._url = config.url;
 		this._company = config.company;
 		this._fetch = config.fetch || fetch;
+		this._logger = makeFilteringLogger(config.logger ?? console, config.logLevel ?? (config.logger ? "debug" : "none"));
 		this._stitkyCache = new AFStitkyCache(this, config.stitkyCacheStrategy);
 	}
 	get url() {
@@ -66664,14 +66726,14 @@ var AFApiClient = class {
 	get stitkyCacheStrategy() {
 		return this._stitkyCache.strategy;
 	}
-	async queryRaw(entityPath, options) {
-		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
+	_buildQueryUrl(entityPath, format, options) {
 		const detail = options.detail || AFQueryDetail.SUMMARY;
 		let furl = options.filter?.toUrlComponent();
 		if (furl && !furl.length) furl = void 0;
-		let url = this._url + "/c/" + this.company + "/" + (options.entityPathPrefix ?? "") + entityPath;
+		const pathPrefix = resolveNestedEntityPathPrefix(entityPath, options);
+		let url = this._url + "/c/" + this.company + "/" + pathPrefix + entityPath;
 		url += furl ? "/" + furl : "";
-		url += "." + ABRA_API_FORMAT;
+		url += "." + format;
 		url = addParamToUrl(url, "detail", composeDetail(detail));
 		url = addParamToUrl(url, "includes", composeIncludes(detail, entityPath));
 		url = addParamToUrl(url, "relations", composeRelations(detail));
@@ -66690,20 +66752,61 @@ var AFApiClient = class {
 		url = addParamToUrl(url, "pocetMesicu", options.pocetMesicu);
 		url = addParamToUrl(url, "date", options.date);
 		url = addParamToUrl(url, "currency", options.currency);
-		console.log(url);
+		return url;
+	}
+	async queryRaw(entityPath, options = {}) {
+		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
+		const url = this._buildQueryUrl(entityPath, ABRA_API_FORMAT, options);
+		this._logger.debug(url);
 		try {
 			const raw$1 = await this._fetch(url, { signal: options.abortController?.signal });
-			if (raw$1.status >= 400 && raw$1.status < 600) throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}`);
-			return (await raw$1.json()).winstrom[entityPath];
+			const json = await raw$1.json().catch(() => null);
+			if (raw$1.status >= 400 && raw$1.status < 600) {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}${details ? ` — ${details}` : ""}`);
+			}
+			return json?.winstrom?.[entityPath];
+		} catch (e) {
+			if (!(e instanceof AFError)) {
+				this._logger.error(e);
+				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
+			}
+			throw e;
+		}
+	}
+	async queryFileRaw(entityPath, format, options = {}) {
+		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
+		let url = this._buildQueryUrl(entityPath, format, options);
+		url = addParamToUrl(url, "report-name", options.reportName);
+		url = addParamToUrl(url, "report-lang", options.reportLang);
+		this._logger.debug(url);
+		try {
+			const raw$1 = await this._fetch(url, { signal: options.abortController?.signal });
+			if (raw$1.status >= 400 && raw$1.status < 600) {
+				let details = "";
+				if ((raw$1.headers.get("content-type") || "").includes("application/json")) {
+					const json = await raw$1.json().catch(() => null);
+					details = this._extractAbraErrors(json);
+				}
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}${details ? ` — ${details}` : ""}`);
+			}
+			return {
+				blob: await raw$1.blob(),
+				contentType: raw$1.headers.get("content-type") || "application/octet-stream",
+				filename: parseContentDispositionFilename(raw$1.headers.get("content-disposition"))
+			};
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
-	async query(entity, options) {
+	async queryFile(entity, format, options = {}) {
+		return this.queryFileRaw(entity.EntityPath, format, options);
+	}
+	async query(entity, options = {}) {
 		const res = this.queryRaw(entity.EntityPath, options);
 		try {
 			const rawData = await res;
@@ -66712,7 +66815,7 @@ var AFApiClient = class {
 			return data;
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
@@ -66759,7 +66862,7 @@ var AFApiClient = class {
 					out.push(res);
 				} catch (e) {
 					if (!(e instanceof AFError)) {
-						console.log(e);
+						this._logger.error(e);
 						e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 					}
 					throw e;
@@ -66770,7 +66873,7 @@ var AFApiClient = class {
 		if (!options.noUpdateStitkyCache) await this._stitkyCache.fetchTick();
 		return out;
 	}
-	async populate(entities, options) {
+	async populate(entities, options = {}) {
 		const fetchBy = [];
 		for (const en of entities) {
 			if (typeof en.id !== "undefined" && en.id !== null) {
@@ -66809,18 +66912,19 @@ var AFApiClient = class {
 				if (!en) continue;
 				const oKeys = Object.keys(enQ);
 				for (const okey of oKeys) this._decodeProperty(en, okey, enQ);
+				en._isNew = false;
 			}
 			if (!options.noUpdateStitkyCache) await this._stitkyCache.fetchTick();
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 		return entities;
 	}
-	async populateOne(entity, options) {
+	async populateOne(entity, options = {}) {
 		const res = await this.populate([entity], options);
 		if (!res || !res.length) throw new AFError(AFErrorCode.OBJECT_NOT_FOUND, `${entity} object not found. Kod / ID: ${entity.kod} / ${entity.id}`);
 		return res[0];
@@ -66833,14 +66937,15 @@ var AFApiClient = class {
 		const ent = new entity(this._stitkyCache);
 		if (id.id) ent.id = id.id;
 		if (id.kod) ent.kod = id.kod;
+		ent._isNew = false;
 		return ent;
 	}
 	async saveRaw(entityPath, data, options) {
 		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
 		if (!options) options = {};
 		let url = this._url + "/c/" + this.company + "/" + entityPath + ".json";
-		console.log(url);
-		console.log(data);
+		this._logger.debug(url);
+		this._logger.debug(data);
 		if (options.removeStitky) data["stitky@removeAll"] = "true";
 		try {
 			const raw$1 = await this._fetch(url, {
@@ -66849,98 +66954,189 @@ var AFApiClient = class {
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify({ winstrom: [{ [entityPath]: data }] })
 			});
+			const json = await raw$1.json().catch(() => null);
+			this._logger.debug(json);
 			if (raw$1.status >= 400 && raw$1.status < 600) {
-				console.log(JSON.stringify(await raw$1.json(), null, "\n"));
-				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}`);
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}${details ? ` — ${details}` : ""}`);
 			}
-			const json = await raw$1.json();
-			console.log(JSON.stringify(json));
-			if (json.winstrom["success"] === "true") {}
+			const jres = json?.winstrom;
+			if (jres && jres["success"] === "false") {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `Save of ${entityPath} failed${details ? ` — ${details}` : ""}`);
+			}
+			return Array.isArray(jres?.results) ? jres.results : [];
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
 	async save(entity, options) {
+		if (entity.isNew) {
+			const uvs = entity["uzivatelske-vazby"];
+			if (Array.isArray(uvs) && uvs.length > 0) throw new AFError(AFErrorCode.FORBIDDEN_OPERATION, `Creating ${entity.constructor.EntityName} with 'uzivatelske-vazby' is not supported by the API. Workaround: save the entity first without user relations, then add them in a second update (save) request.`);
+		}
 		const obj = this._encodeEntity(entity);
 		const res = this.saveRaw(entity.constructor.EntityPath, obj, options);
 		try {
-			await res;
+			const results = await res;
+			this._applySaveResultToEntity(entity, results);
+			entity._isNew = false;
 			return entity;
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
-	async deleteRaw(entityPath, id, options) {
+	async deleteRaw(entityPath, id, options = {}) {
 		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
 		if (!id && typeof id !== "number" || id === "") throw new AFError(AFErrorCode.MISSING_ID, `Can't delete entity without knowing it's id.`);
-		let url = this._url + "/c/" + this.company + "/" + entityPath + "/" + id + ".json";
-		console.log(url);
-		try {
-			const raw$1 = await this._fetch(url, {
+		let url;
+		let fetchOptions;
+		if (options.asUserRelation) {
+			url = this._url + "/c/" + this.company + "/" + entityPath + ".json";
+			fetchOptions = {
+				signal: options.abortController?.signal,
+				method: "PUT",
+				body: JSON.stringify({ winstrom: [{
+					[entityPath]: { id },
+					[entityPath + "@action"]: "delete"
+				}] })
+			};
+		} else {
+			url = this._url + "/c/" + this.company + "/" + entityPath + "/" + id + ".json";
+			fetchOptions = {
 				signal: options.abortController?.signal,
 				method: "DELETE"
-			});
-			if (raw$1.status >= 400 && raw$1.status < 600) throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}`);
-			const json = await raw$1.json();
-			console.log(json);
-			if (json.winstrom["success"] === "true") {}
+			};
+		}
+		this._logger.debug(url);
+		try {
+			const raw$1 = await this._fetch(url, fetchOptions);
+			const json = await raw$1.json().catch(() => null);
+			this._logger.debug(json);
+			if (raw$1.status >= 400 && raw$1.status < 600) {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}${details ? ` — ${details}` : ""}`);
+			}
+			const jres = json?.winstrom;
+			if (jres && jres["success"] === "false") {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `Delete of ${entityPath} failed${details ? ` — ${details}` : ""}`);
+			}
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
-	async delete(entity, options) {
+	async delete(entity, options = {}) {
 		if (entity.isNew) return true;
-		const res = this.deleteRaw(entity.constructor.EntityPath, entity.id, options);
+		const entityPath = entity.constructor.EntityPath;
+		const res = this.deleteRaw(entityPath, entity.id, {
+			...options,
+			asUserRelation: entity instanceof AFUzivatelskaVazba
+		});
 		try {
 			await res;
 			return true;
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
-	async deleteUserRelation(entity, options) {
+	async callEntityActionRaw(entityPath, id, actionName, options = {}) {
 		if (!this.company || !this.company.length) throw new AFError(AFErrorCode.MISSING_ABRA_COMPANY, `Can't query AFApiClient without providing company path component first.`);
-		const id = entity?.id;
-		if (!id && typeof id !== "number") throw new AFError(AFErrorCode.MISSING_ID, `Can't delete entity without knowing it's id.`);
-		const entityPath = entity.constructor.EntityPath;
-		let url = this._url + "/c/" + this.company + "/" + entityPath + ".json";
+		if (id === void 0 || id === null || id === "") throw new AFError(AFErrorCode.MISSING_ID, `Can't call action '${actionName}' on ${entityPath} without id.`);
+		if (!actionName || !actionName.length) throw new AFError(AFErrorCode.UNKNOWN, `Action name must be a non-empty string.`);
+		const url = this._url + "/c/" + this.company + "/" + entityPath + ".json";
+		this._logger.debug(url);
 		try {
 			const raw$1 = await this._fetch(url, {
 				signal: options.abortController?.signal,
 				method: "PUT",
+				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify({ winstrom: [{
 					[entityPath]: { id },
-					[entityPath + "@action"]: "delete"
+					[entityPath + "@action"]: actionName
 				}] })
 			});
-			if (raw$1.status >= 400 && raw$1.status < 600) throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}`);
-			const json = await raw$1.json();
-			console.log(json);
-			if (json.winstrom["success"] === "true") {}
+			const json = await raw$1.json().catch(() => null);
+			this._logger.debug(json);
+			if (raw$1.status >= 400 && raw$1.status < 600) {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `${raw$1.status} ${raw$1.statusText}${details ? ` — ${details}` : ""}`);
+			}
+			const jres = json?.winstrom;
+			if (jres && jres["success"] === "false") {
+				const details = this._extractAbraErrors(json);
+				throw new AFError(AFErrorCode.ABRA_FLEXI_ERROR, `Action '${actionName}' on ${entityPath} failed${details ? ` — ${details}` : ""}`);
+			}
+			return true;
 		} catch (e) {
 			if (!(e instanceof AFError)) {
-				console.log(e);
+				this._logger.error(e);
 				e = new AFError(AFErrorCode.UNKNOWN, e.toString());
 			}
 			throw e;
 		}
 	}
+	async callEntityAction(entity, actionName, options = {}) {
+		if (entity.isNew) throw new AFError(AFErrorCode.RELATED_INSTANCE_NOT_SAVED, `Can't call action '${actionName}' on an unsaved ${entity.constructor.EntityName}. Save it first.`);
+		if (entity.id === void 0 || entity.id === null) throw new AFError(AFErrorCode.MISSING_ID, `Can't call action '${actionName}' on ${entity.constructor.EntityName} without id.`);
+		const entityPath = entity.constructor.EntityPath;
+		return this.callEntityActionRaw(entityPath, entity.id, actionName, options);
+	}
+	_applySaveResultToEntity(entity, results) {
+		if (!Array.isArray(results) || !results.length) return;
+		const entityPath = entity.constructor.EntityPath;
+		let r = results.find((res) => res && typeof res.ref === "string" && res.ref.includes(`/${entityPath}/`));
+		if (!r) {
+			const refless = results.filter((res) => res && typeof res.ref !== "string");
+			if (refless.length === 1 && results.length === 1) r = refless[0];
+		}
+		if (!r || r.id === void 0 || r.id === null) return;
+		const newId = typeof r.id === "number" ? r.id : Number(r.id);
+		if (Number.isFinite(newId)) {
+			entity.id = newId;
+			entity._orig.id = newId;
+		}
+	}
+	_extractAbraErrors(json) {
+		if (!json) return "";
+		const winstrom = json.winstrom;
+		if (!winstrom) return "";
+		const messages = [];
+		if (typeof winstrom.message === "string" && winstrom.message.length) messages.push(winstrom.message);
+		const results = winstrom.results;
+		if (Array.isArray(results)) for (const r of results) {
+			if (!r || !Array.isArray(r.errors)) continue;
+			for (const err of r.errors) {
+				if (!err) continue;
+				if (typeof err === "string") {
+					messages.push(err);
+					continue;
+				}
+				const parts = [];
+				if (err.code) parts.push(`[${err.code}]`);
+				if (err.for) parts.push(`(${err.for})`);
+				if (err.message) parts.push(err.message);
+				if (parts.length) messages.push(parts.join(" "));
+			}
+		}
+		return messages.join("; ");
+	}
 	_decodeEntityObj(entity, obj) {
 		if (!obj) return [];
 		if (typeof obj === "string") {
@@ -66952,6 +67148,7 @@ var AFApiClient = class {
 			const ent = new entity(this._stitkyCache);
 			const oKeys = Object.keys(o);
 			for (const okey of oKeys) this._decodeProperty(ent, okey, o);
+			ent._isNew = false;
 			res.push(ent);
 		}
 		return res;
@@ -67008,7 +67205,7 @@ var AFApiClient = class {
 				return;
 			}
 			if (!(val instanceof AFEntity)) throw new AFError(AFErrorCode.UNKNOWN, `Key '${key}' on ${entity.constructor.EntityName}(id: ${entity.id}) referencing not AFEntity instance`);
-			if (val.isNew) throw new AFError(AFErrorCode.RELATED_INSTANCE_NOT_SAVED, `Key '${key}' on ${entity.constructor.EntityName}(id: ${entity.id}) referencing not saved (new) instance - missing 'id' in it`);
+			if (val.isNew) throw new AFError(AFErrorCode.RELATED_INSTANCE_NOT_SAVED, `Key '${key}' on ${entity.constructor.EntityName}(id: ${entity.id}) references an unsaved instance. Save it first, or use createIdStub() to reference an existing entity by id/kod.`);
 			if (typeof val.id === "undefined") obj[key] = `code:${val.kod}`;
 			else obj[key] = val.id;
 			return;
@@ -67018,6 +67215,28 @@ var AFApiClient = class {
 		if (entity instanceof AFPriloha && key === "content") obj["content@encoding"] = "base64";
 	}
 };
+function makeFilteringLogger(target, level) {
+	const threshold = LOG_LEVEL_RANK[level];
+	const make = (lvl) => {
+		if (LOG_LEVEL_RANK[lvl] > threshold) return () => {};
+		return (...args) => target[lvl](...args);
+	};
+	return {
+		debug: make("debug"),
+		info: make("info"),
+		warn: make("warn"),
+		error: make("error")
+	};
+}
+function parseContentDispositionFilename(header) {
+	if (!header) return void 0;
+	const ext = /filename\*=(?:UTF-8'')?([^;]+)/i.exec(header);
+	if (ext) try {
+		return decodeURIComponent(ext[1].trim().replace(/^"|"$/g, ""));
+	} catch {}
+	const plain = /filename=("([^"]+)"|([^;]+))/i.exec(header);
+	if (plain) return (plain[2] ?? plain[3] ?? "").trim();
+}
 
 //#endregion
 //#region src/abra/AFApiSession.ts