@translated/lara 1.6.6 → 2.0.0-beta.0

package/lib/models/translator.d.ts

@@ -0,0 +1,48 @@
+export interface TranslatorOptions {
+    serverUrl?: string;
+    extraHeaders?: Record<string, any>;
+}
+export interface TextBlock {
+    readonly text: string;
+    readonly translatable?: boolean;
+}
+export type TranslationStyle = 'faithful' | 'fluid' | 'creative';
+export type TranslateOptions = {
+    sourceHint?: string;
+    adaptTo?: string[];
+    instructions?: string[];
+    glossaries?: string[];
+    contentType?: string;
+    multiline?: boolean;
+    timeoutInMillis?: number;
+    priority?: 'normal' | 'background';
+    useCache?: boolean | 'overwrite';
+    cacheTTLSeconds?: number;
+    noTrace?: boolean;
+    verbose?: boolean;
+    headers?: Record<string, string>;
+    style?: TranslationStyle;
+};
+export interface NGMemoryMatch {
+    memory: string;
+    tuid?: string;
+    language: [string, string];
+    sentence: string;
+    translation: string;
+    score: number;
+}
+export interface NGGlossaryMatch {
+    glossary: string;
+    language: [string, string];
+    term: string;
+    translation: string;
+}
+export interface TextResult<T extends string | string[] | TextBlock[]> {
+    readonly contentType: string;
+    readonly sourceLanguage: string;
+    readonly translation: T;
+    readonly adaptedTo?: string[];
+    readonly glossaries?: string[];
+    readonly adaptedToMatches?: NGMemoryMatch[] | NGMemoryMatch[][];
+    readonly glossariesMatches?: NGGlossaryMatch[] | NGGlossaryMatch[][];
+}

package/lib/models/translator.js

@@ -0,0 +1 @@
+export {};

package/lib/sdk-version.js

@@ -1,4 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.version = void 0;
-exports.version = "1.6.6";
+export const version = "1.6.6";

package/lib/utils/errors.js

@@ -0,0 +1,12 @@
+export class LaraError extends Error {
+}
+export class TimeoutError extends LaraError {
+}
+export class LaraApiError extends LaraError {
+    constructor(statusCode, type, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.type = type;
+        this.message = message;
+    }
+}

package/lib/utils/formdata/browser.d.ts

@@ -0,0 +1,2 @@
+declare const _default: (data: Record<string, any>) => {}[];
+export default _default;

package/lib/utils/formdata/browser.js

@@ -0,0 +1,15 @@
+export default (data) => {
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(data)) {
+        if (!value)
+            continue;
+        if (Array.isArray(value)) {
+            for (const v of value)
+                formData.append(key, v);
+        }
+        else {
+            formData.append(key, value);
+        }
+    }
+    return [formData, {}];
+};

package/lib/utils/formdata/index.d.ts

@@ -0,0 +1,4 @@
+declare const _default: (data: Record<string, any>) => [any, {
+    [key: string]: any;
+}];
+export default _default;

package/lib/utils/formdata/index.js

@@ -0,0 +1,10 @@
+import browserForm from './browser.js';
+import nodeForm from './node.js';
+let form;
+if (typeof window !== 'undefined') {
+    form = browserForm;
+}
+else {
+    form = nodeForm;
+}
+export default form;

package/lib/utils/formdata/node.d.ts

@@ -0,0 +1,5 @@
+import FormData from 'form-data';
+declare const _default: (data: Record<string, any>) => [FormData, {
+    [key: string]: any;
+}];
+export default _default;

package/lib/utils/formdata/node.js

@@ -0,0 +1,16 @@
+import FormData from 'form-data';
+export default (data) => {
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(data)) {
+        if (!value)
+            continue;
+        if (Array.isArray(value)) {
+            for (const v of value)
+                formData.append(key, v);
+        }
+        else {
+            formData.append(key, value);
+        }
+    }
+    return [formData, { ...formData.getHeaders() }];
+};

package/lib/utils/sleep.d.ts

@@ -0,0 +1,2 @@
+declare const _default: (millis: number) => Promise<unknown>;
+export default _default;

package/lib/utils/sleep.js

