@localess/cli 3.0.1-dev.20260425203948 → 3.0.1-dev.20260426083432

package/dist/index.mjs

@@ -315,7 +315,7 @@ var D = new e("login").description("Login to Localess CLI").option("-o, --origin
 	return e.ADD_MISSING = "add-missing", e.UPDATE_EXISTING = "update-existing", e.DELETE_MISSING = "delete-missing", e;
 }({}), M = /* @__PURE__ */ function(e) {
 	return e.FLAT = "flat", e.NESTED = "nested", e;
-}({}), N = "// Generated by Localess CLI - do not edit manually\n\nexport interface ContentAsset {\n  kind: 'ASSET';\n  uri: string;\n}\n\nexport interface ContentLink {\n  kind: 'LINK';\n  target: '_blank' | '_self';\n  type: 'url' | 'content';\n  uri: string;\n}\n\nexport interface ContentReference {\n  kind: 'REFERENCE';\n  uri: string;\n}\n\nexport interface ContentRichText {\n  type?: string;\n  content?: ContentRichText[];\n}\n";
+}({}), N = "/**\n * Generated by Localess CLI\n * Do not edit manually.\n */\n\n/**\n * Content Asset define reference to a Asset.\n */\nexport interface ContentAsset {\n  /** Define the type of Asset */\n  kind: 'ASSET';\n   /** Unique identifier for the asset. */\n  uri: string;\n}\n\n/**\n * Content Link define reference to a Link.\n */\nexport interface ContentLink {\n  /** Define the type of Link */\n  kind: 'LINK';\n  /** Define the target of the link. _blank for new tab and _self for same tab. */\n  target: '_blank' | '_self';\n  /** Define the type of Link. URL for external links and Content for internal links. */\n  type: 'url' | 'content';\n  /** If type is content, then it will be Content ID. Otherwise it will be URL. */\n  uri: string;\n}\n\n/**\n * Content Reference define reference to a Content.\n */\nexport interface ContentReference {\n  /** Define the type of Reference */\n  kind: 'REFERENCE';\n  /** Unique identifier for the Content Document. */\n  uri: string;\n}\n\n/**\n * Content RichText define content as JSON Object.\n */\nexport interface ContentRichText {\n  /** Define the type of Content Node */\n  type?: string;\n  /** List of Content Nodes */\n  content?: ContentRichText[];\n}\n";
 function P(e) {
 	return e.replace(/[-_\s]+([a-zA-Z0-9])/g, (e, t) => t.toUpperCase()).replace(/^[a-z]/, (e) => e.toUpperCase());
 }
@@ -351,36 +351,41 @@ function F(e) {
 		}
 	}
 }
