@localess/cli 0.0.1-dev.20260216094809

package/README.md

@@ -0,0 +1,62 @@
+<br/>
+<br/>
+<img src="https://github.com/Lessify/localess/wiki/img/logo-adaptive.svg" alt="logo">
+<br/>
+<br/>
+
+----
+
+# Localess Command Line
+
+This client SDK is designed to work with the Localess API. It provides a simple way to interact with the Localess API from your JavaScript or TypeScript application.
+
+> **Important:** 
+> The Client is designed to be used on the server side only, as it requires your **Localess API Token** to be kept secret.
+> Do not use this client in your frontend application, as it exposes your API Token to the public.
+
+## Installation
+
+### NPM
+````bash
+npm install @localess/js-client@latest
+````
+
+### Yarn
+````bash
+yarn add @localess/js-client@latest
+````
+
+## Client
+
+````ts
+import {localessClient} from "@localess/js-client";
+
+const llClient = localessClient({
+  // A fully qualified domain name with protocol (http/https) and port.
+  origin: 'https://my-localess.web.app',
+  // Localess space ID, cna be found in the Localess Space settings
+  spaceId: 'I1LoVe2LocaLess4Rever',
+  // Localess API token, can be found in the Localess Space settings
+  token: 'Baz00KaT0KeN8S3CureLL'
+});
+
+// Fetch all Content Links
+llClient.getLinks()
+// Fetch content by SLUG
+llClient.getContentBySlug('docs/overview')
+// Fetch content by ID
+llClient.getContentById('FRnIT7CUABoRCdSVVGGs')
+// Fetch translations by locale
+llClient.getTranslations('en') 
+````
+
+## Sync with Visual Editor
+
+It will automatically inject Localess Sync Script in to the HTML page.
+
+````ts
+import {loadLocalessSync} from "@localess/js-client";
+
+// A fully qualified domain name with protocol (http/https) and port.
+loadLocalessSync('https://my-localess.web.app')
+````