@@ -0,0 +1 @@
+export default (millis) => new Promise((resolve) => setTimeout(resolve, millis));

package/lib/utils/toCamelCase.d.ts

@@ -0,0 +1,2 @@
+declare const toCamelCase: (content: any) => any;
+export default toCamelCase;

package/lib/utils/toCamelCase.js

@@ -0,0 +1,16 @@
+const toCamelCase = (content) => {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content))
+        return content.map(toCamelCase);
+    if (typeof content === 'object' && content !== null) {
+        const result = {};
+        for (const [key, value] of Object.entries(content)) {
+            const camelKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+            result[camelKey] = toCamelCase(value);
+        }
+        return result;
+    }
+    return content;
+};
+export default toCamelCase;

package/lib/utils/toSnakeCase.js

@@ -1,5 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 const toSnakeCase = (content) => {
     if (typeof content === 'string')
         return content;
@@ -15,4 +13,4 @@ const toSnakeCase = (content) => {
     }
     return content;
 };
-exports.default = toSnakeCase;
+export default toSnakeCase;

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@translated/lara",
-  "version": "1.6.6",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "version": "2.0.0-beta.0",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "engines": {
     "node": ">=12.*"
   },
   "scripts": {
     "build": "rm -rf lib/* lib-browser/* && node scripts/generate-sdk-version.js && tsc && webpack",
+    "_build": "rm -rf lib/* && tsc",
     "version": "node scripts/generate-sdk-version.js && git add src/sdk-version.ts",
-    "biome:check": "biome check",
-    "biome:write": "biome check --write"
+    "lint:fix": "eslint --fix .",
+    "lint:check": "eslint ."
   },
   "files": [
     "lib",
@@ -34,14 +35,23 @@
     "url": "git+ssh://git@github.com/translated/lara-node.git"
   },
   "description": "Official Lara SDK for JavaScript and Node.js",
-  "dependencies": {
-    "form-data": "^4.0.2"
-  },
   "devDependencies": {
-    "@biomejs/biome": "^2.0.6",
-    "@types/node": "^22.15.18",
-    "typescript": "^5.8.3",
-    "webpack": "^5.99.8",
-    "webpack-cli": "^5.1.4"
+    "@types/node": "^24.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@typescript-eslint/parser": "^8.46.0",
+    "eslint": "^9.37.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "webpack": "^5.102.1",
+    "webpack-cli": "^6.0.1"
+  },
+  "dependencies": {
+    "axios": "^1.12.2",
+    "form-data": "^4.0.4"
   }
 }

package/lib/credentials.d.ts

@@ -1,5 +0,0 @@
-export declare class Credentials {
-    readonly accessKeyId: string;
-    readonly accessKeySecret: string;
-    constructor(accessKeyId: string, accessKeySecret: string);
-}

package/lib/credentials.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Credentials = void 0;
-class Credentials {
-    constructor(accessKeyId, accessKeySecret) {
-        this.accessKeyId = accessKeyId;
-        this.accessKeySecret = accessKeySecret;
-    }
-}
-exports.Credentials = Credentials;

package/lib/crypto/browser-crypto.d.ts

@@ -1,11 +0,0 @@
-import type { PortableCrypto } from "./portable-crypto";
-/** @internal */
-export declare class BrowserCrypto implements PortableCrypto {
-    private readonly subtle;
-    constructor();
-    /**
-     * MD5 in browser is not supported, so we use SHA-256 instead and return the first 16 bytes
-     */
-    digest(data: string): Promise<string>;
-    hmac(key: string, data: string): Promise<string>;
-}

package/lib/crypto/browser-crypto.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowserCrypto = void 0;
-/** @internal */
-class BrowserCrypto {
-    constructor() {
-        this.subtle = window.crypto.subtle;
-    }
-    /**
-     * MD5 in browser is not supported, so we use SHA-256 instead and return the first 16 bytes
-     */
-    async digest(data) {
-        const encoder = new TextEncoder();
-        const buffer = (await this.subtle.digest("sha-256", encoder.encode(data))).slice(0, 16);
-        return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, "0")).join("");
-    }
-    async hmac(key, data) {
-        const encoder = new TextEncoder();
-        encoder.encode(data);
-        const cKey = await this.subtle.importKey("raw", encoder.encode(key), {
-            name: "hmac",
-            hash: { name: "sha-256" }
-        }, false, ["sign"]);
-        const buffer = await this.subtle.sign("hmac", cKey, encoder.encode(data));
-        return btoa(String.fromCharCode(...new Uint8Array(buffer)));
-    }
-}
-exports.BrowserCrypto = BrowserCrypto;

