@localess/cli 0.0.1-dev.20260220221945 → 0.0.1-dev.20260221224153

package/README.md

@@ -13,8 +13,8 @@ A powerful CLI tool to interact with your Localess spaces.
 ## Features
 
 - 🔐 **Authentication** - Secure login system and CI environments.
-- 🛡️ **Type Safety** - Generate TypeScript type definitions for your Localess content schemas, ensuring type safety in your frontend applications.
 - 🌐 **Translations** - Sync and manage translations for your Localess space.
+- 🛡️ **Type Safety** - Generate TypeScript type definitions for your Localess content schemas, ensuring type safety in your frontend applications.
 
 ## Setup
 
@@ -45,17 +45,43 @@ The CLI provides a `logout` command to clear your authentication token and log y
 localess logout
 ```
 
+## Translations Management
+
+The CLI provides a `translations` command with `push` and `pull` subcommands to sync and manage translations for your Localess space.
+
+### Push Translations
+Push local translation files to Localess.
+
+```bash
+localess translations push <locale> --path <file> [--format <flat|nested>] [--type <add-missing|replace>]
+```
+- `<locale>`: Locale code (e.g., `en`)
+- `--path`: Path to the translations file to push (required)
+- `--format`: File format (`flat` or `nested`, default: `flat`). **Note:** Only `flat` format is currently supported for push.
+- `--type`: Push type (`add-missing`, `replace`, etc., default: `add-missing`)
+
+### Pull Translations
+Pull translations from Localess and save locally.
+
+```bash
+localess translations pull <locale> --path <file> [--format <flat|nested>]
+```
+- `<locale>`: Locale code (e.g., `en`)
+- `--path`: Path where the translations file will be saved (required)
+- `--format`: File format (`flat` or `nested`, default: `flat`)
+
 ## Generate TypeScript Types
 
-The CLI provides a `types` command to generate TypeScript definitions for your Localess content schemas. This command fetches your space's OpenAPI schema and writes a `localess.d.ts` file to your project, allowing for strong typing in your codebase.
+The CLI provides a `types generate` command to generate TypeScript definitions for your Localess content schemas. This command fetches your space's OpenAPI schema and writes a `localess.d.ts` file to your project, allowing for strong typing in your codebase.
 
 ### Usage
 
 ```bash