package/dist/index.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,517 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/program.ts
+var import_commander4 = require("commander");
+
+// src/commands/login/index.ts
+var import_commander = require("commander");
+
+// src/utils.ts
+var RESET = "\x1B[0m";
+var FG_BLUE = "\x1B[34m";
+
+// src/cache.ts
+var NoCache = class {
+  set(key, value) {
+  }
+  get(key) {
+    return void 0;
+  }
+  has(key) {
+    return false;
+  }
+};
+var TTLCache = class {
+  /**
+   * Creates a TTLCache with a specified time-to-live (TTL) for each entry.
+   * default is 5 minutes (300000 ms).
+   * @param ttlMs
+   */
+  constructor(ttlMs = 3e5) {
+    this.ttlMs = ttlMs;
+  }
+  cache = /* @__PURE__ */ new Map();
+  set(key, value) {
+    this.cache.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+};
+
+// src/client.ts
+var LOG_GROUP = `${FG_BLUE}[Localess:Client]${RESET}`;
+function localessClient(options) {
+  if (options.debug) {
+    console.log(LOG_GROUP, "Client Options : ", options);
+  }
+  const fetchOptions = {
+    redirect: "follow",
+    headers: {
+      "Content-Type": "application/json",
+      "Accept": "application/json",
+      "X-Localess-Agent": "Localess-CLI-Client",
+      "X-Localess-Agent-Version": "0.9.0"
+    }
+  };
+  const cache = options.cacheTTL === false ? new NoCache() : new TTLCache(options.cacheTTL);
+  return {
+    async getSpace() {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getSpace()");
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getSpace fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getSpace cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getSpace status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getSpace error : ", error);
+        return {};
+      }
+    },
+    async getLinks(params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getLinks() params : ", JSON.stringify(params));
+      }
+      let kind = "";
+      if (params?.kind) {
+        kind = `&kind=${params.kind}`;
+      }
+      let parentSlug = "";
+      if (params?.parentSlug) {
+        parentSlug = `&parentSlug=${params.parentSlug}`;
+      }
+      let excludeChildren = "";
+      if (params?.excludeChildren) {
+        excludeChildren = `&excludeChildren=${params.excludeChildren}`;
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/links?token=${options.token}${kind}${parentSlug}${excludeChildren}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getLinks fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getLinks cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getLinks status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getLinks error : ", error);
+        return {};
+      }
+    },
+    async getContentBySlug(slug, params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentBySlug() slug : ", slug);
+        console.log(LOG_GROUP, "getContentBySlug() params : ", JSON.stringify(params));
+      }
+      let version = "";
+      if (options?.version && options.version == "draft") {
+        version = `&version=${options.version}`;
+      }
+      if (params?.version && params.version == "draft") {
+        version = `&version=${params.version}`;
+      }
+      const locale = params?.locale ? `&locale=${params.locale}` : "";
+      const resolveReference = params?.resolveReference ? `&resolveReference=${params.resolveReference}` : "";
+      const resolveLink = params?.resolveLink ? `&resolveLink=${params.resolveLink}` : "";
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/contents/slugs/${slug}?token=${options.token}${version}${locale}${resolveReference}${resolveLink}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentBySlug fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentBySlug cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentBySlug status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getContentBySlug error : ", error);
+        return {};
+      }
+    },
+    async getContentById(id, params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentById() id : ", id);
+        console.log(LOG_GROUP, "getContentById() params : ", JSON.stringify(params));
+      }
+      let version = "";
+      if (options?.version && options.version == "draft") {
+        version = `&version=${options.version}`;
+      }
+      if (params?.version && params.version == "draft") {
+        version = `&version=${params.version}`;
+      }
+      const locale = params?.locale ? `&locale=${params.locale}` : "";
+      const resolveReference = params?.resolveReference ? `&resolveReference=${params.resolveReference}` : "";
+      const resolveLink = params?.resolveLink ? `&resolveLink=${params.resolveLink}` : "";
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/contents/${id}?token=${options.token}${version}${locale}${resolveReference}${resolveLink}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentById fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentById cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentById status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getContentById error : ", error);
+        return {};
+      }
+    },
+    async getTranslations(locale) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getTranslations() locale : ", locale);
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/translations/${locale}?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getTranslations fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getTranslations error : ", error);
+        return {};
+      }
+    },
+    async updateTranslations(locale, type, values) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "updateTranslations() locale : ", locale);
+        console.log(LOG_GROUP, "updateTranslations() type : ", type);
+        console.log(LOG_GROUP, "updateTranslations() values : ", JSON.stringify(values));
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/translations/${locale}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "updateTranslations fetch url : ", url);
+      }
+      const body = {
+        type,
+        values
+      };
+      try {
+        const response = await fetch(url, {
+          ...fetchOptions,
+          method: "POST",
+          headers: {
+            "X-API-KEY": options.token
+          },
+          body: JSON.stringify(body)
+        });
+        if (options.debug) {
+          console.log(LOG_GROUP, "updateTranslations status : ", response.status);
+        }
+      } catch (error) {
+        console.error(LOG_GROUP, "updateTranslations error : ", error);
+      }
+    },
+    async getOpenApi() {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getOpenApi()");
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/open-api?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getOpenApi fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getOpenApi status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getOpenApi error : ", error);
+        return {};
+      }
+    },
+    syncScriptUrl() {
+      return `${options.origin}/scripts/sync-v1.js`;
+    },
+    assetLink(asset) {
+      if (typeof asset === "string") {
+        return `${options.origin}/api/v1/spaces/${options.spaceId}/assets/${asset}`;
+      } else {
+        return `${options.origin}/api/v1/spaces/${options.spaceId}/assets/${asset.uri}`;
+      }
+    }
+  };
+}
+
+// src/session.ts
+var import_promises2 = require("fs/promises");
+var import_node_path2 = require("path");
+var process2 = __toESM(require("process"));
+
+// src/file.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var DEFAULT_CONFIG_DIR = ".localess";
+async function writeToFile(filePath, data, option) {
+  const resolvedPath = (0, import_node_path.parse)(filePath).dir;
+  try {
+    await (0, import_promises.mkdir)(resolvedPath, { recursive: true });
+  } catch (mkdirError) {
+    return;
+  }
+  try {
+    await (0, import_promises.writeFile)(filePath, data, option);
+  } catch (writeError) {
+  }
+}
+
+// src/session.ts
+var CREDENTIALS_PATH = (0, import_node_path2.join)(process2.cwd(), DEFAULT_CONFIG_DIR, "credentials.json");
+async function getSession() {
+  let session = {
+    isLoggedIn: false
+  };
+  const token = process2.env.LOCALESS_TOKEN;
+  const space = process2.env.LOCALESS_SPACE;
+  const origin = process2.env.LOCALESS_ORIGIN;
+  if (token && space && origin) {
+    console.debug(`Login in using environment variables.`);
+    return {
+      isLoggedIn: true,
+      space,
+      origin,
+      token,
+      method: "env"
+    };
+  }
+  try {
+    await (0, import_promises2.access)(CREDENTIALS_PATH);
+    const content = await (0, import_promises2.readFile)(CREDENTIALS_PATH, "utf8");
+    const parsedContent = JSON.parse(content);
+    if (Object.keys(parsedContent).length === 0) {
+      return session;
+    }
+    if (parsedContent.origin && parsedContent.token && parsedContent.space) {
+      console.debug(`Login in using credentials file.`);
+      return {
+        isLoggedIn: true,
+        space: parsedContent.space,
+        origin: parsedContent.origin,
+        token: parsedContent.token,
+        method: "file"
+      };
+    }
+  } catch (e) {
+    console.error('No credentials found. Please log in using the "localess login" command.');
+  }
+  console.debug("Not logged in.");
+  return session;
+}
+async function persistSession(data) {
+  if (data.origin && data.token && data.space) {
+    await writeToFile(CREDENTIALS_PATH, JSON.stringify(data, null, 2), { mode: 384 });
+    console.log("Add session credentials to file system.");
+    console.log("Add .localess to .gitignore to avoid committing them to your repository.");
+  } else {
+    throw new Error("Cannot persist session: missing required fields.");
+  }
+}
+async function clearSession() {
+  try {
+    await (0, import_promises2.access)(CREDENTIALS_PATH);
+    await writeToFile(CREDENTIALS_PATH, "{}", { mode: 384 });
+  } catch (error) {
+    throw new Error("Failed to clear session credentials.");
+  }
+}
+
+// src/commands/login/index.ts
+var loginCommand = new import_commander.Command("login").description("Login to Localess CLI").option("-t, --token <token>", "Token to login to Localess CLI").option("-s, --space <space>", "Space ID to login to").option("-o, --origin <origin>", "Origin of the Localess instance").action(async (options) => {
+  console.log("Logging in with options:", options);
+  const session = await getSession();
+  if (session.isLoggedIn && session.method === "file") {
+    console.log('Already logged in. If you want to log in with different credentials, please log out first using "localess logout" command.');
+    return;
+  }
+  if (options.origin && options.space && options.token) {
+    const client = localessClient({
+      origin: options.origin,
+      spaceId: options.space,
+      token: options.token
+    });
+    try {
+      const space = await client.getSpace();
+      console.log(`Successfully logged in to space: ${space.name} (${space.id})`);
+      await persistSession({
+        origin: options.origin,
+        space: options.space,
+        token: options.token
+      });
+    } catch (e) {
+      console.error("Login failed");
+    }
+  } else if (session.isLoggedIn && session.method === "env") {
+    console.log("Already logged in with environment variables.");
+    console.log("If you want to log in with different credentials, Please provide all required options: --origin, --space, and --token");
+  } else {
+    console.log("Please provide all required options: --origin, --space, and --token");
+    console.log("Or set the following environment variables: LOCALESS_ORIGIN, LOCALESS_SPACE, and LOCALESS_TOKEN");
+  }
+});
+
+// src/commands/logout/index.ts
+var import_commander2 = require("commander");
+var logoutCommand = new import_commander2.Command("logout").description("Logout from Localess CLI").action(async () => {
+  console.log("Logging out...");
+  const session = await getSession();
+  if (!session.isLoggedIn) {
+    console.log("Not currently logged in.");
+    return;
+  }
+  if (session.method === "env") {
+    console.log("You are logged in using environment variables. To log out, unset LOCALESS_TOKEN, LOCALESS_SPACE, and LOCALESS_ORIGIN.");
+    return;
+  }
+  try {
+    await clearSession();
+    console.log("Successfully logged out.");
+  } catch (e) {
+    console.error("Failed to log out:", e);
+  }
+});
+
+// src/commands/types/index.ts
+var import_commander3 = require("commander");
+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 typesCommand = new import_commander3.Command("types").description("Generate types for your schemas").action(async (options) => {
+  console.log("Types in with options:", options);
+  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("Fetching OpenAPI specification from Localess...");
+  const specification = await client.getOpenApi();
+  console.log("Generating types from OpenAPI specification...");
+  try {
+    const minimalSpec = {
+      openapi: "3.0.0",
+      info: { title: "Schemas Only", version: "1.0.0" },
+      components: { schemas: specification.components?.schemas || {} }
+    };
+    const ast = await (0, import_openapi_typescript.default)(minimalSpec, { exportType: true, rootTypes: true, rootTypesNoSchemaPrefix: true });
+    const contents = (0, import_openapi_typescript.astToString)(ast);
+    await writeToFile(TYPES_PATH, contents);
+    console.log(`Types generated successfully at ${TYPES_PATH}`);
+  } catch (e) {
+    console.error(e);
+  }
+});
+
+// src/program.ts
+var program = new import_commander4.Command();
+program.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.1");
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(typesCommand);
+
+// src/index.ts
+try {
+  program.parse(process.argv);
+} catch (e) {
+  console.error("Error executing command:", e instanceof Error ? e.message : e);
+  process.exit(1);
+}