package/lib/crypto/index.d.ts

@@ -1,3 +0,0 @@
-import type { PortableCrypto } from "./portable-crypto";
-export { PortableCrypto } from "./portable-crypto";
-export default function instance(): PortableCrypto;

package/lib/crypto/index.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = instance;
-const browser_crypto_1 = require("./browser-crypto");
-const node_crypto_1 = require("./node-crypto");
-let _instance;
-function instance() {
-    if (_instance === undefined) {
-        if (typeof window !== "undefined")
-            _instance = new browser_crypto_1.BrowserCrypto();
-        else
-            _instance = new node_crypto_1.NodeCrypto();
-    }
-    return _instance;
-}

package/lib/crypto/node-crypto.d.ts

@@ -1,6 +0,0 @@
-import type { PortableCrypto } from "./portable-crypto";
-/** @internal */
-export declare class NodeCrypto implements PortableCrypto {
-    digest(data: string): Promise<string>;
-    hmac(key: string, data: string): Promise<string>;
-}

package/lib/crypto/node-crypto.js

@@ -1,55 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeCrypto = void 0;
-const crypto = __importStar(require("node:crypto"));
-/** @internal */
-class NodeCrypto {
-    digest(data) {
-        return new Promise((resolve) => {
-            const hash = crypto.createHash("md5");
-            hash.update(data);
-            resolve(hash.digest("hex"));
-        });
-    }
-    hmac(key, data) {
-        return new Promise((resolve) => {
-            const hmac = crypto.createHmac("sha256", key);
-            hmac.update(data);
-            resolve(hmac.digest("base64"));
-        });
-    }
-}
-exports.NodeCrypto = NodeCrypto;

package/lib/crypto/portable-crypto.d.ts

@@ -1,5 +0,0 @@
-/** @internal */
-export interface PortableCrypto {
-    digest(data: string): Promise<string>;
-    hmac(key: string, data: string): Promise<string>;
-}

package/lib/crypto/portable-crypto.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/errors.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LaraApiError = exports.TimeoutError = exports.LaraError = void 0;
-class LaraError extends Error {
-}
-exports.LaraError = LaraError;
-class TimeoutError extends LaraError {
-}
-exports.TimeoutError = TimeoutError;
-class LaraApiError extends LaraError {
-    constructor(statusCode, type, message) {
-        super(message);
-        this.statusCode = statusCode;
-        this.type = type;
-        this.message = message;
-    }
-}
-exports.LaraApiError = LaraApiError;

package/lib/net/browser-client.d.ts

@@ -1,8 +0,0 @@
-import { type BaseURL, type ClientResponse, LaraClient, type MultiPartFile } from "./client";
-/** @internal */
-export declare class BrowserLaraClient extends LaraClient {
-    private readonly baseUrl;
-    constructor(baseUrl: BaseURL, accessKeyId: string, accessKeySecret: string);
-    protected send(path: string, headers: Record<string, string>, body?: Record<string, any>): Promise<ClientResponse>;
-    protected wrapMultiPartFile(file: MultiPartFile): File;
-}

