@ownlate/cli 1.0.0

package/dist/index.cjs

@@ -0,0 +1,234 @@
+#!/usr/bin/env node
+let commander = require("commander");
+let node_readline_promises = require("node:readline/promises");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+
+//#region src/commands/init.ts
+async function ask(rl, question, fallback = "") {
+	return (await rl.question(question)).trim() || fallback;
+}
+async function initCommand(options) {
+	const configPath = (0, node_path.resolve)(options.config);
+	try {
+		await (0, node_fs_promises.access)(configPath);
+		console.error(`Config already exists: ${configPath}`);
+		process.exit(1);
+	} catch {}
+	const rl = (0, node_readline_promises.createInterface)({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		console.log("Initializing ownlate config...\n");
+		const apiUrl = await ask(rl, "API URL [http://localhost:3000]: ", "http://localhost:3000");
+		const apiKey = await ask(rl, "API Key: ");
+		const projectId = await ask(rl, "Project ID: ");
+		const sourceLanguage = await ask(rl, "Source language [en]: ", "en");
+		const targetLangsRaw = await ask(rl, "Target languages, comma-separated [fr,de]: ", "fr,de");
+		const sourceFile = await ask(rl, "Source file path [locales/en.json]: ", "locales/en.json");
+		const outputPattern = await ask(rl, "Output pattern [locales/{{language}}.json]: ", "locales/{{language}}.json");
+		const config = {
+			apiUrl,
+			apiKey,
+			projectId,
+			sourceLanguage,
+			targetLanguages: targetLangsRaw.split(",").map((l) => l.trim()).filter(Boolean),
+			files: [{
+				source: sourceFile,
+				output: outputPattern
+			}]
+		};
+		await (0, node_fs_promises.writeFile)(configPath, JSON.stringify(config, null, 2) + "\n");
+		console.log(`\nCreated ${configPath}`);
+		console.log("\nNext steps:");
+		console.log("  ownlate push   — upload source strings to ownlate");
+		console.log("  ownlate pull   — download translations to local files");
+	} finally {
+		rl.close();
+	}
+}
+
+//#endregion
+//#region src/lib/config.ts
+async function readConfig(configPath) {
+	const absPath = (0, node_path.resolve)(configPath);
+	let raw;
+	try {
+		raw = await (0, node_fs_promises.readFile)(absPath, "utf-8");
+	} catch {
+		throw new Error(`Config file not found: ${absPath}\nRun "ownlate init" to create one.`);
+	}
+	let config;
+	try {
+		config = JSON.parse(raw);
+	} catch {
+		throw new Error(`Config file is not valid JSON: ${absPath}`);
+	}
+	config.apiUrl = process.env.OWNLATE_API_URL ?? config.apiUrl;
+	config.apiKey = process.env.OWNLATE_API_KEY ?? config.apiKey;
+	for (const field of [
+		"apiUrl",
+		"apiKey",
+		"projectId",
+		"sourceLanguage",
+		"targetLanguages",
+		"files"
+	]) if (!config[field]) throw new Error(`Missing required config field: "${field}"`);
+	return config;
+}
+async function writeConfig(configPath, config) {
+	await (0, node_fs_promises.writeFile)((0, node_path.resolve)(configPath), JSON.stringify(config, null, 2) + "\n");
+}
+
+//#endregion
+//#region src/lib/api-client.ts
+var ApiClient = class {
+	constructor(baseUrl, apiKey) {
+		this.baseUrl = baseUrl.replace(/\/$/, "");
+		this.apiKey = apiKey;
+	}
+	authHeaders() {
+		return { Authorization: `Bearer ${this.apiKey}` };
+	}
+	async upload(dto) {
+		const res = await fetch(`${this.baseUrl}/v1/translation-files/upload`, {
+			method: "POST",
+			headers: {
+				...this.authHeaders(),
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(dto)
+		});
+		if (!res.ok) {
+			const text = await res.text();
+			throw new Error(`HTTP ${res.status}: ${text}`);
+		}
+		return res.json();
+	}
+	async exportTranslations(params) {
+		const query = new URLSearchParams({
+			projectId: params.projectId,
+			language: params.language,
+			format: params.format
+		});
+		if (params.fileId) query.set("fileId", params.fileId);
+		if (params.sourceLanguage) query.set("sourceLanguage", params.sourceLanguage);
+		const res = await fetch(`${this.baseUrl}/v1/segments/export?${query}`, { headers: this.authHeaders() });
+		if (!res.ok) {
+			const text = await res.text();
+			throw new Error(`HTTP ${res.status}: ${text}`);
+		}
+		return res.text();
+	}
+};
+
+//#endregion
+//#region src/commands/push.ts
+function detectFormat$1(filePath) {
+	const ext = (0, node_path.extname)(filePath).toLowerCase();
+	if (ext === ".json") return "json";
+	if (ext === ".yaml" || ext === ".yml") return "yaml";
+	if (ext === ".po") return "po";
+	throw new Error(`Unsupported extension "${ext}". Use .json, .yaml, .yml or .po`);
+}
+async function pushCommand(options) {
+	const config = await readConfig(options.config);
+	const client = new ApiClient(config.apiUrl, config.apiKey);
+	let configUpdated = false;
+	console.log(`Pushing to ${config.apiUrl} (project: ${config.projectId})\n`);
+	for (const file of config.files) {
+		const absPath = (0, node_path.resolve)(file.source);
+		let content;
+		try {
+			content = await (0, node_fs_promises.readFile)(absPath, "utf-8");
+		} catch {
+			console.error(`  [skip] ${file.source} — file not found`);
+			continue;
+		}
+		const format = detectFormat$1(file.source);
+		const name = (0, node_path.basename)(file.source);
+		const dir = (0, node_path.dirname)(file.source);
+		const filePath = dir === "." ? "" : dir;
+		process.stdout.write(`  ${file.source} ...`);
+		try {
+			const result = await client.upload({
+				projectId: config.projectId,
+				name,
+				path: filePath,
+				format,
+				content,
+				fileId: file.fileId
+			});
+			if (!file.fileId) {
+				file.fileId = result.id;
+				configUpdated = true;
+			}
+			console.log(` ${result.segmentsCreated} segments`);
+		} catch (err) {
+			console.log(" failed");
+			console.error(`  [!] ${err.message}`);
+		}
+	}
+	if (configUpdated) {
+		await writeConfig(options.config, config);
+		console.log(`\nSaved file IDs to ${options.config}`);
+	}
+}
+
+//#endregion
+//#region src/commands/pull.ts
+function detectFormat(pattern) {
+	const ext = (0, node_path.extname)(pattern).toLowerCase();
+	if (ext === ".json") return "json";
+	if (ext === ".yaml" || ext === ".yml") return "yaml";
+	if (ext === ".po") return "po";
+	throw new Error(`Cannot detect format from output pattern "${pattern}"`);
+}
+async function pullCommand(options) {
+	const config = await readConfig(options.config);
+	const client = new ApiClient(config.apiUrl, config.apiKey);
+	const languages = options.lang ? [options.lang] : config.targetLanguages;
+	console.log(`Pulling from ${config.apiUrl} (project: ${config.projectId})\n`);
+	for (const file of config.files) {
+		const format = detectFormat(file.output);
+		for (const language of languages) {
+			const localPath = file.output.replace("{{language}}", language);
+			const absPath = (0, node_path.resolve)(localPath);
+			process.stdout.write(`  ${language} → ${localPath} ...`);
+			try {
+				const content = await client.exportTranslations({
+					projectId: config.projectId,
+					language,
+					format,
+					fileId: file.fileId
+				});
+				await (0, node_fs_promises.mkdir)((0, node_path.dirname)(absPath), { recursive: true });
+				await (0, node_fs_promises.writeFile)(absPath, content);
+				console.log(" done");
+			} catch (err) {
+				console.log(" failed");
+				console.error(`  [!] ${err.message}`);
+			}
+		}
+	}
+}
+
+//#endregion
+//#region src/index.ts
+const program = new commander.Command();
+program.name("ownlate").description("Sync translation files with your ownlate project").version("1.0.0");
+const configOpt = [
+	"-c, --config <path>",
+	"path to config file",
+	".ownlate.json"
+];
+program.command("init").description("Create .ownlate.json config interactively").option(...configOpt).action(initCommand);
+program.command("push").description("Upload source files — creates/updates segments in ownlate").option(...configOpt).action(pushCommand);
+program.command("pull").description("Download translated files from ownlate to local filesystem").option(...configOpt).option("-l, --lang <code>", "pull a single language only (e.g. fr)").action(pullCommand);
+program.parseAsync(process.argv).catch((err) => {
+	console.error(err.message);
+	process.exit(1);
+});
+
+//#endregion

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@ownlate/cli",
+  "version": "1.0.0",
+  "description": "Ownlate CLI — push source files and pull translations",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "ownlate": "./dist/index.cjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  },
+  "keywords": [
+    "ownlate",
+    "i18n",
+    "localization",
+    "translations",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@ownlate/typescript-config": "workspace:*",
+    "@types/node": "catalog:dev",
+    "tsdown": "catalog:dev",
+    "typescript": "catalog:dev"
+  }
+}