@daliusd/deepl-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 daliusd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# @daliusd/deepl-cli
+
+CLI tool for translating text using the [DeepL API](https://www.deepl.com/docs-api). Pipe-friendly, configurable, supports context and formality options.
+
+## Installation
+
+```bash
+npm install -g @daliusd/deepl-cli
+```
+
+Requires Node.js >= 18.
+
+## Configuration
+
+Create a config file at `~/.config/deepl-cli/config.json`:
+
+```bash
+mkdir -p ~/.config/deepl-cli
+```
+
+### Using a static API key
+
+```json
+{
+  "api_key": "your-deepl-api-key"
+}
+```
+
+### Using a command to retrieve the API key
+
+This is useful with password managers like [pass](https://www.passwordstore.org/), 1Password CLI, etc.
+
+```json
+{
+  "api_key_command": "pass show deepl-api-key"
+}
+```
+
+If both `api_key` and `api_key_command` are present, `api_key_command` takes precedence.
+
+You can get a DeepL API key by creating a [DeepL API account](https://www.deepl.com/pro#developer) (free tier: 500,000 characters/month).
+
+## Usage
+
+```
+deepl-cli [options] [text]
+```
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--target <lang>` | `-t` | Target language code (required, e.g. `de`, `en-US`, `fr`) |
+| `--source <lang>` | `-s` | Source language code (default: auto-detect) |
+| `--context <text>` | `-c` | Additional context to influence translation (not translated, not billed) |
+| `--formality <level>` | `-f` | Formality: `less`, `more`, `default`, `prefer_less`, `prefer_more` |
+| `--verbose` | `-v` | Show metadata (detected source language, billed characters) |
+| `--help` | `-h` | Show help |
+| `--version` | | Show version |
+
+### Examples
+
+Translate text to German:
+
+```bash
+deepl-cli -t de "Hello, world!"
+```
+
+Translate with context (context influences translation but is not translated or billed):
+
+```bash
+deepl-cli -t de -c "This is a greeting in a formal business email" "Hello"
+```
+
+Pipe text via stdin:
+
+```bash
+echo "Hello, world!" | deepl-cli -t de
+```
+
+Use formal language:
+
+```bash
+deepl-cli -t de -f more "How are you?"
+```
+
+Show translation metadata:
+
+```bash
+deepl-cli -t de -v "Hello, world!"
+# stdout: Hallo, Welt!
+# stderr: Detected source language: en
+# stderr: Billed characters: 13
+```
+
+Specify source language explicitly:
+
+```bash
+deepl-cli -t de -s en "Hello"
+```
+
+### Piping
+
+The translated text is printed to stdout with no extra formatting, making it easy to use in pipelines:
+
+```bash
+echo "Hello" | deepl-cli -t de | pbcopy
+```
+
+When `--verbose` is used, metadata is written to stderr so stdout remains clean for piping.
+
+## Language codes
+
+Language codes are case-insensitive and follow ISO 639-1, with some target languages including regional variants:
+
+- Source: `en`, `de`, `fr`, `ja`, `es`, etc. (or omit for auto-detection)
+- Target: `en-US`, `en-GB`, `pt-BR`, `pt-PT`, `de`, `fr`, etc.
+
+See the [DeepL API documentation](https://www.deepl.com/docs-api/translating-text/) for the full list of supported languages.
+
+## Development
+
+```bash
+git clone https://github.com/daliusd/deepl-cli.git
+cd deepl-cli
+npm install
+npm run build
+npm test
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Compile TypeScript to `dist/` |
+| `npm test` | Run unit tests (`node:test`) |
+
+### Publishing
+
+```bash
+npm run build
+npm publish --access public
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/args.d.ts

@@ -0,0 +1,14 @@
+import type { Formality } from 'deepl-node';
+export declare const HELP_TEXT = "Usage: deepl-cli [options] [text]\n\nTranslate text using the DeepL API.\n\nArguments:\n  text                      Text to translate (or pipe via stdin)\n\nOptions:\n  -t, --target <lang>       Target language code (required, e.g. \"de\", \"en-US\")\n  -s, --source <lang>       Source language code (default: auto-detect)\n  -c, --context <text>      Additional context for translation (not translated, not billed)\n  -f, --formality <level>   Formality: less, more, default, prefer_less, prefer_more\n  -v, --verbose             Show metadata (detected source lang, billed characters)\n  -h, --help                Show this help\n  --version                 Show version\n\nExamples:\n  deepl-cli -t de \"Hello, world!\"\n  deepl-cli -t de -c \"Email greeting\" \"Hello\"\n  echo \"Hello\" | deepl-cli -t de\n  deepl-cli -t de -f more \"How are you?\"";
+export interface ParsedArgs {
+    target: string;
+    source: string | null;
+    context: string | undefined;
+    formality: Formality | undefined;
+    verbose: boolean;
+    help: boolean;
+    version: boolean;
+    text: string | undefined;
+}
+export declare function parseCliArgs(args: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C,eAAO,MAAM,SAAS,21BAoBmB,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAkFvD"}

package/dist/args.js

@@ -0,0 +1,99 @@
+import { parseArgs } from 'node:util';
+const VALID_FORMALITY_VALUES = [
+    'less',
+    'more',
+    'default',
+    'prefer_less',
+    'prefer_more',
+];
+export const HELP_TEXT = `Usage: deepl-cli [options] [text]
+
+Translate text using the DeepL API.
+
+Arguments:
+  text                      Text to translate (or pipe via stdin)
+
+Options:
+  -t, --target <lang>       Target language code (required, e.g. "de", "en-US")
+  -s, --source <lang>       Source language code (default: auto-detect)
+  -c, --context <text>      Additional context for translation (not translated, not billed)
+  -f, --formality <level>   Formality: less, more, default, prefer_less, prefer_more
+  -v, --verbose             Show metadata (detected source lang, billed characters)
+  -h, --help                Show this help
+  --version                 Show version
+
+Examples:
+  deepl-cli -t de "Hello, world!"
+  deepl-cli -t de -c "Email greeting" "Hello"
+  echo "Hello" | deepl-cli -t de
+  deepl-cli -t de -f more "How are you?"`;
+export function parseCliArgs(args) {
+    // Show help when called with no arguments
+    if (args.length === 0) {
+        return {
+            target: '',
+            source: null,
+            context: undefined,
+            formality: undefined,
+            verbose: false,
+            help: true,
+            version: false,
+            text: undefined,
+        };
+    }
+    const { values, positionals } = parseArgs({
+        args,
+        options: {
+            target: { type: 'string', short: 't' },
+            source: { type: 'string', short: 's' },
+            context: { type: 'string', short: 'c' },
+            formality: { type: 'string', short: 'f' },
+            verbose: { type: 'boolean', short: 'v', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+            version: { type: 'boolean', default: false },
+        },
+        allowPositionals: true,
+    });
+    if (values.help) {
+        return {
+            target: '',
+            source: null,
+            context: undefined,
+            formality: undefined,
+            verbose: false,
+            help: true,
+            version: false,
+            text: undefined,
+        };
+    }
+    if (values.version) {
+        return {
+            target: '',
+            source: null,
+            context: undefined,
+            formality: undefined,
+            verbose: false,
+            help: false,
+            version: true,
+            text: undefined,
+        };
+    }
+    if (!values.target) {
+        throw new Error('Missing required option: --target (-t)\nUse --help for usage information.');
+    }
+    if (values.formality &&
+        !VALID_FORMALITY_VALUES.includes(values.formality)) {
+        throw new Error(`Invalid formality value: "${values.formality}"\nValid values: ${VALID_FORMALITY_VALUES.join(', ')}`);
+    }
+    return {
+        target: values.target,
+        source: values.source || null,
+        context: values.context,
+        formality: values.formality,
+        verbose: values.verbose ?? false,
+        help: false,
+        version: false,
+        text: positionals.length > 0 ? positionals.join(' ') : undefined,
+    };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { createReadStream } from 'node:fs';
+import { loadConfig, resolveApiKey } from './config.js';
+import { createClient, translate } from './translate.js';
+import { parseCliArgs, HELP_TEXT } from './args.js';
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        const stream = createReadStream('/dev/stdin', { encoding: 'utf-8' });
+        const timeout = setTimeout(() => {
+            stream.destroy();
+            reject(new Error('No input provided. Pass text as an argument or pipe via stdin.'));
+        }, 100);
+        stream.on('data', (chunk) => {
+            clearTimeout(timeout);
+            data += chunk;
+        });
+        stream.on('end', () => {
+            clearTimeout(timeout);
+            resolve(data.trim());
+        });
+        stream.on('error', (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+function getVersion() {
+    return '0.1.0';
+}
+async function main() {
+    let parsed;
+    try {
+        parsed = parseCliArgs(process.argv.slice(2));
+    }
+    catch (err) {
+        process.stderr.write(`Error: ${err.message}\n`);
+        process.exit(1);
+    }
+    if (parsed.help) {
+        process.stdout.write(HELP_TEXT + '\n');
+        process.exit(0);
+    }
+    if (parsed.version) {
+        process.stdout.write(getVersion() + '\n');
+        process.exit(0);
+    }
+    // Get text from argument or stdin
+    let text = parsed.text;
+    if (!text) {
+        if (process.stdin.isTTY) {
+            process.stderr.write('Error: No text provided. Pass text as an argument or pipe via stdin.\n' +
+                'Use --help for usage information.\n');
+            process.exit(1);
+        }
+        try {
+            text = await readStdin();
+        }
+        catch {
+            process.stderr.write('Error: No text provided. Pass text as an argument or pipe via stdin.\n' +
+                'Use --help for usage information.\n');
+            process.exit(1);
+        }
+    }
+    if (!text) {
+        process.stderr.write('Error: Empty text provided.\nUse --help for usage information.\n');
+        process.exit(1);
+    }
+    // Load config and resolve API key
+    let apiKey;
+    try {
+        const config = loadConfig();
+        apiKey = resolveApiKey(config);
+    }
+    catch (err) {
+        process.stderr.write(`Error: ${err.message}\n`);
+        process.exit(1);
+    }
+    // Translate
+    try {
+        const client = createClient(apiKey);
+        const result = await translate(client, {
+            text,
+            sourceLang: parsed.source,
+            targetLang: parsed.target,
+            context: parsed.context,
+            formality: parsed.formality,
+        });
+        process.stdout.write(result.text + '\n');
+        if (parsed.verbose) {
+            process.stderr.write(`Detected source language: ${result.detectedSourceLang}\n`);
+            process.stderr.write(`Billed characters: ${result.billedCharacters}\n`);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`Error: ${err.message}\n`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface Config {
+    api_key?: string;
+    api_key_command?: string;
+}
+export declare function loadConfig(configPath?: string): Config;
+export declare function resolveApiKey(config: Config): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,wBAAgB,UAAU,CAAC,UAAU,GAAE,MAA4B,GAAG,MAAM,CAoC3E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBpD"}

package/dist/config.js

@@ -0,0 +1,55 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_CONFIG_DIR = join(homedir(), '.config', 'deepl-cli');
+const DEFAULT_CONFIG_PATH = join(DEFAULT_CONFIG_DIR, 'config.json');
+export function loadConfig(configPath = DEFAULT_CONFIG_PATH) {
+    if (!existsSync(configPath)) {
+        throw new Error(`Config file not found: ${configPath}\n` +
+            `Create it with:\n` +
+            `  mkdir -p ~/.config/deepl-cli\n` +
+            `  echo '{"api_key": "your-deepl-api-key"}' > ~/.config/deepl-cli/config.json\n` +
+            `\n` +
+            `Or use api_key_command to retrieve the key from a password manager:\n` +
+            `  echo '{"api_key_command": "pass show deepl-api-key"}' > ~/.config/deepl-cli/config.json`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(configPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Failed to read config file: ${configPath}: ${err}`);
+    }
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in config file: ${configPath}`);
+    }
+    if (!config.api_key && !config.api_key_command) {
+        throw new Error(`Config must contain "api_key" or "api_key_command".\n` +
+            `  api_key: your DeepL API key as a string\n` +
+            `  api_key_command: a shell command that outputs your API key (e.g. "pass show deepl-api-key")`);
+    }
+    return config;
+}
+export function resolveApiKey(config) {
+    if (config.api_key_command) {
+        try {
+            return execSync(config.api_key_command, {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+        }
+        catch (err) {
+            throw new Error(`Failed to execute api_key_command: ${config.api_key_command}\n${err}`);
+        }
+    }
+    if (config.api_key) {
+        return config.api_key;
+    }
+    throw new Error('No API key available. Set "api_key" or "api_key_command" in config.');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOlC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AACnE,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;AAEpE,MAAM,UAAU,UAAU,CAAC,aAAqB,mBAAmB;IACjE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0BAA0B,UAAU,IAAI;YACtC,mBAAmB;YACnB,kCAAkC;YAClC,gFAAgF;YAChF,IAAI;YACJ,uEAAuE;YACvE,2FAA2F,CAC9F,CAAC;IACJ,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,KAAK,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,6CAA6C;YAC7C,+FAA+F,CAClG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE;gBACtC,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,sCAAsC,MAAM,CAAC,eAAe,KAAK,GAAG,EAAE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;AACJ,CAAC"}

package/dist/translate.d.ts

@@ -0,0 +1,16 @@
+import * as deepl from 'deepl-node';
+export interface TranslateOptions {
+    text: string;
+    sourceLang: deepl.SourceLanguageCode | null;
+    targetLang: deepl.TargetLanguageCode;
+    context?: string;
+    formality?: deepl.Formality;
+}
+export interface TranslateResult {
+    text: string;
+    detectedSourceLang: string;
+    billedCharacters: number;
+}
+export declare function createClient(apiKey: string): deepl.DeepLClient;
+export declare function translate(client: deepl.DeepLClient, options: TranslateOptions): Promise<TranslateResult>;
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC5C,UAAU,EAAE,KAAK,CAAC,kBAAkB,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAO9D;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,KAAK,CAAC,WAAW,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/translate.js

@@ -0,0 +1,26 @@
+import * as deepl from 'deepl-node';
+export function createClient(apiKey) {
+    return new deepl.DeepLClient(apiKey, {
+        appInfo: {
+            appName: 'deepl-cli',
+            appVersion: '0.1.0',
+        },
+    });
+}
+export async function translate(client, options) {
+    const translateOptions = {};
+    if (options.context) {
+        translateOptions.context = options.context;
+    }
+    if (options.formality) {
+        translateOptions.formality = options.formality;
+    }
+    const result = await client.translateText(options.text, options.sourceLang, options.targetLang, translateOptions);
+    const single = Array.isArray(result) ? result[0] : result;
+    return {
+        text: single.text,
+        detectedSourceLang: single.detectedSourceLang,
+        billedCharacters: single.billedCharacters,
+    };
+}
+//# sourceMappingURL=translate.js.map

package/dist/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAgBpC,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE;QACnC,OAAO,EAAE;YACP,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,OAAO;SACpB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAyB,EACzB,OAAyB;IAEzB,MAAM,gBAAgB,GAA+B,EAAE,CAAC;IAExD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,gBAAgB,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,gBAAgB,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CACvC,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,UAAU,EAClB,gBAAgB,CACjB,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@daliusd/deepl-cli",
+  "version": "0.1.0",
+  "description": "CLI tool for translating text using the DeepL API",
+  "type": "module",
+  "bin": {
+    "deepl-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test tests/*.test.ts"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "deepl",
+    "translate",
+    "translation",
+    "cli"
+  ],
+  "author": "daliusd",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "deepl-node": "^1.15.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}