package/lib/net/browser-client.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowserLaraClient = void 0;
-const client_1 = require("./client");
-function hasDefaultPort(port, secure) {
-    return (port === 80 && !secure) || (port === 443 && secure);
-}
-/** @internal */
-class BrowserLaraClient extends client_1.LaraClient {
-    constructor(baseUrl, accessKeyId, accessKeySecret) {
-        super(accessKeyId, accessKeySecret);
-        let url = `${baseUrl.secure ? "https" : "http"}://${baseUrl.hostname}`;
-        if (!hasDefaultPort(baseUrl.port, baseUrl.secure))
-            url += `:${baseUrl.port}`;
-        this.baseUrl = url;
-    }
-    async send(path, headers, body) {
-        var _a;
-        let requestBody;
-        if (body) {
-            if (headers["Content-Type"] === "multipart/form-data") {
-                delete headers["Content-Type"]; // browser will set it automatically
-                const formBody = new FormData();
-                for (const [key, value] of Object.entries(body)) {
-                    if (!value)
-                        continue;
-                    if (Array.isArray(value)) {
-                        for (const v of value)
-                            formBody.append(key, v);
-                    }
-                    else {
-                        formBody.append(key, value);
-                    }
-                }
-                requestBody = formBody;
-            }
-            else {
-                requestBody = JSON.stringify(body, undefined, 0);
-            }
-        }
-        const response = await fetch(this.baseUrl + path, {
-            headers: headers,
-            method: "POST",
-            body: requestBody
-        });
-        if ((_a = response.headers.get("Content-Type")) === null || _a === void 0 ? void 0 : _a.includes("text/csv")) {
-            return {
-                statusCode: response.status,
-                body: {
-                    content: await response.text()
-                }
-            };
-        }
-        return { statusCode: response.status, body: await response.json() };
-    }
-    wrapMultiPartFile(file) {
-        if (file instanceof File)
-            return file;
-        throw new TypeError(`Invalid file input in the browser. Expected an instance of File but received ${typeof file}.`);
-    }
-}
-exports.BrowserLaraClient = BrowserLaraClient;

package/lib/net/client.d.ts

