prompsit-cli 26.225.1206 → 26.227.2006

package/dist/api/resources/discovery.d.ts

@@ -0,0 +1,26 @@
+import type { AuthSession } from "../auth-session.ts";
+import { type FormatInfo, type QeFormatInfo, type DataScoreFormatsResponse, type DataAnnotateFormatsResponse, type AnnotateOptionsResponse } from "../models.ts";
+/**
+ * Discovery API resource for format/options discovery across all services.
+ *
+ * All endpoints are public (LIGHT rate limit), but use AuthSession for
+ * consistency with the existing resource pattern.
+ */
+export declare class DiscoveryResource {
+    private readonly session;
+    private readonly baseUrl;
+    constructor(session: AuthSession, baseUrl: string);
+    /** Shared GET + Zod parse. Eliminates boilerplate across 5 discovery methods. */
+    private get;
+    /** GET /v1/translation/document/formats — document translation formats. */
+    documentFormats(): Promise<FormatInfo[]>;
+    /** GET /v1/quality/score/formats — QE file scoring formats. */
+    qeFormats(): Promise<QeFormatInfo[]>;
+    /** GET /v1/data/score/formats — Bicleaner scoring formats. */
+    dataScoreFormats(): Promise<DataScoreFormatsResponse>;
+    /** GET /v1/data/annotate/formats — annotation input formats. */
+    dataAnnotateFormats(): Promise<DataAnnotateFormatsResponse>;
+    /** GET /v1/data/annotate/options — pipeline stages, LID models, defaults. */
+    annotateOptions(): Promise<AnnotateOptionsResponse>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/api/resources/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/api/resources/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAML,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAGtB;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD,iFAAiF;YACnE,GAAG;IAKjB,2EAA2E;IACrE,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK9C,+DAA+D;IACzD,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK1C,8DAA8D;IACxD,gBAAgB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAI3D,gEAAgE;IAC1D,mBAAmB,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAIjE,6EAA6E;IACvE,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;CAG1D"}

package/dist/api/resources/discovery.js

@@ -0,0 +1,46 @@
+// Discovery API resource — format and options endpoints for all services.
+// Replaces FormatsResource (which only covered document translation formats).
+import { FormatsResponseSchema, QeFormatsResponseSchema, DataScoreFormatsResponseSchema, DataAnnotateFormatsResponseSchema, AnnotateOptionsResponseSchema, } from "../models.js";
+import { Endpoint } from "../../constants.js";
+/**
+ * Discovery API resource for format/options discovery across all services.
+ *
+ * All endpoints are public (LIGHT rate limit), but use AuthSession for
+ * consistency with the existing resource pattern.
+ */
+export class DiscoveryResource {
+    session;
+    baseUrl;
+    constructor(session, baseUrl) {
+        this.session = session;
+        this.baseUrl = baseUrl;
+    }
+    /** Shared GET + Zod parse. Eliminates boilerplate across 5 discovery methods. */
+    async get(endpoint, schema) {
+        const data = await this.session.request("GET", `${this.baseUrl}${endpoint}`, {});
+        return schema.parse(data);
+    }
+    /** GET /v1/translation/document/formats — document translation formats. */
+    async documentFormats() {
+        const result = await this.get(Endpoint.DOCUMENT_FORMATS, FormatsResponseSchema);
+        return result.formats;
+    }
+    /** GET /v1/quality/score/formats — QE file scoring formats. */
+    async qeFormats() {
+        const result = await this.get(Endpoint.QE_FORMATS, QeFormatsResponseSchema);
+        return result.formats;
+    }
+    /** GET /v1/data/score/formats — Bicleaner scoring formats. */
+    async dataScoreFormats() {
+        return this.get(Endpoint.DATA_SCORE_FORMATS, DataScoreFormatsResponseSchema);
+    }
+    /** GET /v1/data/annotate/formats — annotation input formats. */
+    async dataAnnotateFormats() {
+        return this.get(Endpoint.DATA_ANNOTATE_FORMATS, DataAnnotateFormatsResponseSchema);
+    }
+    /** GET /v1/data/annotate/options — pipeline stages, LID models, defaults. */
+    async annotateOptions() {
+        return this.get(Endpoint.DATA_ANNOTATE_OPTIONS, AnnotateOptionsResponseSchema);
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/api/resources/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/api/resources/discovery.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAI9E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,iCAAiC,EACjC,6BAA6B,GAM9B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,iFAAiF;IACzE,KAAK,CAAC,GAAG,CAAI,QAAgB,EAAE,MAAoB;QACzD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1F,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,eAAe;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QAChF,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,8BAA8B,CAAC,CAAC;IAC/E,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,mBAAmB;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,EAAE,iCAAiC,CAAC,CAAC;IACrF,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/api/resources/evaluation.d.ts

@@ -1,26 +1,23 @@
 import type { AuthSession } from "../auth-session.ts";
-import { type EvaluationResponse, type Segment } from "../models.ts";
+import { type EvaluationResponse, type EvaluateParams, type EvaluateFileParams, type EvaluateFileResult } from "../models.ts";
 /**
  * Evaluation API resource.
  *
- * Calls POST /v1/translation/score via AuthSession (requires auth).
- * Validates response with Zod schema at boundary.
+ * - evaluate(): POST /v1/quality/score (JSON inline, via AuthSession)
+ * - evaluateFile(): POST /v1/quality/score/file (multipart upload, binary response via requestRaw)
  */
 export declare class EvaluationResource {
     private readonly session;
     private readonly baseUrl;
     constructor(session: AuthSession, baseUrl: string);
+    /** Evaluate translation quality with specified metrics (inline segments). */
+    evaluate(params: EvaluateParams): Promise<EvaluationResponse>;
     /**
-     * Evaluate translation quality with specified metrics.
+     * Score a file via POST /v1/quality/score/file (multipart upload, binary response).
      *
-     * @param segments - Array of source/hypothesis/reference triplets
-     * @param metrics - Array of metric names (e.g. ["bleu", "chrf", "metricx"])
-     * @param aggregation - Aggregation mode (default "both" for corpus + segment)
-     * @returns Validated EvaluationResponse with corpus_scores and segment_scores
-     * @throws AuthenticationError if not authenticated
-     * @throws ZodError if response schema mismatch
-     * @throws APIError on API errors
+     * Uses requestRaw() (buffer + headers) because we need X-Corpus-Scores header.
+     * File size bounded by JOB_MAX_DOCUMENT_SIZE_MB (50MB) — safe to buffer.
      */
-    evaluate(segments: Segment[], metrics: string[], aggregation?: string): Promise<EvaluationResponse>;
+    evaluateFile(params: EvaluateFileParams, outputPath: string, signal?: AbortSignal): Promise<EvaluateFileResult>;
 }
 //# sourceMappingURL=evaluation.d.ts.map

package/dist/api/resources/evaluation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../../src/api/resources/evaluation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA4B,KAAK,kBAAkB,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/F;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,SAAS,GACnB,OAAO,CAAC,kBAAkB,CAAC;CAW/B"}
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../../src/api/resources/evaluation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD,6EAA6E;IACvE,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAcnE;;;;;OAKG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC;CA6B/B"}

package/dist/api/resources/evaluation.js

@@ -1,12 +1,15 @@
-// See API-477: Evaluation resource - POST /v1/translation/score with Zod validation
-// Uses AuthSession (authenticated requests with auto-refresh).
-import { EvaluationResponseSchema } from "../models.js";
+// Evaluation resource - POST /v1/quality/score (inline) + POST /v1/quality/score/file (file)
+// Both methods go through AuthSession for auth, retry, hooks, and error classification.
+import { openAsBlob } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { EvaluationResponseSchema, } from "../models.js";
 import { Endpoint } from "../../constants.js";
 /**
  * Evaluation API resource.
  *
- * Calls POST /v1/translation/score via AuthSession (requires auth).
- * Validates response with Zod schema at boundary.
+ * - evaluate(): POST /v1/quality/score (JSON inline, via AuthSession)
+ * - evaluateFile(): POST /v1/quality/score/file (multipart upload, binary response via requestRaw)
  */
 export class EvaluationResource {
     session;
@@ -15,24 +18,46 @@ export class EvaluationResource {
         this.session = session;
         this.baseUrl = baseUrl;
     }
+    /** Evaluate translation quality with specified metrics (inline segments). */
+    async evaluate(params) {
+        const { segments, metrics, aggregation = "both" } = params;
+        const data = await this.session.request("POST", `${this.baseUrl}${Endpoint.EVALUATE}`, {
+            json: { segments, metrics, aggregation },
+        });
+        return EvaluationResponseSchema.parse(data);
+    }
     /**
-     * Evaluate translation quality with specified metrics.
+     * Score a file via POST /v1/quality/score/file (multipart upload, binary response).
      *
-     * @param segments - Array of source/hypothesis/reference triplets
-     * @param metrics - Array of metric names (e.g. ["bleu", "chrf", "metricx"])
-     * @param aggregation - Aggregation mode (default "both" for corpus + segment)
-     * @returns Validated EvaluationResponse with corpus_scores and segment_scores
-     * @throws AuthenticationError if not authenticated
-     * @throws ZodError if response schema mismatch
-     * @throws APIError on API errors
+     * Uses requestRaw() (buffer + headers) because we need X-Corpus-Scores header.
+     * File size bounded by JOB_MAX_DOCUMENT_SIZE_MB (50MB) — safe to buffer.
      */
-    async evaluate(segments, metrics, aggregation = "both") {
-        const baseUrl = this.baseUrl;
-        const body = { segments, metrics, aggregation };
-        const data = await this.session.request("POST", `${baseUrl}${Endpoint.EVALUATE}`, {
-            json: body,
-        });
-        return EvaluationResponseSchema.parse(data);
+    async evaluateFile(params, outputPath, signal) {
+        const { filePath, metrics, aggregation = "both", outputFormat } = params;
+        const url = `${this.baseUrl}${Endpoint.EVALUATE_FILE}`;
+        // Build multipart form (openAsBlob streams from disk without buffering)
+        const fileBlob = await openAsBlob(filePath);
+        const formData = new FormData();
+        formData.append("file", fileBlob, basename(filePath));
+        if (metrics?.length)
+            formData.append("metrics", metrics.join(","));
+        formData.append("aggregation", aggregation);
+        if (outputFormat)
+            formData.append("output_format", outputFormat);
+        const response = await this.session.requestRaw("POST", url, { body: formData }, signal);
+        // Parse corpus scores from X-Corpus-Scores header
+        let corpusScores = {};
+        const scoresHeader = response.headers["x-corpus-scores"];
+        if (typeof scoresHeader === "string") {
+            try {
+                corpusScores = JSON.parse(scoresHeader);
+            }
+            catch {
+                /* malformed header */
+            }
+        }
+        await writeFile(outputPath, response.body, { signal });
+        return { data: Buffer.alloc(0), filename: outputPath, corpusScores };
     }
 }
 //# sourceMappingURL=evaluation.js.map

package/dist/api/resources/evaluation.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../../../src/api/resources/evaluation.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+DAA+D;AAG/D,OAAO,EAAE,wBAAwB,EAAyC,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAmB,EACnB,OAAiB,EACjB,WAAW,GAAG,MAAM;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,MAAM,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE;YACzF,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../../../src/api/resources/evaluation.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,wFAAwF;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,EACL,wBAAwB,GAKzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;QAE3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,MAAM,EACN,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,EACrC;YACE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;SACzC,CACF,CAAC;QAEF,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,MAA0B,EAC1B,UAAkB,EAClB,MAAoB;QAEpB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QACzE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QAEvD,wEAAwE;QACxE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,IAAI,OAAO,EAAE,MAAM;YAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,YAAY;YAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;QAExF,kDAAkD;QAClD,IAAI,YAAY,GAA2B,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACzD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAA2B,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/api/resources/formats.d.ts

@@ -3,7 +3,7 @@ import { type FormatInfo } from "../models.ts";
 /**
  * Formats API resource.
  *
- * Calls GET /v1/formats via AuthSession (requires auth).
+ * Calls GET /v1/translation/document/formats via AuthSession (requires auth).
  * Validates response with Zod schema at boundary.
  */
 export declare class FormatsResource {

package/dist/api/resources/formats.js

@@ -1,11 +1,11 @@
-// See API-484: Formats resource - GET /v1/formats with Zod validation
+// See API-484: Formats resource - GET /v1/translation/document/formats with Zod validation
 // Uses AuthSession (authenticated requests with auto-refresh).
 import { FormatsResponseSchema } from "../models.js";
 import { Endpoint } from "../../constants.js";
 /**
  * Formats API resource.
  *
- * Calls GET /v1/formats via AuthSession (requires auth).
+ * Calls GET /v1/translation/document/formats via AuthSession (requires auth).
  * Validates response with Zod schema at boundary.
  */
 export class FormatsResource {

package/dist/api/resources/formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../src/api/resources/formats.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,+DAA+D;AAG/D,OAAO,EAAE,qBAAqB,EAAmB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAE7F,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../../src/api/resources/formats.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+DAA+D;AAG/D,OAAO,EAAE,qBAAqB,EAAmB,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAE7F,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;CACF"}

package/dist/api/resources/jobs.d.ts

@@ -19,17 +19,16 @@ export declare class JobsResource {
      */
     cancel(jobId: string): Promise<void>;
     /**
-     * Download job result to file with streaming and auto-extension detection.
+     * Download job result to file via streaming.
      *
-     * Parses Content-Disposition header for server-indicated filename/extension.
-     * Streams response body to disk via pipeline to avoid OOM on large files.
+     * Uses requestToFile() for memory-safe streaming (annotation jobs can be up to 10GB).
+     * Client owns output filenames — no Content-Disposition parsing.
      *
      * @param jobId - Job identifier
-     * @param outputPath - Desired output file path
-     * @returns Actual output path (may differ if server indicates format conversion)
-     * @throws AuthenticationError if not authenticated
-     * @throws APIError on API errors (404 not found, job not completed)
+     * @param outputPath - Output file path (computed by resolveOutputPaths)
+     * @param signal - Optional abort signal for cancellation
+     * @returns The output path
      */
-    download(jobId: string, outputPath: string): Promise<string>;
+    download(jobId: string, outputPath: string, signal?: AbortSignal): Promise<string>;
 }
 //# sourceMappingURL=jobs.d.ts.map

package/dist/api/resources/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/api/resources/jobs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI/E;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASvD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2CnE"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/api/resources/jobs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG/E;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASvD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAMzF"}

package/dist/api/resources/jobs.js

@@ -1,14 +1,8 @@
 // Jobs resource - status, cancel, download with Zod validation
 // Used by translate file and data commands for job lifecycle.
-// Download uses got streaming + Content-Disposition header parsing.
-import { createWriteStream } from "node:fs";
-import { rename } from "node:fs/promises";
-import { pipeline } from "node:stream/promises";
-import { extname, dirname, basename, join } from "node:path";
-import got from "got";
+// All methods go through AuthSession for auth, retry, hooks, and error classification.
 import { JobStatusResponseSchema } from "../models.js";
-import { getAccessToken } from "../../config/credentials.js";
-import { Endpoint, HEADER_AUTHORIZATION, BEARER_PREFIX } from "../../constants.js";
+import { Endpoint } from "../../constants.js";
 /**
  * Jobs API resource.
  *
@@ -40,53 +34,20 @@ export class JobsResource {
         await this.session.request("DELETE", url);
     }
     /**
-     * Download job result to file with streaming and auto-extension detection.
+     * Download job result to file via streaming.
      *
-     * Parses Content-Disposition header for server-indicated filename/extension.
-     * Streams response body to disk via pipeline to avoid OOM on large files.
+     * Uses requestToFile() for memory-safe streaming (annotation jobs can be up to 10GB).
+     * Client owns output filenames — no Content-Disposition parsing.
      *
      * @param jobId - Job identifier
-     * @param outputPath - Desired output file path
-     * @returns Actual output path (may differ if server indicates format conversion)
-     * @throws AuthenticationError if not authenticated
-     * @throws APIError on API errors (404 not found, job not completed)
+     * @param outputPath - Output file path (computed by resolveOutputPaths)
+     * @param signal - Optional abort signal for cancellation
+     * @returns The output path
      */
-    async download(jobId, outputPath) {
+    async download(jobId, outputPath, signal) {
         const baseUrl = this.baseUrl;
         const url = `${baseUrl}${Endpoint.JOB_RESULT.replace("{job_id}", jobId)}`;
-        // Use got.stream() for memory-efficient download of large files.
-        // Cannot use session.request because transport forces responseType:"json".
-        const token = getAccessToken();
-        const headers = {};
-        if (token) {
-            headers[HEADER_AUTHORIZATION] = `${BEARER_PREFIX} ${token}`;
-        }
-        // Stream to initial output path, then rename if Content-Disposition indicates
-        // a different extension (e.g., PDF input converted to DOCX output).
-        let actualPath = outputPath;
-        const stream = got.stream(url, { method: "GET", headers });
-        // Listen for response event to parse Content-Disposition before streaming body
-        stream.on("response", (response) => {
-            const cd = response.headers["content-disposition"] ?? "";
-            if (cd.includes("filename=")) {
-                const match = /filename="?([^";\s]+)"?/.exec(cd);
-                if (match) {
-                    const serverExt = extname(match[1]);
-                    if (serverExt && serverExt !== extname(outputPath)) {
-                        const base = basename(outputPath, extname(outputPath));
-                        actualPath = join(dirname(outputPath), `${base}${serverExt}`);
-                    }
-                }
-            }
-        });
-        // Stream response body to file via pipeline (backpressure-aware)
-        const fileStream = createWriteStream(outputPath);
-        await pipeline(stream, fileStream);
-        // If Content-Disposition indicated a different extension, rename the file
-        if (actualPath !== outputPath) {
-            await rename(outputPath, actualPath);
-        }
-        return actualPath;
+        return this.session.requestToFile("GET", url, outputPath, {}, signal);
     }
 }
 //# sourceMappingURL=jobs.js.map

package/dist/api/resources/jobs.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../src/api/resources/jobs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../src/api/resources/jobs.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,uFAAuF;AAGvF,OAAO,EAAE,uBAAuB,EAA0B,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;QAEnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,CAAC,CAAC;QAE7D,OAAO,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;QAEnE,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,QAAQ,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,UAAkB,EAAE,MAAoB;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;QAE1E,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/api/resources/languages.d.ts

@@ -0,0 +1,25 @@
+import type { AuthSession } from "../auth-session.ts";
+import { type LanguagePairDetail } from "../models.ts";
+/**
+ * Languages API resource.
+ *
+ * Calls GET /v1/translation/languages via AuthSession (requires auth).
+ * Validates response with Zod schema at boundary.
+ */
+export declare class LanguagesResource {
+    private readonly session;
+    private readonly baseUrl;
+    constructor(session: AuthSession, baseUrl: string);
+    /**
+     * List available language pairs.
+     *
+     * @param source - Optional source language code filter (BCP 47)
+     * @param target - Optional target language code filter (BCP 47)
+     * @returns Validated array of LanguagePairDetail objects
+     * @throws AuthenticationError if not authenticated
+     * @throws ZodError if response schema mismatch
+     * @throws APIError on API errors
+     */
+    list(source?: string, target?: string): Promise<LanguagePairDetail[]>;
+}
+//# sourceMappingURL=languages.d.ts.map

package/dist/api/resources/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/api/resources/languages.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGjF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAiB5E"}

package/dist/api/resources/languages.js

@@ -0,0 +1,44 @@
+// Languages resource - GET /v1/translation/languages with Zod validation
+// Uses AuthSession (authenticated requests with auto-refresh).
+import { z } from "zod";
+import { LanguagePairDetailSchema } from "../models.js";
+import { Endpoint } from "../../constants.js";
+/**
+ * Languages API resource.
+ *
+ * Calls GET /v1/translation/languages via AuthSession (requires auth).
+ * Validates response with Zod schema at boundary.
+ */
+export class LanguagesResource {
+    session;
+    baseUrl;
+    constructor(session, baseUrl) {
+        this.session = session;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List available language pairs.
+     *
+     * @param source - Optional source language code filter (BCP 47)
+     * @param target - Optional target language code filter (BCP 47)
+     * @returns Validated array of LanguagePairDetail objects
+     * @throws AuthenticationError if not authenticated
+     * @throws ZodError if response schema mismatch
+     * @throws APIError on API errors
+     */
+    async list(source, target) {
+        const baseUrl = this.baseUrl;
+        const params = {};
+        if (source) {
+            params.source = source;
+        }
+        if (target) {
+            params.target = target;
+        }
+        const data = await this.session.request("GET", `${baseUrl}${Endpoint.LANGUAGES}`, {
+            searchParams: params,
+        });
+        return z.array(LanguagePairDetailSchema).parse(data);
+    }
+}
+//# sourceMappingURL=languages.js.map

package/dist/api/resources/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../../src/api/resources/languages.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+DAA+D;AAE/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAA2B,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,MAAe,EAAE,MAAe;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,KAAK,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE;YACzF,YAAY,EAAE,MAAM;SACrB,CAAC,CAAC;QAEH,OAAO,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/api/resources/translation.d.ts

@@ -1,12 +1,12 @@
 import type { AuthSession } from "../auth-session.ts";
-import { type TranslationResponse, type DocJobCreateResponse } from "../models.ts";
+import { type TranslationResponse, type DocJobCreateResponse, type TranslateParams, type UploadDocumentParams } from "../models.ts";
 /**
  * Translation API resource.
  *
- * Calls POST /v1/translate via AuthSession (requires auth).
+ * Calls POST /v1/translation via AuthSession (requires auth).
  * Validates response with Zod schema at boundary.
- * - translate(): POST /v1/translate (text translation)
- * - uploadDocument(): POST /v1/documents/translate (async file processing)
+ * - translate(): POST /v1/translation (text translation)
+ * - uploadDocument(): POST /v1/translation/document (async file processing)
  */
 export declare class TranslationResource {
     private readonly session;
@@ -15,32 +15,24 @@ export declare class TranslationResource {
     /**
      * Translate texts via API.
      *
-     * @param texts - Array of strings to translate
-     * @param sourceLang - Source language code
-     * @param targetLang - Target language code
-     * @param enableQe - Enable quality estimation scores (default false)
+     * @param params - Translation parameters (texts, languages, QE flag)
      * @returns Validated TranslationResponse
      * @throws AuthenticationError if not authenticated
      * @throws ZodError if response schema mismatch
      * @throws APIError on API errors (422 invalid lang pair, etc.)
      */
-    translate(texts: string[], sourceLang: string, targetLang: string, enableQe?: boolean): Promise<TranslationResponse>;
+    translate(params: TranslateParams): Promise<TranslationResponse>;
     /**
      * Upload document for async translation.
      *
      * Sends multipart/form-data POST with file + metadata fields.
      * Uses openAsBlob for memory-efficient streaming from disk.
      *
-     * @param filePath - Path to document file
-     * @param sourceLang - Source language code
-     * @param targetLang - Target language code
-     * @param options - Optional upload parameters
+     * @param params - Upload parameters (file path, languages, output format)
      * @returns Validated DocJobCreateResponse with job_id for tracking
      * @throws AuthenticationError if not authenticated
      * @throws APIError on API errors (422 unsupported format, 413 file too large)
      */
-    uploadDocument(filePath: string, sourceLang: string, targetLang: string, options?: {
-        outputFormat?: string;
-    }): Promise<DocJobCreateResponse>;
+    uploadDocument(params: UploadDocumentParams): Promise<DocJobCreateResponse>;
 }
 //# sourceMappingURL=translation.d.ts.map

package/dist/api/resources/translation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../../src/api/resources/translation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AAKtB;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;;;;;;;;;;OAWG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,UAAQ,GACf,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;;;;;;;;;;;;OAaG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,oBAAoB,CAAC;CAuBjC"}
+{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../../src/api/resources/translation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AAKtB;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;IAKjD;;;;;;;;OAQG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqBtE;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAwBlF"}

package/dist/api/resources/translation.js

@@ -7,10 +7,10 @@ import { basename } from "node:path";
 /**
  * Translation API resource.
  *
- * Calls POST /v1/translate via AuthSession (requires auth).
+ * Calls POST /v1/translation via AuthSession (requires auth).
  * Validates response with Zod schema at boundary.
- * - translate(): POST /v1/translate (text translation)
- * - uploadDocument(): POST /v1/documents/translate (async file processing)
+ * - translate(): POST /v1/translation (text translation)
+ * - uploadDocument(): POST /v1/translation/document (async file processing)
  */
 export class TranslationResource {
     session;
@@ -22,16 +22,14 @@ export class TranslationResource {
     /**
      * Translate texts via API.
      *
-     * @param texts - Array of strings to translate
-     * @param sourceLang - Source language code
-     * @param targetLang - Target language code
-     * @param enableQe - Enable quality estimation scores (default false)
+     * @param params - Translation parameters (texts, languages, QE flag)
      * @returns Validated TranslationResponse
      * @throws AuthenticationError if not authenticated
      * @throws ZodError if response schema mismatch
      * @throws APIError on API errors (422 invalid lang pair, etc.)
      */
-    async translate(texts, sourceLang, targetLang, enableQe = false) {
+    async translate(params) {
+        const { texts, sourceLang, targetLang, enableQe = false } = params;
         const baseUrl = this.baseUrl;
         const body = {
             texts,
@@ -52,15 +50,13 @@ export class TranslationResource {
      * Sends multipart/form-data POST with file + metadata fields.
      * Uses openAsBlob for memory-efficient streaming from disk.
      *
-     * @param filePath - Path to document file
-     * @param sourceLang - Source language code
-     * @param targetLang - Target language code
-     * @param options - Optional upload parameters
+     * @param params - Upload parameters (file path, languages, output format)
      * @returns Validated DocJobCreateResponse with job_id for tracking
      * @throws AuthenticationError if not authenticated
      * @throws APIError on API errors (422 unsupported format, 413 file too large)
      */
-    async uploadDocument(filePath, sourceLang, targetLang, options) {
+    async uploadDocument(params) {
+        const { filePath, sourceLang, targetLang, outputFormat } = params;
         const baseUrl = this.baseUrl;
         // See API-494: openAsBlob streams from disk without buffering entire file
         const fileBlob = await openAsBlob(filePath);
@@ -69,8 +65,8 @@ export class TranslationResource {
         formData.append("file", fileBlob, fileName);
         formData.append("source_lang", sourceLang);
         formData.append("target_lang", targetLang);
-        if (options?.outputFormat) {
-            formData.append("output_format", options.outputFormat);
+        if (outputFormat) {
+            formData.append("output_format", outputFormat);
         }
         const data = await this.session.request("POST", `${baseUrl}${Endpoint.DOCUMENT_TRANSLATE}`, { body: formData });
         return DocJobCreateResponseSchema.parse(data);

package/dist/api/resources/translation.js.map

@@ -1 +1 @@
-{"version":3,"file":"translation.js","sourceRoot":"","sources":["../../../src/api/resources/translation.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+DAA+D;AAG/D,OAAO,EACL,yBAAyB,EAEzB,0BAA0B,GAE3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,CACb,KAAe,EACf,UAAkB,EAClB,UAAkB,EAClB,QAAQ,GAAG,KAAK;QAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,UAAU;SACxB,CAAC;QAEF,gDAAgD;QAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,MAAM,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE;YAC1F,IAAI,EAAE,IAAI;YACV,YAAY;SACb,CAAC,CAAC;QAEH,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,UAAkB,EAClB,UAAkB,EAClB,OAEC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC1B,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,MAAM,EACN,GAAG,OAAO,GAAG,QAAQ,CAAC,kBAAkB,EAAE,EAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,CACnB,CAAC;QAEF,OAAO,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}
+{"version":3,"file":"translation.js","sourceRoot":"","sources":["../../../src/api/resources/translation.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+DAA+D;AAG/D,OAAO,EACL,yBAAyB,EAEzB,0BAA0B,GAI3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAc;IACrB,OAAO,CAAS;IAEjC,YAAY,OAAoB,EAAE,OAAe;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,CAAC,MAAuB;QACrC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,UAAU;SACxB,CAAC;QAEF,gDAAgD;QAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,MAAM,EAAE,GAAG,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE;YAC1F,IAAI,EAAE,IAAI;YACV,YAAY;SACb,CAAC,CAAC;QAEH,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,cAAc,CAAC,MAA4B;QAC/C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CACrC,MAAM,EACN,GAAG,OAAO,GAAG,QAAQ,CAAC,kBAAkB,EAAE,EAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,CACnB,CAAC;QAEF,OAAO,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}