-localess types
+localess types generate [--path <output_file>]
 ```
+- `--path`: Path to the file where to save the generated types. Default is `.localess/localess.d.ts` in your current working directory.
 
 - You must be logged in (`localess login`) before running this command.
-- The generated types file will be saved as `./.localess/localess.d.ts` in your current working directory.
+- The generated types file will be saved as `./.localess/localess.d.ts` by default.
 
 You can then import these types in your TypeScript project for improved type safety when working with Localess content.

package/dist/index.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/program.ts
-var import_commander7 = require("commander");
+var import_commander8 = require("commander");
 
 // src/commands/login/index.ts
 var import_commander = require("commander");
@@ -32,6 +32,24 @@ var import_commander = require("commander");
 // src/utils.ts
 var RESET = "\x1B[0m";
 var FG_BLUE = "\x1B[34m";
+function dotToNestedObject(input) {
+  const result = {};
+  for (const [key, value] of Object.entries(input)) {
+    const parts = key.split(".");
+    let current = result;
+    for (let i = 0; i < parts.length; i++) {
+      if (i === parts.length - 1) {
+        current[parts[i]] = value;
+      } else {
+        if (!(parts[i] in current)) {
+          current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+      }
+    }
+  }
+  return result;
+}
 
 // src/cache.ts
 var NoCache = class {
@@ -509,7 +527,7 @@ var import_openapi_typescript = __toESM(require("openapi-typescript"));
 var import_node_path3 = require("path");
 var import_node_process = __toESM(require("process"));
 var TYPES_PATH = (0, import_node_path3.join)(import_node_process.default.cwd(), DEFAULT_CONFIG_DIR, "localess.d.ts");
-var typesGenerateCommand = new import_commander3.Command("generate").description("Generate types for your schemas").option("-f, --file <path>", "Path to the file where to save the generated types. Default is .localess/localess.d.ts", TYPES_PATH).action(async (options) => {
+var typesGenerateCommand = new import_commander3.Command("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.d.ts", TYPES_PATH).action(async (options) => {
   console.log("Types in with options:", options);
   const session = await getSession();
   if (!session.isLoggedIn) {
@@ -533,8 +551,8 @@ var typesGenerateCommand = new import_commander3.Command("generate").description
     };
     const ast = await (0, import_openapi_typescript.default)(minimalSpec, { exportType: true, rootTypes: true, rootTypesNoSchemaPrefix: true });
     const contents = (0, import_openapi_typescript.astToString)(ast);
-    await writeFile(options.file, contents);
-    console.log(`Types generated successfully at ${options.file}`);
+    await writeFile(options.path, contents);
+    console.log(`Types generated successfully at ${options.path}`);
   } catch (e) {
     console.error(e);
   }
@@ -544,7 +562,7 @@ var typesGenerateCommand = new import_commander3.Command("generate").description
 var typesCommand = new import_commander4.Command("types").description("Generate types for your schemas").addCommand(typesGenerateCommand);
 
 // src/commands/translations/index.ts
-var import_commander6 = require("commander");
+var import_commander7 = require("commander");
 
 // src/commands/translations/push/index.ts
 var import_commander5 = require("commander");
@@ -555,6 +573,11 @@ var TranslationUpdateType = /* @__PURE__ */ ((TranslationUpdateType2) => {
   TranslationUpdateType2["UPDATE_EXISTING"] = "update-existing";
   return TranslationUpdateType2;
 })(TranslationUpdateType || {});
+var TranslationFileFormat = /* @__PURE__ */ ((TranslationFileFormat2) => {
+  TranslationFileFormat2["FLAT"] = "flat";
+  TranslationFileFormat2["NESTED"] = "nested";
+  return TranslationFileFormat2;
+})(TranslationFileFormat || {});
 
 // src/models/translation.zod.ts
 var import_zod = require("zod");
@@ -566,7 +589,7 @@ var zTranslationUpdateSchema = import_zod.z.object({
 });
 
 // src/commands/translations/push/index.ts
-var translationsPushCommand = new import_commander5.Command("push").argument("<locale>", "Locale to push").description("Push locale translations to Localess").requiredOption("-f, --file <path>", "Path to the translations file to push").option("-t, --type <type>", `Push type. Possible values are : ${Object.values(TranslationUpdateType)}`, "add-missing" /* ADD_MISSING */).action(async (locale, options) => {
+var translationsPushCommand = new import_commander5.Command("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(TranslationFileFormat)}`, "flat" /* FLAT */).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(TranslationUpdateType)}`, "add-missing" /* ADD_MISSING */).action(async (locale, options) => {
   console.log("Pushing translations with arguments:", locale);
   console.log("Pushing translations with options:", options);
   if (!zTranslationUpdateTypeSchema.safeParse(options.type).success) {
@@ -584,8 +607,11 @@ var translationsPushCommand = new import_commander5.Command("push").argument("<l
     spaceId: session.space,
     token: session.token
   });
-  console.log("Reading translations file from:", options.file);
-  const fileContent = await readFile(options.file);
+  if (options.format === "nested" /* NESTED */) {
+    console.error("Nested format is not implemented yet. Please use flat format for now.");
+  }
+  console.log("Reading translations file from:", options.path);
+  const fileContent = await readFile(options.path);
   const translationValues = JSON.parse(fileContent);
   const pResult = zLocaleTranslationsSchema.safeParse(translationValues);
   if (!pResult.success) {
@@ -605,11 +631,43 @@ var translationsPushCommand = new import_commander5.Command("push").argument("<l
   }
 });
 
+// src/commands/translations/pull/index.ts
+var import_commander6 = require("commander");
+var translationsPullCommand = new import_commander6.Command("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(TranslationFileFormat)}`, "flat" /* FLAT */).action(async (locale, options) => {
+  console.log("Pulling translations with arguments:", locale);
+  console.log("Pulling translations with options:", options);
+  if (!Object.values(TranslationFileFormat).includes(options.format)) {
+    console.error("Invalid format provided. Possible values are :", Object.values(TranslationFileFormat));
+    return;
+  }
+  const session = await getSession();
+  if (!session.isLoggedIn) {
+    console.error("Not logged in");
+    console.error('Please log in first using "localess login" command');
+    return;
+  }
+  const client = localessClient({
+    origin: session.origin,
+    spaceId: session.space,
+    token: session.token
+  });
+  console.log("Pulling translations from Localess for locale:", locale);
+  const translations = await client.getTranslations(locale);
+  console.log("Saving translations in file:", options.path);
+  if (options.format === "flat" /* FLAT */) {
+    await writeFile(options.path, JSON.stringify(translations, null, 2));
+  } else if (options.format === "nested" /* NESTED */) {
+    const nestedTranslations = dotToNestedObject(translations);
+    await writeFile(options.path, JSON.stringify(nestedTranslations, null, 2));
+  }
+  console.log("Successfully saved translations from Localess");
+});
+
 // src/commands/translations/index.ts