@@ -1,34 +0,0 @@
-import type { Readable } from "node:stream";
-type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
-/** @internal */
-export type BaseURL = {
-    secure: boolean;
-    hostname: string;
-    port: number;
-};
-/** @internal */
-export type ClientResponse = {
-    statusCode: number;
-    body: any;
-};
-export type BrowserMultiPartFile = File;
-export type NodeMultiPartFile = Readable | string;
-export type MultiPartFile = BrowserMultiPartFile | NodeMultiPartFile;
-/** @internal */
-export declare abstract class LaraClient {
-    private readonly crypto;
-    private readonly accessKeyId;
-    private readonly accessKeySecret;
-    private readonly extraHeaders;
-    protected constructor(accessKeyId: string, accessKeySecret: string);
-    setExtraHeader(name: string, value: string): void;
-    get<T>(path: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
-    delete<T>(path: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
-    post<T>(path: string, body?: Record<string, any>, files?: Record<string, MultiPartFile>, headers?: Record<string, string>): Promise<T>;
-    put<T>(path: string, body?: Record<string, any>, files?: Record<string, MultiPartFile>, headers?: Record<string, string>): Promise<T>;
-    protected request<T>(method: HttpMethod, path: string, body?: Record<string, any>, files?: Record<string, MultiPartFile>, headers?: Record<string, string>): Promise<T>;
-    private sign;
-    protected abstract send(path: string, headers: Record<string, string>, body?: Record<string, any>): Promise<ClientResponse>;
-    protected abstract wrapMultiPartFile(file: MultiPartFile): any;
-}
-export {};

package/lib/net/client.js

@@ -1,108 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LaraClient = void 0;
-const crypto_1 = __importDefault(require("../crypto"));
-const errors_1 = require("../errors");
-const sdk_version_1 = require("../sdk-version");
-function parseContent(content) {
-    if (content === undefined || content === null)
-        return content;
-    if (Array.isArray(content))
-        return content.map(parseContent);
-    if (typeof content === "string") {
-        // Test if it's a date
-        if (content.match(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[0-9]{3}Z$/))
-            return new Date(content);
-        else
-            return content;
-    }
-    if (typeof content === "object") {
-        const result = {};
-        for (const [key, value] of Object.entries(content)) {
-            const camelKey = key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-            result[camelKey] = parseContent(value);
-        }
-        return result;
-    }
-    return content;
-}
-/** @internal */
-class LaraClient {
-    constructor(accessKeyId, accessKeySecret) {
-        this.crypto = (0, crypto_1.default)();
-        this.extraHeaders = {};
-        this.accessKeyId = accessKeyId;
-        this.accessKeySecret = accessKeySecret;
-    }
-    setExtraHeader(name, value) {
-        this.extraHeaders[name] = value;
-    }
-    get(path, params, headers) {
-        return this.request("GET", path, params, undefined, headers);
-    }
-    delete(path, params, headers) {
-        return this.request("DELETE", path, params, undefined, headers);
-    }
-    post(path, body, files, headers) {
-        return this.request("POST", path, body, files, headers);
-    }
-    put(path, body, files, headers) {
-        return this.request("PUT", path, body, files, headers);
-    }
-    async request(method, path, body, files, headers) {
-        if (!path.startsWith("/"))
-            path = `/${path}`;
-        const _headers = {
-            "X-HTTP-Method-Override": method,
-            "X-Lara-Date": new Date().toUTCString(),
-            "X-Lara-SDK-Name": "lara-node",
-            "X-Lara-SDK-Version": sdk_version_1.version,
-            ...this.extraHeaders,
-            ...headers
-        };
-        if (body) {
-            body = Object.fromEntries(Object.entries(body).filter(([_, v]) => v !== undefined && v !== null));
-            if (Object.keys(body).length === 0)
-                body = undefined;
-            if (body) {
-                const jsonBody = JSON.stringify(body, undefined, 0);
-                _headers["Content-MD5"] = await this.crypto.digest(jsonBody);
-            }
-        }
-        let requestBody;
-        if (files) {
-            // validate files
-            for (const [key, file] of Object.entries(files))
-                files[key] = this.wrapMultiPartFile(file);
-            _headers["Content-Type"] = "multipart/form-data";
-            requestBody = Object.assign({}, files, body);
-        }
-        else {
-            _headers["Content-Type"] = "application/json";
-            if (body)
-                requestBody = body;
-        }
-        const signature = await this.sign(method, path, _headers);
-        _headers.Authorization = `Lara ${this.accessKeyId}:${signature}`;
-        const response = await this.send(path, _headers, requestBody);
-        if (200 <= response.statusCode && response.statusCode < 300) {
-            return parseContent(response.body.content);
-        }
-        else {
-            const error = response.body.error || {};
-            throw new errors_1.LaraApiError(response.statusCode, error.type || "UnknownError", error.message || "An unknown error occurred");
-        }
-    }
-    async sign(method, path, headers) {
-        const date = headers["X-Lara-Date"].trim();
-        const contentMD5 = (headers["Content-MD5"] || "").trim();
-        const contentType = (headers["Content-Type"] || "").trim();
-        const httpMethod = (headers["X-HTTP-Method-Override"] || method).trim().toUpperCase();
-        const challenge = `${httpMethod}\n${path}\n${contentMD5}\n${contentType}\n${date}`;
-        return await this.crypto.hmac(this.accessKeySecret, challenge);
-    }
-}
-exports.LaraClient = LaraClient;

package/lib/net/index.d.ts

@@ -1,3 +0,0 @@
-import type { LaraClient } from "./client";
-export { LaraClient } from "./client";
-export default function create(accessKeyId: string, accessKeySecret: string, baseUrl?: string): LaraClient;

package/lib/net/index.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LaraClient = void 0;
-exports.default = create;
-const browser_client_1 = require("./browser-client");
-const node_client_1 = require("./node-client");
-var client_1 = require("./client");
-Object.defineProperty(exports, "LaraClient", { enumerable: true, get: function () { return client_1.LaraClient; } });
-const DEFAULT_BASE_URL = "https://api.laratranslate.com";
-function create(accessKeyId, accessKeySecret, baseUrl) {
-    const url = new URL(baseUrl || DEFAULT_BASE_URL);
-    if (url.protocol !== "https:" && url.protocol !== "http:")
-        throw new TypeError(`Invalid URL (protocol): ${url.protocol}`);
-    const parsedURL = {
-        secure: url.protocol === "https:",
-        hostname: url.hostname,
-        port: url.port ? parseInt(url.port, 10) : url.protocol === "https:" ? 443 : 80
-    };
-    if (typeof window !== "undefined")
-        return new browser_client_1.BrowserLaraClient(parsedURL, accessKeyId, accessKeySecret);
-    else
-        return new node_client_1.NodeLaraClient(parsedURL, accessKeyId, accessKeySecret);
-}