@localess/cli 0.0.1-dev.20260221221032 → 0.0.1-dev.20260222000532

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`, `update-existing`, `delete-missing`. 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

@@ -527,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) {
@@ -551,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);
   }
@@ -571,6 +571,7 @@ var import_commander5 = require("commander");
 var TranslationUpdateType = /* @__PURE__ */ ((TranslationUpdateType2) => {
   TranslationUpdateType2["ADD_MISSING"] = "add-missing";
   TranslationUpdateType2["UPDATE_EXISTING"] = "update-existing";
+  TranslationUpdateType2["DELETE_MISSING"] = "delete-missing";
   return TranslationUpdateType2;
 })(TranslationUpdateType || {});
 var TranslationFileFormat = /* @__PURE__ */ ((TranslationFileFormat2) => {

package/dist/index.mjs

@@ -504,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) {
@@ -528,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);
   }
@@ -548,6 +548,7 @@ import { Command as Command5 } from "commander";
 var TranslationUpdateType = /* @__PURE__ */ ((TranslationUpdateType2) => {
   TranslationUpdateType2["ADD_MISSING"] = "add-missing";
   TranslationUpdateType2["UPDATE_EXISTING"] = "update-existing";
+  TranslationUpdateType2["DELETE_MISSING"] = "delete-missing";
   return TranslationUpdateType2;
 })(TranslationUpdateType || {});
 var TranslationFileFormat = /* @__PURE__ */ ((TranslationFileFormat2) => {

package/package.json

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