-var translationsCommand = new import_commander6.Command("translations").description("Manage translations").addCommand(translationsPushCommand);
+var translationsCommand = new import_commander7.Command("translations").description("Manage translations").addCommand(translationsPushCommand).addCommand(translationsPullCommand);
 
 // src/program.ts
-var program = new import_commander7.Command();
+var program = new import_commander8.Command();
 program.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.1");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/program.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/commands/login/index.ts
 import { Command } from "commander";
@@ -9,6 +9,24 @@ import { Command } from "commander";
 // src/utils.ts
 var RESET = "\x1B[0m";
 var FG_BLUE = "\x1B[34m";
+function dotToNestedObject(input) {
+  const result = {};
+  for (const [key, value] of Object.entries(input)) {
+    const parts = key.split(".");
+    let current = result;
+    for (let i = 0; i < parts.length; i++) {
+      if (i === parts.length - 1) {
+        current[parts[i]] = value;
+      } else {
+        if (!(parts[i] in current)) {
+          current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+      }
+    }
+  }
+  return result;
+}
 
 // src/cache.ts
 var NoCache = class {
@@ -486,7 +504,7 @@ import openapiTS, { astToString } from "openapi-typescript";
 import { join as join2 } from "path";
 import process3 from "process";
 var TYPES_PATH = join2(process3.cwd(), DEFAULT_CONFIG_DIR, "localess.d.ts");
-var typesGenerateCommand = new Command3("generate").description("Generate types for your schemas").option("-f, --file <path>", "Path to the file where to save the generated types. Default is .localess/localess.d.ts", TYPES_PATH).action(async (options) => {
+var typesGenerateCommand = new Command3("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.d.ts", TYPES_PATH).action(async (options) => {
   console.log("Types in with options:", options);
   const session = await getSession();
   if (!session.isLoggedIn) {
@@ -510,8 +528,8 @@ var typesGenerateCommand = new Command3("generate").description("Generate types
     };
     const ast = await openapiTS(minimalSpec, { exportType: true, rootTypes: true, rootTypesNoSchemaPrefix: true });
     const contents = astToString(ast);
-    await writeFile(options.file, contents);
-    console.log(`Types generated successfully at ${options.file}`);
+    await writeFile(options.path, contents);
+    console.log(`Types generated successfully at ${options.path}`);
   } catch (e) {
     console.error(e);
   }
@@ -521,7 +539,7 @@ var typesGenerateCommand = new Command3("generate").description("Generate types
 var typesCommand = new Command4("types").description("Generate types for your schemas").addCommand(typesGenerateCommand);
 
 // src/commands/translations/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/translations/push/index.ts
 import { Command as Command5 } from "commander";
@@ -532,6 +550,11 @@ var TranslationUpdateType = /* @__PURE__ */ ((TranslationUpdateType2) => {
   TranslationUpdateType2["UPDATE_EXISTING"] = "update-existing";
   return TranslationUpdateType2;
 })(TranslationUpdateType || {});
+var TranslationFileFormat = /* @__PURE__ */ ((TranslationFileFormat2) => {
+  TranslationFileFormat2["FLAT"] = "flat";
+  TranslationFileFormat2["NESTED"] = "nested";
+  return TranslationFileFormat2;
+})(TranslationFileFormat || {});
 
 // src/models/translation.zod.ts
 import { z } from "zod";
@@ -543,7 +566,7 @@ var zTranslationUpdateSchema = z.object({
 });
 
 // src/commands/translations/push/index.ts
-var translationsPushCommand = new Command5("push").argument("<locale>", "Locale to push").description("Push locale translations to Localess").requiredOption("-f, --file <path>", "Path to the translations file to push").option("-t, --type <type>", `Push type. Possible values are : ${Object.values(TranslationUpdateType)}`, "add-missing" /* ADD_MISSING */).action(async (locale, options) => {
+var translationsPushCommand = new Command5("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(TranslationFileFormat)}`, "flat" /* FLAT */).option("-t, --type <type>", `Push type. Possible values are : ${Object.values(TranslationUpdateType)}`, "add-missing" /* ADD_MISSING */).action(async (locale, options) => {
   console.log("Pushing translations with arguments:", locale);
   console.log("Pushing translations with options:", options);
   if (!zTranslationUpdateTypeSchema.safeParse(options.type).success) {
@@ -561,8 +584,11 @@ var translationsPushCommand = new Command5("push").argument("<locale>", "Locale
     spaceId: session.space,
     token: session.token
   });
-  console.log("Reading translations file from:", options.file);
-  const fileContent = await readFile(options.file);
+  if (options.format === "nested" /* NESTED */) {
+    console.error("Nested format is not implemented yet. Please use flat format for now.");
+  }
+  console.log("Reading translations file from:", options.path);
+  const fileContent = await readFile(options.path);
   const translationValues = JSON.parse(fileContent);
   const pResult = zLocaleTranslationsSchema.safeParse(translationValues);
   if (!pResult.success) {
@@ -582,11 +608,43 @@ var translationsPushCommand = new Command5("push").argument("<locale>", "Locale
   }
 });
 
+// src/commands/translations/pull/index.ts
+import { Command as Command6 } from "commander";
+var translationsPullCommand = new Command6("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(TranslationFileFormat)}`, "flat" /* FLAT */).action(async (locale, options) => {
+  console.log("Pulling translations with arguments:", locale);
+  console.log("Pulling translations with options:", options);
+  if (!Object.values(TranslationFileFormat).includes(options.format)) {
+    console.error("Invalid format provided. Possible values are :", Object.values(TranslationFileFormat));
+    return;
+  }
+  const session = await getSession();
+  if (!session.isLoggedIn) {
+    console.error("Not logged in");
+    console.error('Please log in first using "localess login" command');
+    return;
+  }
+  const client = localessClient({
+    origin: session.origin,
+    spaceId: session.space,
+    token: session.token
+  });
+  console.log("Pulling translations from Localess for locale:", locale);
+  const translations = await client.getTranslations(locale);
+  console.log("Saving translations in file:", options.path);
+  if (options.format === "flat" /* FLAT */) {
+    await writeFile(options.path, JSON.stringify(translations, null, 2));
+  } else if (options.format === "nested" /* NESTED */) {
+    const nestedTranslations = dotToNestedObject(translations);
+    await writeFile(options.path, JSON.stringify(nestedTranslations, null, 2));
+  }
+  console.log("Successfully saved translations from Localess");
+});
+
 // src/commands/translations/index.ts
-var translationsCommand = new Command6("translations").description("Manage translations").addCommand(translationsPushCommand);
+var translationsCommand = new Command7("translations").description("Manage translations").addCommand(translationsPushCommand).addCommand(translationsPullCommand);
 
 // src/program.ts
-var program = new Command7();
+var program = new Command8();
 program.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.1");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/cli",
-  "version": "0.0.1-dev.20260220221945",
+  "version": "0.0.1-dev.20260221224153",
   "description": "Localess Command Line.",
   "keywords": [
     "localess",