package/dist/index.mjs

@@ -0,0 +1,494 @@
+#!/usr/bin/env node
+
+// src/program.ts
+import { Command as Command4 } from "commander";
+
+// src/commands/login/index.ts
+import { Command } from "commander";
+
+// src/utils.ts
+var RESET = "\x1B[0m";
+var FG_BLUE = "\x1B[34m";
+
+// src/cache.ts
+var NoCache = class {
+  set(key, value) {
+  }
+  get(key) {
+    return void 0;
+  }
+  has(key) {
+    return false;
+  }
+};
+var TTLCache = class {
+  /**
+   * Creates a TTLCache with a specified time-to-live (TTL) for each entry.
+   * default is 5 minutes (300000 ms).
+   * @param ttlMs
+   */
+  constructor(ttlMs = 3e5) {
+    this.ttlMs = ttlMs;
+  }
+  cache = /* @__PURE__ */ new Map();
+  set(key, value) {
+    this.cache.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+};
+
+// src/client.ts
+var LOG_GROUP = `${FG_BLUE}[Localess:Client]${RESET}`;
+function localessClient(options) {
+  if (options.debug) {
+    console.log(LOG_GROUP, "Client Options : ", options);
+  }
+  const fetchOptions = {
+    redirect: "follow",
+    headers: {
+      "Content-Type": "application/json",
+      "Accept": "application/json",
+      "X-Localess-Agent": "Localess-CLI-Client",
+      "X-Localess-Agent-Version": "0.9.0"
+    }
+  };
+  const cache = options.cacheTTL === false ? new NoCache() : new TTLCache(options.cacheTTL);
+  return {
+    async getSpace() {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getSpace()");
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getSpace fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getSpace cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getSpace status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getSpace error : ", error);
+        return {};
+      }
+    },
+    async getLinks(params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getLinks() params : ", JSON.stringify(params));
+      }
+      let kind = "";
+      if (params?.kind) {
+        kind = `&kind=${params.kind}`;
+      }
+      let parentSlug = "";
+      if (params?.parentSlug) {
+        parentSlug = `&parentSlug=${params.parentSlug}`;
+      }
+      let excludeChildren = "";
+      if (params?.excludeChildren) {
+        excludeChildren = `&excludeChildren=${params.excludeChildren}`;
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/links?token=${options.token}${kind}${parentSlug}${excludeChildren}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getLinks fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getLinks cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getLinks status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getLinks error : ", error);
+        return {};
+      }
+    },
+    async getContentBySlug(slug, params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentBySlug() slug : ", slug);
+        console.log(LOG_GROUP, "getContentBySlug() params : ", JSON.stringify(params));
+      }
+      let version = "";
+      if (options?.version && options.version == "draft") {
+        version = `&version=${options.version}`;
+      }
+      if (params?.version && params.version == "draft") {
+        version = `&version=${params.version}`;
+      }
+      const locale = params?.locale ? `&locale=${params.locale}` : "";
+      const resolveReference = params?.resolveReference ? `&resolveReference=${params.resolveReference}` : "";
+      const resolveLink = params?.resolveLink ? `&resolveLink=${params.resolveLink}` : "";
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/contents/slugs/${slug}?token=${options.token}${version}${locale}${resolveReference}${resolveLink}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentBySlug fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentBySlug cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentBySlug status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getContentBySlug error : ", error);
+        return {};
+      }
+    },
+    async getContentById(id, params) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentById() id : ", id);
+        console.log(LOG_GROUP, "getContentById() params : ", JSON.stringify(params));
+      }
+      let version = "";
+      if (options?.version && options.version == "draft") {
+        version = `&version=${options.version}`;
+      }
+      if (params?.version && params.version == "draft") {
+        version = `&version=${params.version}`;
+      }
+      const locale = params?.locale ? `&locale=${params.locale}` : "";
+      const resolveReference = params?.resolveReference ? `&resolveReference=${params.resolveReference}` : "";
+      const resolveLink = params?.resolveLink ? `&resolveLink=${params.resolveLink}` : "";
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/contents/${id}?token=${options.token}${version}${locale}${resolveReference}${resolveLink}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getContentById fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentById cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getContentById status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getContentById error : ", error);
+        return {};
+      }
+    },
+    async getTranslations(locale) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getTranslations() locale : ", locale);
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/translations/${locale}?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getTranslations fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getTranslations error : ", error);
+        return {};
+      }
+    },
+    async updateTranslations(locale, type, values) {
+      if (options.debug) {
+        console.log(LOG_GROUP, "updateTranslations() locale : ", locale);
+        console.log(LOG_GROUP, "updateTranslations() type : ", type);
+        console.log(LOG_GROUP, "updateTranslations() values : ", JSON.stringify(values));
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/translations/${locale}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "updateTranslations fetch url : ", url);
+      }
+      const body = {
+        type,
+        values
+      };
+      try {
+        const response = await fetch(url, {
+          ...fetchOptions,
+          method: "POST",
+          headers: {
+            "X-API-KEY": options.token
+          },
+          body: JSON.stringify(body)
+        });
+        if (options.debug) {
+          console.log(LOG_GROUP, "updateTranslations status : ", response.status);
+        }
+      } catch (error) {
+        console.error(LOG_GROUP, "updateTranslations error : ", error);
+      }
+    },
+    async getOpenApi() {
+      if (options.debug) {
+        console.log(LOG_GROUP, "getOpenApi()");
+      }
+      let url = `${options.origin}/api/v1/spaces/${options.spaceId}/open-api?token=${options.token}`;
+      if (options.debug) {
+        console.log(LOG_GROUP, "getOpenApi fetch url : ", url);
+      }
+      if (cache.has(url)) {
+        if (options.debug) {
+          console.log(LOG_GROUP, "getTranslations cache hit");
+        }
+        return cache.get(url);
+      }
+      try {
+        const response = await fetch(url, fetchOptions);
+        if (options.debug) {
+          console.log(LOG_GROUP, "getOpenApi status : ", response.status);
+        }
+        const data = await response.json();
+        cache.set(url, data);
+        return data;
+      } catch (error) {
+        console.error(LOG_GROUP, "getOpenApi error : ", error);
+        return {};
+      }
+    },
+    syncScriptUrl() {
+      return `${options.origin}/scripts/sync-v1.js`;
+    },
+    assetLink(asset) {
+      if (typeof asset === "string") {
+        return `${options.origin}/api/v1/spaces/${options.spaceId}/assets/${asset}`;
+      } else {
+        return `${options.origin}/api/v1/spaces/${options.spaceId}/assets/${asset.uri}`;
+      }
+    }
+  };
+}
+
+// src/session.ts
+import { access as access2, readFile } from "fs/promises";
+import { join } from "path";
+import * as process2 from "process";
+
+// src/file.ts
+import { access, constants, mkdir, writeFile } from "fs/promises";
+import { parse } from "path";
+var DEFAULT_CONFIG_DIR = ".localess";
+async function writeToFile(filePath, data, option) {
+  const resolvedPath = parse(filePath).dir;
+  try {
+    await mkdir(resolvedPath, { recursive: true });
+  } catch (mkdirError) {
+    return;
+  }
+  try {
+    await writeFile(filePath, data, option);
+  } catch (writeError) {
+  }
+}
+
+// src/session.ts
+var CREDENTIALS_PATH = join(process2.cwd(), DEFAULT_CONFIG_DIR, "credentials.json");
+async function getSession() {
+  let session = {
+    isLoggedIn: false
+  };
+  const token = process2.env.LOCALESS_TOKEN;
+  const space = process2.env.LOCALESS_SPACE;
+  const origin = process2.env.LOCALESS_ORIGIN;
+  if (token && space && origin) {
+    console.debug(`Login in using environment variables.`);
+    return {
+      isLoggedIn: true,
+      space,
+      origin,
+      token,
+      method: "env"
+    };
+  }
+  try {
+    await access2(CREDENTIALS_PATH);
+    const content = await readFile(CREDENTIALS_PATH, "utf8");
+    const parsedContent = JSON.parse(content);
+    if (Object.keys(parsedContent).length === 0) {
+      return session;
+    }
+    if (parsedContent.origin && parsedContent.token && parsedContent.space) {
+      console.debug(`Login in using credentials file.`);
+      return {
+        isLoggedIn: true,
+        space: parsedContent.space,
+        origin: parsedContent.origin,
+        token: parsedContent.token,
+        method: "file"
+      };
+    }
+  } catch (e) {
+    console.error('No credentials found. Please log in using the "localess login" command.');
+  }
+  console.debug("Not logged in.");
+  return session;
+}
+async function persistSession(data) {
+  if (data.origin && data.token && data.space) {
+    await writeToFile(CREDENTIALS_PATH, JSON.stringify(data, null, 2), { mode: 384 });
+    console.log("Add session credentials to file system.");
+    console.log("Add .localess to .gitignore to avoid committing them to your repository.");
+  } else {
+    throw new Error("Cannot persist session: missing required fields.");
+  }
+}
+async function clearSession() {
+  try {
+    await access2(CREDENTIALS_PATH);
+    await writeToFile(CREDENTIALS_PATH, "{}", { mode: 384 });
+  } catch (error) {
+    throw new Error("Failed to clear session credentials.");
+  }
+}
+
+// src/commands/login/index.ts
+var loginCommand = new Command("login").description("Login to Localess CLI").option("-t, --token <token>", "Token to login to Localess CLI").option("-s, --space <space>", "Space ID to login to").option("-o, --origin <origin>", "Origin of the Localess instance").action(async (options) => {
+  console.log("Logging in with options:", options);
+  const session = await getSession();
+  if (session.isLoggedIn && session.method === "file") {
+    console.log('Already logged in. If you want to log in with different credentials, please log out first using "localess logout" command.');
+    return;
+  }
+  if (options.origin && options.space && options.token) {
+    const client = localessClient({
+      origin: options.origin,
+      spaceId: options.space,
+      token: options.token
+    });
+    try {
+      const space = await client.getSpace();
+      console.log(`Successfully logged in to space: ${space.name} (${space.id})`);
+      await persistSession({
+        origin: options.origin,
+        space: options.space,
+        token: options.token
+      });
+    } catch (e) {
+      console.error("Login failed");
+    }
+  } else if (session.isLoggedIn && session.method === "env") {
+    console.log("Already logged in with environment variables.");
+    console.log("If you want to log in with different credentials, Please provide all required options: --origin, --space, and --token");
+  } else {
+    console.log("Please provide all required options: --origin, --space, and --token");
+    console.log("Or set the following environment variables: LOCALESS_ORIGIN, LOCALESS_SPACE, and LOCALESS_TOKEN");
+  }
+});
+
+// src/commands/logout/index.ts
+import { Command as Command2 } from "commander";
+var logoutCommand = new Command2("logout").description("Logout from Localess CLI").action(async () => {
+  console.log("Logging out...");
+  const session = await getSession();
+  if (!session.isLoggedIn) {
+    console.log("Not currently logged in.");
+    return;
+  }
+  if (session.method === "env") {
+    console.log("You are logged in using environment variables. To log out, unset LOCALESS_TOKEN, LOCALESS_SPACE, and LOCALESS_ORIGIN.");
+    return;
+  }
+  try {
+    await clearSession();
+    console.log("Successfully logged out.");
+  } catch (e) {
+    console.error("Failed to log out:", e);
+  }
+});
+
+// src/commands/types/index.ts
+import { Command as Command3 } from "commander";
+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 typesCommand = new Command3("types").description("Generate types for your schemas").action(async (options) => {
+  console.log("Types in with options:", options);
+  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("Fetching OpenAPI specification from Localess...");
+  const specification = await client.getOpenApi();
+  console.log("Generating types from OpenAPI specification...");
+  try {
+    const minimalSpec = {
+      openapi: "3.0.0",
+      info: { title: "Schemas Only", version: "1.0.0" },
+      components: { schemas: specification.components?.schemas || {} }
+    };
+    const ast = await openapiTS(minimalSpec, { exportType: true, rootTypes: true, rootTypesNoSchemaPrefix: true });
+    const contents = astToString(ast);
+    await writeToFile(TYPES_PATH, contents);
+    console.log(`Types generated successfully at ${TYPES_PATH}`);
+  } catch (e) {
+    console.error(e);
+  }
+});
+
+// src/program.ts
+var program = new Command4();
+program.name("Localess CLI").description("CLI tool for Localess platform management").version("0.0.1");
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(typesCommand);
+
+// src/index.ts
+try {
+  program.parse(process.argv);
+} catch (e) {
+  console.error("Error executing command:", e instanceof Error ? e.message : e);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@localess/cli",
+  "version": "0.0.1-dev.20260216094809",
+  "description": "Localess Command Line.",
+  "keywords": [
+    "localess",
+    "cli",
+    "node",
+    "javascript",
+    "typescript"
+  ],
+  "author": "Lessify",
+  "homepage": "https://github.com/Lessify/localess-js",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "localess": "./dist/index.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lessify/localess-js.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Lessify/localess-js/issues"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --shims",
+    "test": "vitest"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "chalk": "^5.6.2",
+    "openapi-typescript": "^7.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsup": "^8.5.1",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">= 20.0.0"
+  }
+}