@localess/cli 3.0.7-dev.20260512203425 → 3.0.7-dev.20260514085047

package/dist/index.mjs

@@ -6,8 +6,9 @@ import { join as c, parse as l } from "node:path";
 import * as u from "node:process";
 import d from "node:process";
 import { z as f } from "zod";
+import p from "chalk";
 //#region src/cache.ts
-var p = class {
+var ee = class {
 	set(e, t) {}
 	get(e) {}
 	has(e) {
@@ -37,22 +38,22 @@ var p = class {
 	has(e) {
 		return this.get(e) !== void 0;
 	}
-}, h = "\x1B[0m", g = "\x1B[34m";
-function _(e) {
+}, te = "\x1B[0m", ne = "\x1B[34m";
+function h(e) {
 	return Object.keys(e).sort().reduce((t, n) => {
 		let r = e[n];
-		return t[n] = typeof r == "object" && r && !Array.isArray(r) ? _(r) : r, t;
+		return t[n] = typeof r == "object" && r && !Array.isArray(r) ? h(r) : r, t;
 	}, {});
 }
-function v(e, t = "") {
+function g(e, t = "") {
 	let n = {};
 	for (let [r, i] of Object.entries(e)) {
 		let e = t ? `${t}.${r}` : r;
-		typeof i == "object" && i && !Array.isArray(i) ? Object.assign(n, v(i, e)) : n[e] = String(i);
+		typeof i == "object" && i && !Array.isArray(i) ? Object.assign(n, g(i, e)) : n[e] = String(i);
 	}
 	return n;
 }
-function y(e) {
+function _(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) {
 		let e = n.split("."), i = t;
@@ -62,23 +63,23 @@ function y(e) {
 }
 //#endregion
 //#region src/client.ts
-var b = `${g}[Localess:Client]${h}`;
-async function x(e, t, n = 3, r = 500, i) {
+var v = `${ne}[Localess:Client]${te}`;
+async function y(e, t, n = 3, r = 500, i) {
 	let a = 0, o;
 	for (; a <= n;) {
 		try {
 			let n = await fetch(e, t);
-			if (!n.ok && n.status >= 500) i && console.log(b, `fetchWithRetry: HTTP ${n.status} on attempt ${a + 1}`), o = /* @__PURE__ */ Error(`HTTP ${n.status}`);
+			if (!n.ok && n.status >= 500) i && console.log(v, `fetchWithRetry: HTTP ${n.status} on attempt ${a + 1}`), o = /* @__PURE__ */ Error(`HTTP ${n.status}`);
 			else return n;
 		} catch (e) {
-			i && console.log(b, `fetchWithRetry: network error on attempt ${a + 1}`, e), o = e;
+			i && console.log(v, `fetchWithRetry: network error on attempt ${a + 1}`, e), o = e;
 		}
 		a++, a <= n && await new Promise((e) => setTimeout(e, r));
 	}
 	throw o;
 }
-function S(e) {
-	e.debug && console.log(b, "Client Options : ", e);
+function b(e) {
+	e.debug && console.log(v, "Client Options : ", e);
 	let t = e.origin.replace(/\/+$/, ""), n = {
 		redirect: "follow",
 		headers: {
@@ -87,23 +88,23 @@ function S(e) {
 			"X-Localess-Agent": "Localess-CLI-Client",
 			"X-Localess-Agent-Version": "0.9.0"
 		}
-	}, r = typeof e.cacheTTL == "number" ? e.cacheTTL * 1e3 : void 0, i = e.cacheTTL === !1 ? new p() : new m(r);
+	}, r = typeof e.cacheTTL == "number" ? e.cacheTTL * 1e3 : void 0, i = e.cacheTTL === !1 ? new ee() : new m(r);
 	return {
 		async getSpace() {
-			e.debug && console.log(b, "getSpace()");
+			e.debug && console.log(v, "getSpace()");
 			let r = `${t}/api/v1/spaces/${e.spaceId}?token=${e.token}`;
-			if (e.debug && console.log(b, "getSpace fetch url : ", r), i.has(r)) return e.debug && console.log(b, "getSpace cache hit"), i.get(r);
+			if (e.debug && console.log(v, "getSpace fetch url : ", r), i.has(r)) return e.debug && console.log(v, "getSpace cache hit"), i.get(r);
 			try {
-				let t = await x(r, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getSpace status : ", t.status);
+				let t = await y(r, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getSpace status : ", t.status);
 				let a = await t.json();
 				return i.set(r, a), a;
 			} catch (e) {
-				return console.error(b, "getSpace error : ", e), {};
+				return console.error(v, "getSpace error : ", e), {};
 			}
 		},
 		async getLinks(r) {
-			e.debug && console.log(b, "getLinks() params : ", JSON.stringify(r));
+			e.debug && console.log(v, "getLinks() params : ", JSON.stringify(r));
 			let a = "";
 			r?.kind && (a = `&kind=${r.kind}`);
 			let o = "";
@@ -111,72 +112,72 @@ function S(e) {
 			let s = "";
 			r?.excludeChildren && (s = `&excludeChildren=${r.excludeChildren}`);
 			let c = `${t}/api/v1/spaces/${e.spaceId}/links?token=${e.token}${a}${o}${s}`;
-			if (e.debug && console.log(b, "getLinks fetch url : ", c), i.has(c)) return e.debug && console.log(b, "getLinks cache hit"), i.get(c);
+			if (e.debug && console.log(v, "getLinks fetch url : ", c), i.has(c)) return e.debug && console.log(v, "getLinks cache hit"), i.get(c);
 			try {
-				let t = await x(c, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getLinks status : ", t.status);
+				let t = await y(c, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getLinks status : ", t.status);
 				let r = await t.json();
 				return i.set(c, r), r;
 			} catch (e) {
-				return console.error(b, "getLinks error : ", e), {};
+				return console.error(v, "getLinks error : ", e), {};
 			}
 		},
 		async getContentBySlug(r, a) {
-			e.debug && (console.log(b, "getContentBySlug() slug : ", r), console.log(b, "getContentBySlug() params : ", JSON.stringify(a)));
+			e.debug && (console.log(v, "getContentBySlug() slug : ", r), console.log(v, "getContentBySlug() params : ", JSON.stringify(a)));
 			let o = "";
 			e?.version && e.version == "draft" && (o = `&version=${e.version}`), a?.version && a.version == "draft" && (o = `&version=${a.version}`);
 			let s = a?.locale ? `&locale=${a.locale}` : "", c = a?.resolveReference ? `&resolveReference=${a.resolveReference}` : "", l = a?.resolveLink ? `&resolveLink=${a.resolveLink}` : "", u = `${t}/api/v1/spaces/${e.spaceId}/contents/slugs/${r}?token=${e.token}${o}${s}${c}${l}`;
-			if (e.debug && console.log(b, "getContentBySlug fetch url : ", u), i.has(u)) return e.debug && console.log(b, "getContentBySlug cache hit"), i.get(u);
+			if (e.debug && console.log(v, "getContentBySlug fetch url : ", u), i.has(u)) return e.debug && console.log(v, "getContentBySlug cache hit"), i.get(u);
 			try {
-				let t = await x(u, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getContentBySlug status : ", t.status);
+				let t = await y(u, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getContentBySlug status : ", t.status);
 				let r = await t.json();
 				return i.set(u, r), r;
 			} catch (e) {
-				return console.error(b, "getContentBySlug error : ", e), {};
+				return console.error(v, "getContentBySlug error : ", e), {};
 			}
 		},
 		async getContentById(r, a) {
-			e.debug && (console.log(b, "getContentById() id : ", r), console.log(b, "getContentById() params : ", JSON.stringify(a)));
+			e.debug && (console.log(v, "getContentById() id : ", r), console.log(v, "getContentById() params : ", JSON.stringify(a)));
 			let o = "";
 			e?.version && e.version == "draft" && (o = `&version=${e.version}`), a?.version && a.version == "draft" && (o = `&version=${a.version}`);
 			let s = a?.locale ? `&locale=${a.locale}` : "", c = a?.resolveReference ? `&resolveReference=${a.resolveReference}` : "", l = a?.resolveLink ? `&resolveLink=${a.resolveLink}` : "", u = `${t}/api/v1/spaces/${e.spaceId}/contents/${r}?token=${e.token}${o}${s}${c}${l}`;
-			if (e.debug && console.log(b, "getContentById fetch url : ", u), i.has(u)) return e.debug && console.log(b, "getContentById cache hit"), i.get(u);
+			if (e.debug && console.log(v, "getContentById fetch url : ", u), i.has(u)) return e.debug && console.log(v, "getContentById cache hit"), i.get(u);
 			try {
-				let t = await x(u, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getContentById status : ", t.status);
+				let t = await y(u, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getContentById status : ", t.status);
 				let r = await t.json();
 				return i.set(u, r), r;
 			} catch (e) {
-				return console.error(b, "getContentById error : ", e), {};
+				return console.error(v, "getContentById error : ", e), {};
 			}
 		},
 		async getTranslations(r, a) {
-			e.debug && (console.log(b, "getTranslations() locale : ", r), console.log(b, "getTranslations() params : ", JSON.stringify(a)));
+			e.debug && (console.log(v, "getTranslations() locale : ", r), console.log(v, "getTranslations() params : ", JSON.stringify(a)));
 			let o = "";
 			e?.version && e.version == "draft" && (o = `&version=${e.version}`), a?.version && a.version == "draft" && (o = `&version=${a.version}`);
 			let s = `${t}/api/v1/spaces/${e.spaceId}/translations/${r}?token=${e.token}${o}`;
-			if (e.debug && console.log(b, "getTranslations fetch url : ", s), i.has(s)) return e.debug && console.log(b, "getTranslations cache hit"), i.get(s);
+			if (e.debug && console.log(v, "getTranslations fetch url : ", s), i.has(s)) return e.debug && console.log(v, "getTranslations cache hit"), i.get(s);
 			try {
-				let t = await x(s, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getTranslations status : ", t.status);
+				let t = await y(s, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getTranslations status : ", t.status);
 				let r = await t.json();
 				return i.set(s, r), r;
 			} catch (e) {
-				return console.error(b, "getTranslations error : ", e), {};
+				return console.error(v, "getTranslations error : ", e), {};
 			}
 		},
 		async updateTranslations(r, i, a, o) {
-			e.debug && (console.log(b, "updateTranslations() locale : ", r), console.log(b, "updateTranslations() type : ", i), console.log(b, "updateTranslations() values : ", JSON.stringify(a)));
+			e.debug && (console.log(v, "updateTranslations() locale : ", r), console.log(v, "updateTranslations() type : ", i), console.log(v, "updateTranslations() values : ", JSON.stringify(a)));
 			let s = `${t}/api/v1/spaces/${e.spaceId}/translations/${r}`;
-			e.debug && console.log(b, "updateTranslations fetch url : ", s);
+			e.debug && console.log(v, "updateTranslations fetch url : ", s);
 			let c = {
 				type: i,
 				values: a,
 				dryRun: o
 			};
 			try {
-				let t = await x(s, {
+				let t = await y(s, {
 					method: "POST",
 					headers: {
 						"X-API-KEY": e.token,
@@ -184,35 +185,35 @@ function S(e) {
 					},
 					body: JSON.stringify(c)
 				}, e.retryCount, e.retryDelay, e.debug);
-				return e.debug && console.log(b, "updateTranslations status : ", t.status), t.json();
+				return e.debug && console.log(v, "updateTranslations status : ", t.status), t.json();
 			} catch (e) {
-				console.error(b, "updateTranslations error : ", e);
+				console.error(v, "updateTranslations error : ", e);
 			}
 		},
 		async getOpenApi() {
-			e.debug && console.log(b, "getOpenApi()");
+			e.debug && console.log(v, "getOpenApi()");
 			let r = `${t}/api/v1/spaces/${e.spaceId}/open-api?token=${e.token}`;
-			if (e.debug && console.log(b, "getOpenApi fetch url : ", r), i.has(r)) return e.debug && console.log(b, "getOpenApi cache hit"), i.get(r);
+			if (e.debug && console.log(v, "getOpenApi fetch url : ", r), i.has(r)) return e.debug && console.log(v, "getOpenApi cache hit"), i.get(r);
 			try {
-				let t = await x(r, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getOpenApi status : ", t.status);
+				let t = await y(r, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getOpenApi status : ", t.status);
 				let a = await t.json();
 				return i.set(r, a), a;
 			} catch (e) {
-				return console.error(b, "getOpenApi error : ", e), {};
+				return console.error(v, "getOpenApi error : ", e), {};
 			}
 		},
 		async getSchemas() {
-			e.debug && console.log(b, "getSchemas()");
+			e.debug && console.log(v, "getSchemas()");
 			let r = `${t}/api/v1/spaces/${e.spaceId}/schemas?token=${e.token}`;
-			if (e.debug && console.log(b, "getSchemas fetch url : ", r), i.has(r)) return e.debug && console.log(b, "getSchemas cache hit"), i.get(r);
+			if (e.debug && console.log(v, "getSchemas fetch url : ", r), i.has(r)) return e.debug && console.log(v, "getSchemas cache hit"), i.get(r);
 			try {
-				let t = await x(r, n, e.retryCount, e.retryDelay, e.debug);
-				e.debug && console.log(b, "getSchemas status : ", t.status);
+				let t = await y(r, n, e.retryCount, e.retryDelay, e.debug);
+				e.debug && console.log(v, "getSchemas status : ", t.status);
 				let a = await t.json();
 				return i.set(r, a), a;
 			} catch (e) {
-				return console.error(b, "getSchemas error : ", e), {};
+				return console.error(v, "getSchemas error : ", e), {};
 			}
 		},
 		assetLink(n) {
@@ -222,8 +223,8 @@ function S(e) {
 }
 //#endregion
 //#region src/file.ts
-var C = ".localess";
-async function w(e, t, n) {
+var x = ".localess";
+async function S(e, t, n) {
 	let r = l(e).dir;
 	try {
 		await a(r, { recursive: !0 });
@@ -234,10 +235,10 @@ async function w(e, t, n) {
 		await s(e, t, n);
 	} catch {}
 }
-async function T(e) {
+async function re(e) {
 	return o(e, "utf-8");
 }
-async function E(e, t) {
+async function ie(e, t) {
 	let n = c(e, ".gitignore"), r = "";
 	try {
 		r = await o(n, "utf-8");
@@ -246,8 +247,8 @@ async function E(e, t) {
 }
 //#endregion
 //#region src/session.ts
-var D = c(u.cwd(), C, "credentials.json");
-async function O() {
+var C = c(u.cwd(), x, "credentials.json");
+async function w() {
 	let e = { isLoggedIn: !1 }, t = u.env.LOCALESS_TOKEN, n = u.env.LOCALESS_SPACE, i = u.env.LOCALESS_ORIGIN;
 	if (t && n && i) return console.debug("Login in using environment variables."), {
 		isLoggedIn: !0,
@@ -257,8 +258,8 @@ async function O() {
 		method: "env"
 	};
 	try {
-		await r(D);
-		let t = await o(D, "utf8"), n = JSON.parse(t);
+		await r(C);
+		let t = await o(C, "utf8"), n = JSON.parse(t);
 		if (Object.keys(n).length === 0) return e;
 		if (n.origin && n.token && n.space) return console.debug("Login in using credentials file."), {
 			isLoggedIn: !0,
@@ -270,21 +271,21 @@ async function O() {
 	} catch {}
 	return e;
 }
-async function k(e) {
-	if (e.origin && e.token && e.space) await w(D, JSON.stringify(e, null, 2), { mode: 384 }), console.log("Session credentials saved to file system."), await E(u.cwd(), C), console.log(`Added '${C}' to .gitignore to prevent credentials from being committed.`);
+async function T(e) {
+	if (e.origin && e.token && e.space) await S(C, JSON.stringify(e, null, 2), { mode: 384 }), console.log("Session credentials saved to file system."), await ie(u.cwd(), x), console.log(`Added '${x}' to .gitignore to prevent credentials from being committed.`);
 	else throw Error("Cannot persist session: missing required fields.");
 }
-async function A() {
+async function E() {
 	try {
-		await r(D), await w(D, "{}", { mode: 384 });
+		await r(C), await S(C, "{}", { mode: 384 });
 	} catch {
 		throw Error("Failed to clear session credentials.");
 	}
 }
 //#endregion
 //#region src/commands/login/index.ts
-var j = new e("login").description("Login to Localess CLI").option("-o, --origin <origin>", "Origin of the Localess instance").option("-s, --space <space>", "Space ID to login to").option("-t, --token <token>", "Token to login to Localess CLI").action(async (e) => {
-	if ((await O()).isLoggedIn) {
+var D = new e("login").description("Login to Localess CLI").option("-o, --origin <origin>", "Origin of the Localess instance").option("-s, --space <space>", "Space ID to login to").option("-t, --token <token>", "Token to login to Localess CLI").action(async (e) => {
+	if ((await w()).isLoggedIn) {
 		console.log("Already logged in."), console.log("If you want to log in with different credentials, please log out first using \"localess logout\" command.");
 		return;
 	}
@@ -297,14 +298,14 @@ var j = new e("login").description("Login to Localess CLI").option("-o, --origin
 	}), a = e.token ?? await n({
 		message: "Token:",
 		mask: !0
-	}), o = S({
+	}), o = b({
 		origin: r,
 		spaceId: i,
 		token: a
 	});
 	try {
 		let e = await o.getSpace();
-		console.log(`Successfully logged in to space: ${e.name} (${e.id})`), await k({
+		console.log(`Successfully logged in to space: ${e.name} (${e.id})`), await T({
 			origin: r,
 			space: i,
 			token: a
@@ -312,9 +313,9 @@ var j = new e("login").description("Login to Localess CLI").option("-o, --origin
 	} catch {
 		console.error("Login failed");
 	}
-}), M = new e("logout").description("Logout from Localess CLI").action(async () => {
+}), ae = new e("logout").description("Logout from Localess CLI").action(async () => {
 	console.log("Logging out...");
-	let e = await O();
+	let e = await w();
 	if (!e.isLoggedIn) {
 		console.log("Not currently logged in.");
 		return;
@@ -324,71 +325,71 @@ var j = new e("login").description("Login to Localess CLI").option("-o, --origin
 		return;
 	}
 	try {
-		await A(), console.log("Successfully logged out.");
+		await E(), console.log("Successfully logged out.");
 	} catch (e) {
 		console.error("Failed to log out:", e);
 	}
-}), N = /* @__PURE__ */ function(e) {
+}), O = /* @__PURE__ */ function(e) {
 	return e.ROOT = "ROOT", e.NODE = "NODE", e.ENUM = "ENUM", e;
-}({}), P = /* @__PURE__ */ function(e) {
+}({}), k = /* @__PURE__ */ function(e) {
 	return e.TEXT = "TEXT", e.TEXTAREA = "TEXTAREA", e.RICH_TEXT = "RICH_TEXT", e.MARKDOWN = "MARKDOWN", e.NUMBER = "NUMBER", e.COLOR = "COLOR", e.DATE = "DATE", e.DATETIME = "DATETIME", e.BOOLEAN = "BOOLEAN", e.OPTION = "OPTION", e.OPTIONS = "OPTIONS", e.LINK = "LINK", e.REFERENCE = "REFERENCE", e.REFERENCES = "REFERENCES", e.ASSET = "ASSET", e.ASSETS = "ASSETS", e.SCHEMA = "SCHEMA", e.SCHEMAS = "SCHEMAS", e;
-}({}), F = /* @__PURE__ */ function(e) {
+}({}), A = /* @__PURE__ */ function(e) {
 	return e.ADD_MISSING = "add-missing", e.UPDATE_EXISTING = "update-existing", e.DELETE_MISSING = "delete-missing", e;
-}({}), I = /* @__PURE__ */ function(e) {
+}({}), j = /* @__PURE__ */ function(e) {
 	return e.FLAT = "flat", e.NESTED = "nested", e;
-}({}), L = new e("pull").argument("<locale>", "Locale to pull").description("Pull locale translations from Localess").requiredOption("-p, --path <path>", "Path where the translations file will be saved").option("-f, --format <format>", `File format. Possible values are : ${Object.values(I)}`, I.FLAT).action(async (e, t) => {
-	if (console.log("Pulling translations with arguments:", e), console.log("Pulling translations with options:", t), !Object.values(I).includes(t.format)) {
-		console.error("Invalid format provided. Possible values are :", Object.values(I));
+}({}), oe = new e("pull").argument("<locale>", "Locale to pull").description("Pull locale translations from Localess").requiredOption("-p, --path <path>", "Path where the translations file will be saved").option("-f, --format <format>", `File format. Possible values are : ${Object.values(j)}`, j.FLAT).action(async (e, t) => {
+	if (console.log("Pulling translations with arguments:", e), console.log("Pulling translations with options:", t), !Object.values(j).includes(t.format)) {
+		console.error("Invalid format provided. Possible values are :", Object.values(j));
 		return;
 	}
-	let n = await O();
+	let n = await w();
 	if (!n.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let r = S({
+	let r = b({
 		origin: n.origin,
 		spaceId: n.space,
 		token: n.token
 	});
 	console.log("Pulling translations from Localess for locale:", e);
 	let i = await r.getTranslations(e);
-	if (console.log("Saving translations in file:", t.path), t.format === I.FLAT) await w(t.path, JSON.stringify(_(i), null, 2));
-	else if (t.format === I.NESTED) {
-		let e = _(y(i));
-		await w(t.path, JSON.stringify(e, null, 2));
+	if (console.log("Saving translations in file:", t.path), t.format === j.FLAT) await S(t.path, JSON.stringify(h(i), null, 2));
+	else if (t.format === j.NESTED) {
+		let e = h(_(i));
+		await S(t.path, JSON.stringify(e, null, 2));
 	}
 	console.log("Successfully saved translations from Localess");
-}), R = f.record(f.string(), f.string()), z = f.enum([
+}), M = f.record(f.string(), f.string()), N = f.enum([
 	"add-missing",
 	"update-existing",
 	"delete-missing"
 ]);
 f.object({
-	type: z,
-	values: R
+	type: N,
+	values: M
 });
 //#endregion
 //#region src/commands/translations/push/index.ts
-var B = new e("push").argument("<locale>", "Locale to push").description("Push locale translations to Localess").requiredOption("-p, --path <path>", "Path to the translations file to push").option("-f, --format <format>", `File format. Possible values are : ${Object.values(I)}`, I.FLAT).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(F)}`, F.ADD_MISSING).option("--dry-run", "Preview changes without applying them to Localess").action(async (e, t) => {
-	if (console.log("Pushing translations with arguments:", e), console.log("Pushing translations with options:", t), !z.safeParse(t.type).success) {
-		console.error("Invalid type provided. Possible values are :", Object.values(F));
+var P = new e("push").argument("<locale>", "Locale to push").description("Push locale translations to Localess").requiredOption("-p, --path <path>", "Path to the translations file to push").option("-f, --format <format>", `File format. Possible values are : ${Object.values(j)}`, j.FLAT).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(A)}`, A.ADD_MISSING).option("--dry-run", "Preview changes without applying them to Localess").action(async (e, t) => {
+	if (console.log("Pushing translations with arguments:", e), console.log("Pushing translations with options:", t), !N.safeParse(t.type).success) {
+		console.error("Invalid type provided. Possible values are :", Object.values(A));
 		return;
 	}
-	let n = await O();
+	let n = await w();
 	if (!n.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let r = S({
+	let r = b({
 		origin: n.origin,
 		spaceId: n.space,
 		token: n.token
 	});
 	t.dryRun && console.warn("Dry run mode enabled: No changes will be made."), console.log("Reading translations file from:", t.path);
-	let i = await T(t.path), a = JSON.parse(i), o;
-	o = t.format === I.NESTED ? v(a) : a;
-	let s = R.safeParse(o);
+	let i = await re(t.path), a = JSON.parse(i), o;
+	o = t.format === j.NESTED ? g(a) : a;
+	let s = M.safeParse(o);
 	if (!s.success) {
 		console.error("Invalid translations file format:", s.error);
 		return;
@@ -396,10 +397,10 @@ var B = new e("push").argument("<locale>", "Locale to push").description("Push l
 	console.log("Pushing translations to Localess with locale:", e, "and type:", t.type);
 	let c = await r.updateTranslations(e, t.type, o, t.dryRun);
 	c ? (c.dryRun && console.log("Dry run results:"), console.log("Successfully pushed translations to Localess"), console.log("Summary:", c.message), c.ids && console.log("Updated translation IDs:", c.ids)) : console.log("Something went wrong while pushing translations to Localess");
-}), V = new e("translations").description("Manage translations").addCommand(B).addCommand(L);
+}), F = new e("translations").description("Manage translations").addCommand(P).addCommand(oe);
 //#endregion
 //#region src/commands/types/generate/generator.ts
-function H(e) {
+function I(e) {
 	return `/**
  * Generated by Localess CLI
  * Do not edit manually.
@@ -450,49 +451,49 @@ export interface ${e}ContentRichText {
 }
 `;
 }
-function U(e) {
+function L(e) {
 	return e.replace(/[-_\s]+([a-zA-Z0-9])/g, (e, t) => t.toUpperCase()).replace(/^[a-z]/, (e) => e.toUpperCase());
 }
-function W(e, t) {
+function R(e, t) {
 	switch (e.kind) {
-		case P.TEXT:
-		case P.TEXTAREA:
-		case P.MARKDOWN:
-		case P.COLOR:
-		case P.DATE:
-		case P.DATETIME: return "string";
-		case P.NUMBER: return "number";
-		case P.BOOLEAN: return "boolean";
-		case P.RICH_TEXT: return `${t}ContentRichText`;
-		case P.LINK: return `${t}ContentLink`;
-		case P.ASSET: return `${t}ContentAsset`;
-		case P.ASSETS: return `${t}ContentAsset[]`;
-		case P.REFERENCE: return `${t}ContentReference`;
-		case P.REFERENCES: return `${t}ContentReference[]`;
-		case P.OPTION: return e.source ? t + U(e.source) : "string";
-		case P.OPTIONS: return e.source ? `${t + U(e.source)}[]` : "string[]";
-		case P.SCHEMA: {
+		case k.TEXT:
+		case k.TEXTAREA:
+		case k.MARKDOWN:
+		case k.COLOR:
+		case k.DATE:
+		case k.DATETIME: return "string";
+		case k.NUMBER: return "number";
+		case k.BOOLEAN: return "boolean";
+		case k.RICH_TEXT: return `${t}ContentRichText`;
+		case k.LINK: return `${t}ContentLink`;
+		case k.ASSET: return `${t}ContentAsset`;
+		case k.ASSETS: return `${t}ContentAsset[]`;
+		case k.REFERENCE: return `${t}ContentReference`;
+		case k.REFERENCES: return `${t}ContentReference[]`;
+		case k.OPTION: return e.source ? t + L(e.source) : "string";
+		case k.OPTIONS: return e.source ? `${t + L(e.source)}[]` : "string[]";
+		case k.SCHEMA: {
 			let n = e.schemas;
 			if (!n || n.length === 0) return "unknown";
-			let r = n.map((e) => t + U(e));
+			let r = n.map((e) => t + L(e));
 			return r.length === 1 ? r[0] : r.join(" | ");
 		}
-		case P.SCHEMAS: {
+		case k.SCHEMAS: {
 			let n = e.schemas;
 			if (!n || n.length === 0) return "unknown[]";
-			let r = n.map((e) => t + U(e));
+			let r = n.map((e) => t + L(e));
 			return `${r.length === 1 ? r[0] : `(${r.join(" | ")})`}[]`;
 		}
 	}
 }
-function G(e, t = "") {
+function z(e, t = "") {
 	return `${t}/**\n${t} * ${e}\n${t} */`;
 }
-function K(e, t = "") {
-	let n = [H(t)], r = [];
+function B(e, t = "") {
+	let n = [I(t)], r = [];
 	for (let [i, a] of Object.entries(e)) {
-		let e = t + U(i), o = a.description ? `${G(a.description)}\n` : "";
-		if (a.type === N.ENUM) {
+		let e = t + L(i), o = a.description ? `${z(a.description)}\n` : "";
+		if (a.type === O.ENUM) {
 			let t = a.values ?? [];
 			if (t.length === 0) n.push(`${o}export type ${e} = string;\n`);
 			else {
@@ -501,14 +502,14 @@ function K(e, t = "") {
 			}
 		} else {
 			let s = a;
-			a.type === N.ROOT && r.push(e);
+			a.type === O.ROOT && r.push(e);
 			let c = [
 				"  /** Unique identifier of a component in a content. */",
 				"  _id: string;",
 				"  /** Unique identifier for the Schema object. */",
 				`  _schema: '${i}';`,
 				...(s.fields ?? []).slice().sort((e, t) => e.name.localeCompare(t.name)).flatMap((e) => {
-					let n = W(e, t), r = e.required ? "" : "?", i = [];
+					let n = R(e, t), r = e.required ? "" : "?", i = [];
 					return e.description && i.push(`  /** ${e.description} */`), i.push(`  ${e.name}${r}: ${n};`), i;
 				})
 			];
@@ -519,14 +520,14 @@ function K(e, t = "") {
 }
 //#endregion
 //#region src/commands/types/generate/index.ts
-var q = c(d.cwd(), C, "localess.ts"), J = new e("generate").description("Generate types for your schemas").option("-p, --path <path>", "Path to the file where to save the generated types. Default is .localess/localess.ts", q).option("--prefix <prefix>", "Prefix to prepend to all generated type names", "").action(async (e) => {
+var V = c(d.cwd(), x, "localess.ts"), H = new e("generate").description("Generate types for your schemas").option("-p, --path <path>", "Path to the file where to save the generated types. Default is .localess/localess.ts", V).option("--prefix <prefix>", "Prefix to prepend to all generated type names", "").action(async (e) => {
 	console.log("Types in with options:", e);
-	let t = await O();
+	let t = await w();
 	if (!t.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let n = S({
+	let n = b({
 		origin: t.origin,
 		spaceId: t.space,
 		token: t.token
@@ -534,14 +535,67 @@ var q = c(d.cwd(), C, "localess.ts"), J = new e("generate").description("Generat
 	console.log("Fetching schemas from Localess...");
 	let r = await n.getSchemas();
 	console.log("Generating types...");
-	let i = K(r, e.prefix);
-	await w(e.path, i), console.log(`Types written to ${e.path}`);
-}), Y = new e("types").description("Generate types for your schemas").addCommand(J), X = new e();
-X.name("Localess CLI").description("CLI tool for Localess platform management").version("3.0.5"), X.addCommand(j), X.addCommand(M), X.addCommand(V), X.addCommand(Y);
+	let i = B(r, e.prefix);
+	await S(e.path, i), console.log(`Types written to ${e.path}`);
+}), U = new e("types").description("Generate types for your schemas").addCommand(H), W = "@localess/cli", G = `https://registry.npmjs.org/${W}`;
+function K(e) {
+	let [t, n = null] = e.split("-"), r = t.split(".").map(Number);
+	return {
+		major: r[0] ?? 0,
+		minor: r[1] ?? 0,
+		patch: r[2] ?? 0,
+		preRelease: n ?? null
+	};
+}
+function q(e, t) {
+	let n = K(e), r = K(t);
+	return n.major === r.major ? n.minor === r.minor ? n.patch === r.patch ? n.preRelease === null && r.preRelease !== null ? !0 : n.preRelease !== null && r.preRelease === null ? !1 : n.preRelease !== null && r.preRelease !== null ? n.preRelease > r.preRelease : !1 : n.patch > r.patch : n.minor > r.minor : n.major > r.major;
+}
+async function J(e, t) {
+	try {
+		let n = await fetch(`${G}/${e}`, { signal: t });
+		return n.ok ? (await n.json()).version : null;
+	} catch {
+		return null;
+	}
+}
+function Y(e) {
+	return e.replace(/\u001B\[[0-9;]*m/g, "").length;
+}
+function X(e, t, n) {
+	let r = `  Update available: ${p.dim(e)} → ${p.green.bold(t)}  `, i = `  Run ${p.cyan(`npm install --save-dev ${W}@${n}`)} to update  `, a = Math.max(Y(r), Y(i)), o = (e) => e + " ".repeat(a - Y(e)), s = p.yellow("─".repeat(a + 1));
+	return [
+		"",
+		p.yellow("┌") + s + p.yellow("┐"),
+		p.yellow("│") + " " + o(r) + p.yellow("│"),
+		p.yellow("│") + " " + o(i) + p.yellow("│"),
+		p.yellow("└") + s + p.yellow("┘"),
+		""
+	].join("\n");
+}
+async function se(e) {
+	try {
+		let t = new AbortController(), n = setTimeout(() => t.abort(), 3e3), r = K(e).preRelease !== null, [i, a] = await Promise.all([J("latest", t.signal), r ? J("dev", t.signal) : Promise.resolve(null)]);
+		if (clearTimeout(n), i && q(i, e)) return X(e, i, "latest");
+		if (a && q(a, e)) return X(e, a, "dev");
+	} catch {}
+	return null;
+}
+//#endregion
+//#region package.json
+var Z = "3.0.7-dev.20260514085047", Q = new e();
+Q.name("Localess CLI").description("CLI tool for Localess platform management").version(Z);
+var $;
+Q.hook("preAction", () => {
+	$ = se(Z);
+}), Q.hook("postAction", async () => {
+	let e = await $;
+	e && console.log(e);
+}), Q.addCommand(D), Q.addCommand(ae), Q.addCommand(F), Q.addCommand(U);
 //#endregion
 //#region src/index.ts
 try {
-	X.parse(process.argv);
+	Q.parse(process.argv);
 } catch (e) {
 	console.error("Error executing command:", e instanceof Error ? e.message : e), process.exit(1);
 }

package/dist/{client.d.ts → src/client.d.ts}

@@ -18,7 +18,7 @@ export type LocalessClientOptions = {
     /**
      * Content version to fetch, leave empty for 'published' or 'draft' for the latest draft
      */
-    version?: 'draft' | string;
+    version?: 'draft';
     /**
      * Enable debug mode
      */
@@ -64,7 +64,7 @@ export type ContentFetchParams = {
      * Content version to fetch, leave empty for 'published' or 'draft' for the latest draft.
      * Overrides the version set in the client options.
      */
-    version?: 'draft' | string;
+    version?: 'draft';
     /**
      * Locale identifier (ISO 639-1) to fetch content in, leave empty for default locale.
      *
@@ -85,7 +85,7 @@ export type TranslationFetchParams = {
      * Translation version to fetch, leave empty for 'published' or 'draft' for the latest draft.
      * Overrides the version set in the client options.
      */
-    version?: 'draft' | string;
+    version?: 'draft';
 };
 export interface LocalessClient {
     /**

package/dist/src/version-check.d.ts

@@ -0,0 +1,2 @@
+export declare function isNewer(candidate: string, current: string): boolean;
+export declare function checkForUpdate(currentVersion: string): Promise<string | null>;

package/dist/src/version-check.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/cli",
-  "version": "3.0.7-dev.20260512203425",
+  "version": "3.0.7-dev.20260514085047",
   "description": "Localess Command Line.",
   "keywords": [
     "localess",