-function I(e) {
+function I(e, t = "") {
+	return `${t}/**\n${t} * ${e}\n${t} */`;
+}
+function L(e) {
 	let t = [N], n = [];
 	for (let [r, i] of Object.entries(e)) {
-		let e = P(r);
+		let e = P(r), a = i.description ? `${I(i.description)}\n` : "";
 		if (i.type === k.ENUM) {
 			let n = i.values ?? [];
-			if (n.length === 0) t.push(`export type ${e} = string;\n`);
+			if (n.length === 0) t.push(`${a}export type ${e} = string;\n`);
 			else {
 				let r = n.map((e) => `'${e.value}'`).join(" | ");
-				t.push(`export type ${e} = ${r};\n`);
+				t.push(`${a}export type ${e} = ${r};\n`);
 			}
 		} else {
-			let a = i;
+			let o = i;
 			i.type === k.ROOT && n.push(e);
-			let o = [
+			let s = [
+				"  /** Unique identifier of a component in a content. */",
 				"  _id: string;",
+				"  /** Unique identifier for the Schema object. */",
 				`  _schema: '${r}';`,
-				...(a.fields ?? []).map((e) => {
-					let t = F(e), n = e.required ? "" : "?";
-					return `  ${e.name}${n}: ${t};`;
+				...(o.fields ?? []).flatMap((e) => {
+					let t = F(e), n = e.required ? "" : "?", r = [];
+					return e.description && r.push(`  /** ${e.description} */`), r.push(`  ${e.name}${n}: ${t};`), r;
 				})
 			];
-			t.push(`export interface ${e} {\n${o.join("\n")}\n}\n`);
+			t.push(`${a}export interface ${e} {\n${s.join("\n")}\n}\n`);
 		}
 	}
-	return n.length > 0 ? t.push(`export type ContentData = ${n.join(" | ")};\n`) : t.push("export type ContentData = unknown;\n"), t.join("\n");
+	return t.push("/**\n* ContentData defined Object to connect all possible root Schemas.\n*/"), n.length > 0 ? t.push(`export type ContentData = ${n.join(" | ")};\n`) : t.push("export type ContentData = unknown;\n"), t.join("\n");
 }
 //#endregion
 //#region src/commands/types/generate/index.ts
-var L = s(u.cwd(), b, "localess.ts"), R = 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", L).action(async (e) => {
+var R = s(u.cwd(), b, "localess.ts"), z = 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", R).action(async (e) => {
 	console.log("Types in with options:", e);
 	let t = await w();
 	if (!t.isLoggedIn) {
@@ -395,17 +400,17 @@ var L = s(u.cwd(), b, "localess.ts"), R = new e("generate").description("Generat
 	console.log("Fetching schemas from Localess...");
 	let r = await n.getSchemas();
 	console.log("Generating types...");
-	let i = I(r);
+	let i = L(r);
 	await x(e.path, i), console.log(`Types written to ${e.path}`);
-}), z = new e("types").description("Generate types for your schemas").addCommand(R), B = d.record(d.string(), d.string()), V = d.enum(["add-missing", "update-existing"]);
+}), B = new e("types").description("Generate types for your schemas").addCommand(z), V = d.record(d.string(), d.string()), H = d.enum(["add-missing", "update-existing"]);
 d.object({
-	type: V,
-	values: B
+	type: H,
+	values: V
 });
 //#endregion
 //#region src/commands/translations/push/index.ts
-var H = 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(M)}`, M.FLAT).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(j)}`, j.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), !V.safeParse(t.type).success) {
+var U = 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(M)}`, M.FLAT).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(j)}`, j.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), !H.safeParse(t.type).success) {
 		console.error("Invalid type provided. Possible values are :", Object.values(j));
 		return;
 	}
@@ -420,7 +425,7 @@ var H = new e("push").argument("<locale>", "Locale to push").description("Push l
 		token: n.token
 	});
 	t.dryRun && console.warn("Dry run mode enabled: No changes will be made."), t.format === M.NESTED && console.error("Nested format is not implemented yet. Please use flat format for now."), console.log("Reading translations file from:", t.path);
-	let i = await S(t.path), a = JSON.parse(i), o = B.safeParse(a);
+	let i = await S(t.path), a = JSON.parse(i), o = V.safeParse(a);
 	if (!o.success) {
 		console.error("Invalid translations file format:", o.error);
 		return;
@@ -428,7 +433,7 @@ var H = 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 s = await r.updateTranslations(e, t.type, a, t.dryRun);
 	s ? (s.dryRun && console.log("Dry run results:"), console.log("Successfully pushed translations to Localess"), console.log("Summary:", s.message), s.ids && console.log("Updated translation IDs:", s.ids)) : console.log("Something went wrong while pushing translations to Localess");
-}), U = 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(M)}`, M.FLAT).action(async (e, t) => {
+}), W = 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(M)}`, M.FLAT).action(async (e, t) => {
 	if (console.log("Pulling translations with arguments:", e), console.log("Pulling translations with options:", t), !Object.values(M).includes(t.format)) {
 		console.error("Invalid format provided. Possible values are :", Object.values(M));
 		return;
@@ -451,12 +456,12 @@ var H = new e("push").argument("<locale>", "Locale to push").description("Push l
 		await x(t.path, JSON.stringify(e, null, 2));
 	}
 	console.log("Successfully saved translations from Localess");
-}), W = new e("translations").description("Manage translations").addCommand(H).addCommand(U), G = new e();
-G.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.6"), G.addCommand(D), G.addCommand(O), G.addCommand(W), G.addCommand(z);
+}), G = new e("translations").description("Manage translations").addCommand(U).addCommand(W), K = new e();
+K.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.6"), K.addCommand(D), K.addCommand(O), K.addCommand(G), K.addCommand(B);
 //#endregion
 //#region src/index.ts
 try {
-	G.parse(process.argv);
+	K.parse(process.argv);
 } catch (e) {
 	console.error("Error executing command:", e instanceof Error ? e.message : e), process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/cli",
-  "version": "3.0.1-dev.20260425203948",
+  "version": "3.0.1-dev.20260426083432",
   "description": "Localess Command Line.",
   "keywords": [
     "localess",