@localess/cli 3.2.4-dev.20260611125935 → 3.2.4-dev.20260611210209

package/README.md

@@ -12,7 +12,7 @@ The `@localess/cli` package is the official command-line interface for the [Loca
 
 ## Requirements
 
-- Node.js >= 20.0.0
+- Node.js >= 24.0.0
 
 ## Installation
 
@@ -184,10 +184,11 @@ localess translations pull <locale> --path <file> [options]
 
 **Options:**
 
-| Flag                    | Default      | Description                     |
-|-------------------------|--------------|---------------------------------|
-| `-p, --path <path>`     | *(required)* | Output file path                |
-| `-f, --format <format>` | `flat`       | File format: `flat` or `nested` |
+| Flag                    | Default      | Description                          |
+|-------------------------|--------------|--------------------------------------|
+| `-p, --path <path>`     | *(required)* | Output file path                     |
+| `-f, --format <format>` | `flat`       | File format: `flat` or `nested`      |
+| `--draft`               | `false`      | Pull the draft (unpublished) version |
 
 **Examples:**
 
@@ -197,6 +198,9 @@ localess translations pull en --path ./locales/en.json
 
 # Pull German translations as nested JSON
 localess translations pull de --path ./locales/de.json --format nested
+
+# Pull draft (unpublished) translations
+localess translations pull en --path ./locales/en.json --draft
 ```
 
 ---

package/SKILL.md

@@ -8,7 +8,7 @@
 - Pushing and pulling translations (flat and nested JSON formats supported for both push and pull)
 - Generating TypeScript type definitions from the OpenAPI schema
 
-**Status:** Early development (v3.0.1). Requires Node.js >= 20.0.0.
+**Status:** Early development (v3.2.4). Requires Node.js >= 24.0.0.
 
 ---
 
@@ -182,10 +182,11 @@ localess translations pull <locale> --path <file> [options]
 
 **Options:**
 
-| Flag                    | Default   | Description                     |
-|-------------------------|-----------|---------------------------------|
-| `-p, --path <path>`     | required  | Output file path                |
-| `-f, --format <format>` | `flat`    | File format: `flat` or `nested` |
+| Flag                    | Default   | Description                          |
+|-------------------------|-----------|--------------------------------------|
+| `-p, --path <path>`     | required  | Output file path                     |
+| `-f, --format <format>` | `flat`    | File format: `flat` or `nested`      |
+| `--draft`               | `false`   | Pull the draft version of translations |
 
 **Examples:**
 
@@ -195,6 +196,9 @@ localess translations pull en --path ./locales/en.json
 
 # Pull as nested JSON
 localess translations pull de --path ./locales/de.json --format nested
+
+# Pull draft (unpublished) translations
+localess translations pull en --path ./locales/en.json --draft
 ```
 
 ---
@@ -285,7 +289,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '24'
       - run: npm install -g @localess/cli
       - run: localess translations push en --path ./locales/en.json
         env:

package/dist/index.mjs

@@ -1,45 +1,15 @@
 #!/usr/bin/env node
 import { Command as e } from "commander";
 import { input as t, password as n } from "@inquirer/prompts";
-import { access as r, appendFile as i, mkdir as a, readFile as o, writeFile as s } from "node:fs/promises";
-import { join as c, parse as l } from "node:path";
+import { localessClient as r } from "@localess/client";
+import { access as i, appendFile as a, mkdir as o, readFile as s, writeFile as c } from "node:fs/promises";
+import { join as l, parse as ee } from "node:path";
 import * as u from "node:process";
-import ee from "node:process";
+import te from "node:process";
 import { z as d } from "zod";
 import f from "chalk";
 //#region package.json
-var p = "3.2.4-dev.20260611125935", te = class {
-	set(e, t) {}
-	get(e) {}
-	has(e) {
-		return !1;
-	}
-}, m = class {
-	ttlMs;
-	cache = /* @__PURE__ */ new Map();
-	constructor(e = 3e5) {
-		this.ttlMs = e;
-	}
-	set(e, t) {
-		this.cache.set(e, {
-			value: t,
-			expiresAt: Date.now() + this.ttlMs
-		});
-	}
-	get(e) {
-		let t = this.cache.get(e);
-		if (t) {
-			if (Date.now() > t.expiresAt) {
-				this.cache.delete(e);
-				return;
-			}
-			return t.value;
-		}
-	}
-	has(e) {
-		return this.get(e) !== void 0;
-	}
-}, ne = "\x1B[0m", re = "\x1B[34m";
+var p = "3.2.4-dev.20260611210209", m = "\x1B[0m", ne = "\x1B[34m";
 function h(e) {
 	return Object.keys(e).sort().reduce((t, n) => {
 		let r = e[n];
@@ -54,7 +24,7 @@ function g(e, t = "") {
 	}
 	return n;
 }
-function _(e) {
+function re(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) {
 		let e = n.split("."), i = t;
@@ -64,24 +34,24 @@ function _(e) {
 }
 //#endregion
 //#region src/client.ts
-var v = `${re}[Localess:Client]${ne}`;
-async function y(e, t, n = 3, r = 500, i) {
+var _ = `${ne}[Localess:Client]${m}`;
+async function v(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(v, `fetchWithRetry: HTTP ${n.status} on attempt ${a + 1}`), o = /* @__PURE__ */ Error(`HTTP ${n.status}`);
+			if (!n.ok && n.status >= 500) i && console.log(_, `fetchWithRetry: HTTP ${n.status} on attempt ${a + 1}`), o = /* @__PURE__ */ Error(`HTTP ${n.status}`);
 			else return n;
 		} catch (e) {
-			i && console.log(v, `fetchWithRetry: network error on attempt ${a + 1}`, e), o = e;
+			i && console.log(_, `fetchWithRetry: network error on attempt ${a + 1}`, e), o = e;
 		}
 		a++, a <= n && await new Promise((e) => setTimeout(e, r));
 	}
 	throw o;
 }
-function b(e) {
-	e.debug && console.log(v, "Client Options : ", e);
-	let t = e.origin.replace(/\/+$/, ""), n = {
+function y(e) {
+	e.debug && console.log(_, "Client Options : ", e);
+	let t = r(e), n = e.origin.replace(/\/+$/, ""), i = {
 		redirect: "follow",
 		headers: {
 			"Content-Type": "application/json",
@@ -89,178 +59,110 @@ function b(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 te() : new m(r);
-	return {
-		async getSpace() {
-			e.debug && console.log(v, "getSpace()");
-			let r = `${t}/api/v1/spaces/${e.spaceId}?token=${e.token}`;
-			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 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(v, "getSpace error : ", e), {};
-			}
-		},
-		async getLinks(r) {
-			e.debug && console.log(v, "getLinks() params : ", JSON.stringify(r));
-			let a = "";
-			r?.kind && (a = `&kind=${r.kind}`);
-			let o = "";
-			r?.parentSlug && (o = `&parentSlug=${r.parentSlug}`);
-			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(v, "getLinks fetch url : ", c), i.has(c)) return e.debug && console.log(v, "getLinks cache hit"), i.get(c);
-			try {
-				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(v, "getLinks error : ", e), {};
-			}
-		},
-		async getContentBySlug(r, 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(v, "getContentBySlug fetch url : ", u), i.has(u)) return e.debug && console.log(v, "getContentBySlug cache hit"), i.get(u);
-			try {
-				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(v, "getContentBySlug error : ", e), {};
-			}
-		},
-		async getContentById(r, 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(v, "getContentById fetch url : ", u), i.has(u)) return e.debug && console.log(v, "getContentById cache hit"), i.get(u);
-			try {
-				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(v, "getContentById error : ", e), {};
-			}
-		},
-		async getTranslations(r, 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(v, "getTranslations fetch url : ", s), i.has(s)) return e.debug && console.log(v, "getTranslations cache hit"), i.get(s);
-			try {
-				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(v, "getTranslations error : ", e), {};
-			}
-		},
-		async updateTranslations(r, i, a, o) {
-			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(v, "updateTranslations fetch url : ", s);
-			let c = {
-				type: i,
-				values: a,
-				dryRun: o
-			};
-			try {
-				let t = await y(s, {
-					method: "POST",
-					headers: {
-						"X-API-KEY": e.token,
-						...n.headers
-					},
-					body: JSON.stringify(c)
-				}, e.retryCount, e.retryDelay, e.debug);
-				return e.debug && console.log(v, "updateTranslations status : ", t.status), t.json();
-			} catch (e) {
-				console.error(v, "updateTranslations error : ", e);
-			}
-		},
-		async 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(v, "getOpenApi fetch url : ", r), i.has(r)) return e.debug && console.log(v, "getOpenApi cache hit"), i.get(r);
-			try {
-				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(v, "getOpenApi error : ", e), {};
-			}
-		},
-		async getSchemas() {
-			e.debug && console.log(v, "getSchemas()");
-			let r = `${t}/api/v1/spaces/${e.spaceId}/schemas?token=${e.token}`;
-			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 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(v, "getSchemas error : ", e), {};
-			}
-		},
-		assetLink(n) {
-			return typeof n == "string" ? `${t}/api/v1/spaces/${e.spaceId}/assets/${n}` : `${t}/api/v1/spaces/${e.spaceId}/assets/${n.uri}`;
+	};
+	async function a() {
+		e.debug && console.log(_, "getSpace()");
+		let t = `${n}/api/v1/spaces/${e.spaceId}?token=${e.token}`;
+		e.debug && console.log(_, "getSpace fetch url : ", t);
+		try {
+			let n = await v(t, i, e.retryCount, e.retryDelay, e.debug);
+			return e.debug && console.log(_, "getSpace status : ", n.status), n.json();
+		} catch (e) {
+			return console.error(_, "getSpace error : ", e), {};
+		}
+	}
+	async function o() {
+		e.debug && console.log(_, "getSchemas()");
+		let t = `${n}/api/v1/spaces/${e.spaceId}/schemas?token=${e.token}`;
+		e.debug && console.log(_, "getSchemas fetch url : ", t);
+		try {
+			let n = await v(t, i, e.retryCount, e.retryDelay, e.debug);
+			return e.debug && console.log(_, "getSchemas status : ", n.status), n.json();
+		} catch (e) {
+			return console.error(_, "getSchemas error : ", e), {};
+		}
+	}
+	async function s() {
+		e.debug && console.log(_, "getOpenApi()");
+		let t = `${n}/api/v1/spaces/${e.spaceId}/open-api?token=${e.token}`;
+		e.debug && console.log(_, "getOpenApi fetch url : ", t);
+		try {
+			let n = await v(t, i, e.retryCount, e.retryDelay, e.debug);
+			return e.debug && console.log(_, "getOpenApi status : ", n.status), n.json();
+		} catch (e) {
+			return console.error(_, "getOpenApi error : ", e), {};
 		}
+	}
+	async function c(t, r, a, o) {
+		e.debug && (console.log(_, "updateTranslations() locale : ", t), console.log(_, "updateTranslations() type : ", r), console.log(_, "updateTranslations() values : ", JSON.stringify(a)));
+		let s = `${n}/api/v1/spaces/${e.spaceId}/translations/${t}`;
+		e.debug && console.log(_, "updateTranslations fetch url : ", s);
+		let c = {
+			type: r,
+			values: a,
+			dryRun: o
+		};
+		try {
+			let t = await v(s, {
+				method: "POST",
+				headers: {
+					"X-API-KEY": e.token,
+					...i.headers
+				},
+				body: JSON.stringify(c)
+			}, e.retryCount, e.retryDelay, e.debug);
+			return e.debug && console.log(_, "updateTranslations status : ", t.status), t.json();
+		} catch (e) {
+			console.error(_, "updateTranslations error : ", e);
+		}
+	}
+	return {
+		...t,
+		getSpace: a,
+		getSchemas: o,
+		getOpenApi: s,
+		updateTranslations: c
 	};
 }
 //#endregion
 //#region src/file.ts
-var x = ".localess";
-async function S(e, t, n) {
-	let r = l(e).dir;
+var b = ".localess";
+async function x(e, t, n) {
+	let r = ee(e).dir;
 	try {
-		await a(r, { recursive: !0 });
+		await o(r, { recursive: !0 });
 	} catch {
 		return;
 	}
 	try {
-		await s(e, t, n);
+		await c(e, t, n);
 	} catch {}
 }
-async function C(e) {
-	return o(e, "utf-8");
+async function ie(e) {
+	return s(e, "utf-8");
 }
-async function w(e, t) {
-	let n = c(e, ".gitignore"), r = "";
+async function ae(e, t) {
+	let n = l(e, ".gitignore"), r = "";
 	try {
-		r = await o(n, "utf-8");
+		r = await s(n, "utf-8");
 	} catch {}
-	r.split("\n").map((e) => e.trim()).includes(t) || await i(n, `${r.length > 0 && !r.endsWith("\n") ? "\n" : ""}${t}\n`, "utf-8");
+	r.split("\n").map((e) => e.trim()).includes(t) || await a(n, `${r.length > 0 && !r.endsWith("\n") ? "\n" : ""}${t}\n`, "utf-8");
 }
 //#endregion
 //#region src/session.ts
-var T = c(u.cwd(), x, "credentials.json");
-async function E() {
-	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."), {
+var S = l(u.cwd(), b, "credentials.json");
+async function C() {
+	let e = { isLoggedIn: !1 }, t = u.env.LOCALESS_TOKEN, n = u.env.LOCALESS_SPACE, r = u.env.LOCALESS_ORIGIN;
+	if (t && n && r) return console.debug("Login in using environment variables."), {
 		isLoggedIn: !0,
 		space: n,
-		origin: i,
+		origin: r,
 		token: t,
 		method: "env"
 	};
 	try {
-		await r(T);
-		let t = await o(T, "utf8"), n = JSON.parse(t);
+		await i(S);
+		let t = await s(S, "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,
@@ -272,21 +174,21 @@ async function E() {
 	} catch {}
 	return e;
 }
-async function D(e) {
-	if (e.origin && e.token && e.space) await S(T, JSON.stringify(e, null, 2), { mode: 384 }), console.log("Session credentials saved to file system."), await w(u.cwd(), x), console.log(`Added '${x}' to .gitignore to prevent credentials from being committed.`);
+async function w(e) {
+	if (e.origin && e.token && e.space) await x(S, JSON.stringify(e, null, 2), { mode: 384 }), console.log("Session credentials saved to file system."), await ae(u.cwd(), b), console.log(`Added '${b}' to .gitignore to prevent credentials from being committed.`);
 	else throw Error("Cannot persist session: missing required fields.");
 }
-async function ie() {
+async function T() {
 	try {
-		await r(T), await S(T, "{}", { mode: 384 });
+		await i(S), await x(S, "{}", { mode: 384 });
 	} catch {
 		throw Error("Failed to clear session credentials.");
 	}
 }
 //#endregion
 //#region src/commands/login/index.ts
-var ae = 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 E()).isLoggedIn) {
+var E = 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 C()).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;
 	}
@@ -299,14 +201,14 @@ var ae = new e("login").description("Login to Localess CLI").option("-o, --origi
 	}), a = e.token ?? await n({
 		message: "Token:",
 		mask: !0
-	}), o = b({
+	}), o = y({
 		origin: r,
 		spaceId: i,
 		token: a
 	});
 	try {
 		let e = await o.getSpace();
-		console.log(`Successfully logged in to space: ${e.name} (${e.id})`), await D({
+		console.log(`Successfully logged in to space: ${e.name} (${e.id})`), await w({
 			origin: r,
 			space: i,
 			token: a
@@ -314,9 +216,9 @@ var ae = new e("login").description("Login to Localess CLI").option("-o, --origi
 	} catch {
 		console.error("Login failed");
 	}
-}), oe = new e("logout").description("Logout from Localess CLI").action(async () => {
+}), D = new e("logout").description("Logout from Localess CLI").action(async () => {
 	console.log("Logging out...");
-	let e = await E();
+	let e = await C();
 	if (!e.isLoggedIn) {
 		console.log("Not currently logged in.");
 		return;
@@ -326,7 +228,7 @@ var ae = new e("login").description("Login to Localess CLI").option("-o, --origi
 		return;
 	}
 	try {
-		await ie(), console.log("Successfully logged out.");
+		await T(), console.log("Successfully logged out.");
 	} catch (e) {
 		console.error("Failed to log out:", e);
 	}
@@ -334,63 +236,63 @@ var ae = new e("login").description("Login to Localess CLI").option("-o, --origi
 	return e.ROOT = "ROOT", e.NODE = "NODE", e.ENUM = "ENUM", 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;
-}({}), A = /* @__PURE__ */ function(e) {
+}({}), A = d.record(d.string(), d.string()), j = d.enum([
+	"add-missing",
+	"update-existing",
+	"delete-missing"
+]);
+d.object({
+	type: j,
+	values: A
+});
+//#endregion
+//#region src/models/translations.ts
+var M = /* @__PURE__ */ function(e) {
 	return e.ADD_MISSING = "add-missing", e.UPDATE_EXISTING = "update-existing", e.DELETE_MISSING = "delete-missing", e;
-}({}), j = /* @__PURE__ */ function(e) {
+}({}), N = /* @__PURE__ */ function(e) {
 	return e.FLAT = "flat", e.NESTED = "nested", e;
-}({}), M = 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).option("--draft", "Pull the draft version of translations").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));
+}({}), P = 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(N)}`, N.FLAT).option("--draft", "Pull the draft version of translations").action(async (e, t) => {
+	if (console.log("Pulling translations with arguments:", e), console.log("Pulling translations with options:", t), !Object.values(N).includes(t.format)) {
+		console.error("Invalid format provided. Possible values are :", Object.values(N));
 		return;
 	}
-	let n = await E();
+	let n = await C();
 	if (!n.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let r = b({
+	let r = y({
 		origin: n.origin,
 		spaceId: n.space,
 		token: n.token
 	});
 	console.log("Pulling translations from Localess for locale:", e);
 	let i = await r.getTranslations(e, { version: t.draft ? "draft" : void 0 });
-	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));
+	if (console.log("Saving translations in file:", t.path), t.format === N.FLAT) await x(t.path, JSON.stringify(h(i), null, 2));
+	else if (t.format === N.NESTED) {
+		let e = h(re(i));
+		await x(t.path, JSON.stringify(e, null, 2));
 	}
 	console.log("Successfully saved translations from Localess");
-}), N = d.record(d.string(), d.string()), P = d.enum([
-	"add-missing",
-	"update-existing",
-	"delete-missing"
-]);
-d.object({
-	type: P,
-	values: N
-});
-//#endregion
-//#region src/commands/translations/push/index.ts
-var F = 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), !P.safeParse(t.type).success) {
-		console.error("Invalid type provided. Possible values are :", Object.values(A));
+}), F = 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(N)}`, N.FLAT).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(M)}`, M.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), !j.safeParse(t.type).success) {
+		console.error("Invalid type provided. Possible values are :", Object.values(M));
 		return;
 	}
-	let n = await E();
+	let n = await C();
 	if (!n.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let r = b({
+	let r = y({
 		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 C(t.path), a = JSON.parse(i), o;
-	o = t.format === j.NESTED ? g(a) : a;
-	let s = N.safeParse(o);
+	let i = await ie(t.path), a = JSON.parse(i), o;
+	o = t.format === N.NESTED ? g(a) : a;
+	let s = A.safeParse(o);
 	if (!s.success) {
 		console.error("Invalid translations file format:", s.error);
 		return;
@@ -398,7 +300,7 @@ var F = 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");
-}), I = new e("translations").description("Manage translations").addCommand(F).addCommand(M);
+}), I = new e("translations").description("Manage translations").addCommand(F).addCommand(P);
 //#endregion
 //#region src/commands/types/generate/generator.ts
 function L(e) {
@@ -521,14 +423,14 @@ function V(e, t = "") {
 }
 //#endregion
 //#region src/commands/types/generate/index.ts
-var H = c(ee.cwd(), x, "localess.ts"), U = 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", H).option("--prefix <prefix>", "Prefix to prepend to all generated type names", "").action(async (e) => {
+var H = l(te.cwd(), b, "localess.ts"), U = 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", H).option("--prefix <prefix>", "Prefix to prepend to all generated type names", "").action(async (e) => {
 	console.log("Types in with options:", e);
-	let t = await E();
+	let t = await C();
 	if (!t.isLoggedIn) {
 		console.error("Not logged in"), console.error("Please log in first using \"localess login\" command");
 		return;
 	}
-	let n = b({
+	let n = y({
 		origin: t.origin,
 		spaceId: t.space,
 		token: t.token
@@ -537,7 +439,7 @@ var H = c(ee.cwd(), x, "localess.ts"), U = new e("generate").description("Genera
 	let r = await n.getSchemas();
 	console.log("Generating types...");
 	let i = V(r, e.prefix);
-	await S(e.path, i), console.log(`Types written to ${e.path}`);
+	await x(e.path, i), console.log(`Types written to ${e.path}`);
 }), W = new e("types").description("Generate types for your schemas").addCommand(U), G = "@localess/cli", K = `https://registry.npmjs.org/${G}`;
 function q(e) {
 	let [t, n = null] = e.split("-"), r = t.split(".").map(Number);
@@ -574,7 +476,7 @@ function Z(e, t, n) {
 		""
 	].join("\n");
 }
-async function se(e) {
+async function oe(e) {
 	try {
 		let t = new AbortController(), n = setTimeout(() => t.abort(), 3e3), r = q(e).preRelease !== null, [i, a] = await Promise.all([Y("latest", t.signal), r ? Y("dev", t.signal) : Promise.resolve(null)]);
 		if (clearTimeout(n), i && J(i, e)) return Z(e, i, "latest");
@@ -588,11 +490,11 @@ var Q = new e();
 Q.name("Localess CLI").description("CLI tool for Localess platform management").version(p);
 var $;
 Q.hook("preAction", () => {
-	$ = se(p);
+	$ = oe(p);
 }), Q.hook("postAction", async () => {
 	let e = await $;
 	e && console.log(e);
-}), Q.addCommand(ae), Q.addCommand(oe), Q.addCommand(I), Q.addCommand(W);
+}), Q.addCommand(E), Q.addCommand(D), Q.addCommand(I), Q.addCommand(W);
 //#endregion
 //#region src/index.ts
 try {

package/dist/src/client.d.ts

@@ -1,38 +1,9 @@
 import { OpenAPIObject } from 'openapi3-ts/oas30';
-import { Content, ContentAsset, ContentData, Links, Schemas, Space, Translations, TranslationUpdateResponse, TranslationUpdateType } from './models';
-export type LocalessClientOptions = {
-    /**
-     * A fully qualified domain name with protocol (http/https) and port.
-     *
-     * Example: https://my-localess.web.app
-     */
-    origin: string;
-    /**
-     * Localess space ID can be found in the Localess Space settings
-     */
-    spaceId: string;
-    /**
-     * Localess API token can be found in the Localess Space settings
-     */
-    token: string;
-    /**
-     * Content version to fetch, leave empty for 'published' or 'draft' for the latest draft
-     */
-    version?: 'draft';
-    /**
-     * Enable debug mode
-     */
-    debug?: boolean;
-    /**
-     * Cache TTL (time to live) in **seconds** for API responses.
-     *
-     * - `undefined` — use default in-memory TTL cache with 5 minutes TTL (default)
-     * - `number`    — use in-memory TTL cache with the given TTL in seconds
-     * - `false`     — disable caching entirely (always fetches fresh data)
-     *
-     * @default 300 (5 minutes)
-     */
-    cacheTTL?: number | false;
+import { LocalessClientOptions, Translations } from '@localess/client';
+import { Space } from './models/space';
+import { Schemas } from './models/schema';
+import { TranslationUpdateResponse, TranslationUpdateType } from './models/translations';
+export type LocalessCliClientOptions = LocalessClientOptions & {
     /**
      * Number of times to retry failed fetch requests (network errors or 5xx). Default: 3
      */
@@ -42,113 +13,16 @@ export type LocalessClientOptions = {
      */
     retryDelay?: number;
 };
-export type LinksFetchParams = {
-    /**
-     * Content Kind. FOLDER or DOCUMENT. If not provided, it will return all.
-     * @example 'DOCUMENT'
-     */
-    kind?: 'DOCUMENT' | 'FOLDER';
-    /**
-     * Content parent slug.
-     * @example 'legal/policy'
-     */
-    parentSlug?: string;
-    /**
-     * If **true**, exclude all sub slugs, otherwise include all content under current selected **parent slug**.
-     * @example false
-     */
-    excludeChildren?: boolean;
-};
-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';
-    /**
-     * Locale identifier (ISO 639-1) to fetch content in, leave empty for default locale.
-     *
-     * Example: en
-     */
-    locale?: string;
-    /**
-     * Resolve references in the content data.
-     * @default false
-     */
-    resolveReference?: boolean;
-    /**
-     * Resolve links in the content data.
-     * @default false
-     */
-    resolveLink?: boolean;
-    /**
-     * Resolve all assets.
-     * @default false
-     */
-    resolveAsset?: boolean;
-};
-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';
+export declare function localessCliClient(options: LocalessCliClientOptions): {
+    getSpace: () => Promise<Space>;
+    getSchemas: () => Promise<Schemas>;
+    getOpenApi: () => Promise<OpenAPIObject>;
+    updateTranslations: (locale: string, type: TranslationUpdateType, values: Translations, dryRun?: boolean) => Promise<TranslationUpdateResponse | undefined>;
+    getLinks(params?: import('@localess/client').LinksFetchParams): Promise<import('@localess/client').Links>;
+    getContentBySlug<T extends import('@localess/client').ContentData = import('@localess/client').ContentData>(slug: string, params?: import('@localess/client').ContentFetchParams): Promise<import('@localess/client').Content<T>>;
+    getContentById<T extends import('@localess/client').ContentData = import('@localess/client').ContentData>(id: string, params?: import('@localess/client').ContentFetchParams): Promise<import('@localess/client').Content<T>>;
+    getTranslations(locale: string, params?: import('@localess/client').TranslationFetchParams): Promise<Translations>;
+    syncScriptUrl(): string;
+    assetLink(asset: import('@localess/client').ContentAsset | string, params?: import('@localess/client').AssetTransformParams): string;
 };
-export interface LocalessClient {
-    /**
-     * Get space information
-     * @returns {Promise<Space>}
-     */
-    getSpace(): Promise<Space>;
-    /**
-     * Get all links
-     * @param params{LinksFetchParams} - Fetch parameters
-     * @returns {Promise<Links>}
-     */
-    getLinks(params?: LinksFetchParams): Promise<Links>;
-    /**
-     * Get content by SLUG
-     * @param slug{string} - Content SLUG
-     * @param params{ContentFetchParams} - Fetch parameters
-     * @returns {Promise<Content>}
-     */
-    getContentBySlug<T extends ContentData = ContentData>(slug: string, params?: ContentFetchParams): Promise<Content<T>>;
-    /**
-     * Get content by ID
-     * @param id{string} - Content ID
-     * @param params{ContentFetchParams} - Fetch parameters
-     * @returns {Promise<Content>}
-     */
-    getContentById<T extends ContentData = ContentData>(id: string, params?: ContentFetchParams): Promise<Content<T>>;
-    /**
-     * Get translations for the given locale
-     * @param locale{string} - Locale identifier (ISO 639-1)
-     * @param params{ContentFetchParams} - Fetch parameters
-     * @returns {Promise<Translations>}
-     */
-    getTranslations(locale: string, params?: TranslationFetchParams): Promise<Translations>;
-    /**
-     * Update translations for the given locale
-     * @param locale - Locale identifier (ISO 639-1)
-     * @param type{TranslationUpdateType} - Type of update to perform (add-missing or update-existing)
-     * @param values - Key-Value Object. Where Key is Translation ID and Value is Translated Content
-     * @param dryRun - If true, the API will return the changes that would be made without actually applying them
-     * @returns {Promise<void>}
-     */
-    updateTranslations(locale: string, type: TranslationUpdateType, values: Translations, dryRun?: boolean): Promise<TranslationUpdateResponse | undefined>;
-    /**
-     * Get OpenAPI specification
-     * Requires Token with Development Tools permission
-     */
-    getOpenApi(): Promise<OpenAPIObject>;
-    /**
-     * Get Schemas Definition
-     */
-    getSchemas(): Promise<Schemas>;
-    assetLink(asset: ContentAsset | string): string;
-}
-/**
- * Create a Localess API Client
- * @param {LocalessClientOptions} options connection details
- */
-export declare function localessClient(options: LocalessClientOptions): LocalessClient;
+export type LocalessCliClient = ReturnType<typeof localessCliClient>;

package/dist/src/models/index.d.ts

@@ -1,15 +1,5 @@
-export * from './asset-metadata';
-export * from './assets';
-export * from './content';
-export * from './content-asset';
-export * from './content-data';
-export * from './content-link';
-export * from './content-metadata';
-export * from './content-reference';
-export * from './content-rich-text';
-export * from './links';
-export * from './locale';
-export * from './references';
+export * from '@localess/client';
 export * from './schema';
 export * from './space';
+export * from './translation.zod';
 export * from './translations';

package/dist/src/models/space.d.ts

@@ -1,4 +1,4 @@
-import { Locale } from './locale';
+import { Locale } from '@localess/client';
 export interface Space {
     /**
      * Unique identifier for the object.

package/dist/src/models/translations.d.ts

@@ -1,13 +1,7 @@
-/**
- * Key-Value Object. Where Key is Translation ID and Value is Translated Content
- */
-export interface Translations {
-    [key: string]: string;
-}
 export type TranslationUpdate = {
     dryRun?: boolean;
     type: TranslationUpdateType;
-    values: Translations;
+    values: Record<string, string>;
 };
 export declare enum TranslationUpdateType {
     ADD_MISSING = "add-missing",

package/dist/src/utils.d.ts

@@ -37,9 +37,6 @@ export declare const BG_BRIGHT_BLUE = "\u001B[104m";
 export declare const BG_BRIGHT_MAGENTA = "\u001B[105m";
 export declare const BG_BRIGHT_CYAN = "\u001B[106m";
 export declare const BG_BRIGHT_WHITE = "\u001B[107m";
-export declare const isBrowser: () => boolean;
-export declare const isServer: () => boolean;
-export declare const isIframe: () => boolean;
 export declare function sortObjectKeys<T extends Record<string, unknown>>(input: T): T;
 export declare function nestedObjectToFlat(input: Record<string, unknown>, prefix?: string): Record<string, string>;
 export declare function dotToNestedObject(input: Record<string, string>): Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/cli",
-  "version": "3.2.4-dev.20260611125935",
+  "version": "3.2.4-dev.20260611210209",
   "description": "Localess Command Line.",
   "publishConfig": {
     "access": "public"
@@ -46,6 +46,7 @@
   "license": "MIT",
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
+    "@localess/client": "3.2.4-dev.20260611210209",
     "chalk": "^5.6.2",
     "commander": "^15.0.0",
     "zod": "^4.4.3"

package/dist/src/cache.d.ts

@@ -1,29 +0,0 @@
-export interface ICache<V> {
-    set(key: string, value: V): void;
-    get(key: string): V | undefined;
-    has(key: string): boolean;
-}
-export declare class Cache<V> implements ICache<V> {
-    private cache;
-    set(key: string, value: V): void;
-    get(key: string): V | undefined;
-    has(key: string): boolean;
-}
-export declare class NoCache<V> implements ICache<V> {
-    set(key: string, value: V): void;
-    get(key: string): V | undefined;
-    has(key: string): boolean;
-}
-export declare class TTLCache<V> {
-    private ttlMs;
-    private cache;
-    /**
-     * Creates a TTLCache with a specified time-to-live (TTL) for each entry.
-     * default is 5 minutes (300000 ms).
-     * @param ttlMs
-     */
-    constructor(ttlMs?: number);
-    set(key: string, value: V): void;
-    get(key: string): V | undefined;
-    has(key: string): boolean;
-}

package/dist/src/models/asset-metadata.d.ts

@@ -1,29 +0,0 @@
-/**
- * Resolved Asset metadata returned when resolveAsset=true.
- */
-export interface AssetMetadata {
-    /**
-     * Unique identifier for the Asset.
-     */
-    id: string;
-    /**
-     * Name of the Asset.
-     * @example hero-image
-     */
-    name: string;
-    /**
-     * File extension of the Asset.
-     * @example .jpg
-     */
-    extension: string;
-    /**
-     * MIME type of the Asset.
-     * @example image/jpeg
-     */
-    type: string;
-    /**
-     * Alternative text for the Asset.
-     * @example A hero image
-     */
-    alt?: string;
-}

package/dist/src/models/assets.d.ts

@@ -1,7 +0,0 @@
-import { AssetMetadata } from './asset-metadata';
-/**
- * Key-Value Object. Where Key is Unique identifier for the Asset object and Value is Asset Metadata.
- */
-export interface Assets {
-    [key: string]: AssetMetadata;
-}

package/dist/src/models/content-asset.d.ts

@@ -1,13 +0,0 @@
-/**
- * Content Asset defines reference to an Asset.
- */
-export interface ContentAsset {
-    /**
-     * Define the type of Asset
-     */
-    kind: 'ASSET';
-    /**
-     * Unique identifier for the asset.
-     */
-    uri: string;
-}

package/dist/src/models/content-data.d.ts

@@ -1,27 +0,0 @@
-import { ContentAsset } from './content-asset';
-import { ContentLink } from './content-link';
-import { ContentReference } from './content-reference';
-import { ContentRichText } from './content-rich-text';
-export type ContentDataField = any | string | string[] | number | boolean | ContentLink | ContentRichText | ContentData | ContentData[] | ContentAsset | ContentAsset[] | ContentReference | ContentReference[];
-/**
- * Content Data Schema related information.
- */
-export interface ContentDataSchema {
-    /**
-     * Unique identifier of a component in a content.
-     */
-    _id: string;
-    /**
-     * Unique identifier for the Schema object.
-     */
-    _schema: string;
-}
-/**
- * ContentData defined Object to connect all possible root Schemas.
- */
-export interface ContentData extends ContentDataSchema {
-    /**
-     * Other Schema-specific fields
-     */
-    [field: string]: ContentDataField | undefined;
-}

package/dist/src/models/content-link.d.ts

@@ -1,21 +0,0 @@
-/**
- * Content Link define reference to a Link.
- */
-export interface ContentLink {
-    /**
-     * Define the type of Link
-     */
-    kind: 'LINK';
-    /**
-     * Define the target of the link. _blank for the new tab and _self for the same tab.
-     */
-    target: '_blank' | '_self';
-    /**
-     * Define the type of Link. URL for external links and Content for internal links.
-     */
-    type: 'url' | 'content';
-    /**
-     * If the type is content, then it will be Content ID. Otherwise, it will be URL.
-     */
-    uri: string;
-}

package/dist/src/models/content-metadata.d.ts

@@ -1,41 +0,0 @@
-/**
- * Content Metadata defines short information about a Content for navigation reason.
- */
-export interface ContentMetadata {
-    /**
-     * Date and Time at which the Content was created.
-     */
-    createdAt: string;
-    /**
-     * Combination of SLUG and Parent SLUG of the Content
-     */
-    fullSlug: string;
-    /**
-     * Unique identifier for the object.
-     */
-    id: string;
-    /**
-     * Define the type of Content, whether it is a FOLDER or DOCUMENT.
-     */
-    kind: 'FOLDER' | 'DOCUMENT';
-    /**
-     * Name of the Content
-     */
-    name: string;
-    /**
-     * Parent SLUG of the Content
-     */
-    parentSlug: string;
-    /**
-     * Date and Time at which the Content was published.
-     */
-    publishedAt?: string;
-    /**
-     * SLUG of the Content
-     */
-    slug: string;
-    /**
-     * Date and Time at which the Content was updated.
-     */
-    updatedAt: string;
-}

package/dist/src/models/content-reference.d.ts

@@ -1,13 +0,0 @@
-/**
- * Content Reference defines reference to a Content.
- */
-export interface ContentReference {
-    /**
-     * Define the type of REFERENCE
-     */
-    kind: 'REFERENCE';
-    /**
-     * Unique identifier for the Content Document.
-     */
-    uri: string;
-}

package/dist/src/models/content-rich-text.d.ts

@@ -1,13 +0,0 @@
-/**
- * Content RichText define content as JSON Object.
- */
-export interface ContentRichText {
-    /**
-     * Define the type of Content Node
-     */
-    type?: string;
-    /**
-     * List of Content Nodes
-     */
-    content?: ContentRichText[];
-}

package/dist/src/models/content.d.ts

@@ -1,26 +0,0 @@
-import { Assets } from './assets';
-import { ContentData } from './content-data';
-import { ContentMetadata } from './content-metadata';
-import { Links } from './links';
-import { References } from './references';
-/**
- * Content defines a shared object for all possible Content Types.
- */
-export interface Content<T extends ContentData = ContentData> extends ContentMetadata {
-    /**
-     * Content Data
-     */
-    data?: T;
-    /**
-     * All links used in the content.
-     */
-    links?: Links;
-    /**
-     * All references used in the content.
-     */
-    references?: References;
-    /**
-     * All assets used in the content.
-     */
-    assets?: Assets;
-}

package/dist/src/models/links.d.ts

@@ -1,7 +0,0 @@
-import { ContentMetadata } from './content-metadata';
-/**
- * Key-Value Object. Where Key is a Unique identifier for the Content object and Value is Content Metadata.
- */
-export interface Links {
-    [key: string]: ContentMetadata;
-}

package/dist/src/models/locale.d.ts

@@ -1,10 +0,0 @@
-export interface Locale {
-    /**
-     * Unique identifier for the Locale.
-     */
-    id: string;
-    /**
-     * Name of the Locale.
-     */
-    name: string;
-}

package/dist/src/models/references.d.ts

@@ -1,7 +0,0 @@
-import { Content } from './content';
-/**
- * Key-Value Object. Where Key is a Unique identifier for the Content object and Value is Content.
- */
-export interface References {
-    [key: string]: Content;
-}