transl8-srt 1.0.2 → 1.1.0

package/dist/index.d.cts

@@ -57,6 +57,19 @@ interface TranslateOptions {
     concurrency?: number;
     /** Enable AI primer call — for general/unknown content only */
     primer?: boolean;
+    /**
+     * Soft token budget per batch (default 4000), estimated at ~4 chars/token.
+     * A batch closes early (before hitting batchSize) once its accumulated
+     * sentence text would exceed this, so unusually long sentences don't
+     * produce oversized requests. Purely a heuristic — no tokenizer dependency.
+     */
+    maxBatchTokens?: number;
+    /**
+     * Request strict JSON output via the provider's response_format param
+     * (default true). Disable for custom providers that reject or ignore
+     * response_format — the system prompt's JSON instructions still apply.
+     */
+    jsonMode?: boolean;
 }
 interface TranslatedCue extends Cue {
     translatedText: string;
@@ -76,9 +89,13 @@ interface TranslationStats {
     totalCues: number;
     totalSentences: number;
     totalBatches: number;
+    /** Indices of batches that failed after all retries — their sentences fall back to original text */
+    failedBatches: number[];
     inputTokens: number;
     outputTokens: number;
     estimatedCostUsd: number;
+    /** False when the resolved model isn't in the known price table — estimatedCostUsd is a meaningless 0 in that case */
+    costTracked: boolean;
     durationMs: number;
 }
 interface BatchPayload {

package/dist/index.d.ts

@@ -57,6 +57,19 @@ interface TranslateOptions {
     concurrency?: number;
     /** Enable AI primer call — for general/unknown content only */
     primer?: boolean;
+    /**
+     * Soft token budget per batch (default 4000), estimated at ~4 chars/token.
+     * A batch closes early (before hitting batchSize) once its accumulated
+     * sentence text would exceed this, so unusually long sentences don't
+     * produce oversized requests. Purely a heuristic — no tokenizer dependency.
+     */
+    maxBatchTokens?: number;
+    /**
+     * Request strict JSON output via the provider's response_format param
+     * (default true). Disable for custom providers that reject or ignore
+     * response_format — the system prompt's JSON instructions still apply.
+     */
+    jsonMode?: boolean;
 }
 interface TranslatedCue extends Cue {
     translatedText: string;
@@ -76,9 +89,13 @@ interface TranslationStats {
     totalCues: number;
     totalSentences: number;
     totalBatches: number;
+    /** Indices of batches that failed after all retries — their sentences fall back to original text */
+    failedBatches: number[];
     inputTokens: number;
     outputTokens: number;
     estimatedCostUsd: number;
+    /** False when the resolved model isn't in the known price table — estimatedCostUsd is a meaningless 0 in that case */
+    costTracked: boolean;
     durationMs: number;
 }
 interface BatchPayload {