@ai-translate/provider-openai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thiago Peres
+
+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/dist/index.d.mts

@@ -0,0 +1,39 @@
+import { ReasoningEffort, SEMANTIC_AUDIT_OUTPUT_CONTRACT_MATERIAL, SEMANTIC_AUDIT_OUTPUT_CONTRACT_REVISION, SemanticAuditOutputContractMaterial, SemanticAuditPrompt, SemanticAuditPromptArgs, SemanticAuditResponseCache, StructuredCompletionMessage, StructuredCompletionRequest, StructuredCompletionTransport, StructuredCompletionTransport as StructuredCompletionTransport$1, StructuredSemanticAuditProvider, StructuredSemanticAuditProviderOptions, StructuredTranslationProvider, StructuredTranslationProviderOptions, SystemPrompt, SystemPromptArgs, TRANSLATION_OUTPUT_CONTRACT_MATERIAL, TRANSLATION_OUTPUT_CONTRACT_REVISION, TranslationOutputContractMaterial, createSemanticAuditOutputContractRevision, createTranslationOutputContractRevision } from "@ai-translate/provider-core";
+import OpenAI from "openai";
+import { SemanticAuditProvider, TranslationProvider } from "@ai-translate/core/types";
+//#region src/index.d.ts
+/**
+ * Reasoning-capable and inexpensive. Callers who want a different trade-off
+ * pass `model` explicitly.
+ */
+declare const DEFAULT_MODEL = "gpt-5.6-luna";
+interface OpenAiTransportOptions {
+  apiKey?: string;
+  client?: OpenAI;
+  requestTimeoutMs?: number;
+}
+/**
+ * Speaks the OpenAI Chat Completions dialect of the engine's request contract.
+ * Retries stay off here because the engine owns the retry and repair loop.
+ */
+declare function createOpenAiTransport(options?: OpenAiTransportOptions): StructuredCompletionTransport$1;
+interface OpenAiTranslationProviderOptions extends Omit<StructuredTranslationProviderOptions, "model" | "transport"> {
+  apiKey?: string;
+  client?: OpenAI;
+  model?: string;
+}
+declare class OpenAiTranslationProvider extends StructuredTranslationProvider {
+  constructor(options?: OpenAiTranslationProviderOptions);
+}
+interface OpenAiSemanticAuditProviderOptions extends Omit<StructuredSemanticAuditProviderOptions, "transport"> {
+  apiKey?: string;
+  client?: OpenAI;
+}
+declare class OpenAiSemanticAuditProvider extends StructuredSemanticAuditProvider {
+  constructor(options?: OpenAiSemanticAuditProviderOptions);
+}
+declare function createOpenAiTranslationProvider(options?: OpenAiTranslationProviderOptions): TranslationProvider;
+declare function createOpenAiSemanticAuditProvider(options?: OpenAiSemanticAuditProviderOptions): SemanticAuditProvider;
+//#endregion
+export { DEFAULT_MODEL, OpenAiSemanticAuditProvider, OpenAiSemanticAuditProviderOptions, OpenAiTranslationProvider, OpenAiTranslationProviderOptions, OpenAiTransportOptions, type ReasoningEffort, SEMANTIC_AUDIT_OUTPUT_CONTRACT_MATERIAL, SEMANTIC_AUDIT_OUTPUT_CONTRACT_REVISION, type SemanticAuditOutputContractMaterial, type SemanticAuditPrompt, type SemanticAuditPromptArgs, type SemanticAuditResponseCache, type StructuredCompletionMessage, type StructuredCompletionRequest, type StructuredCompletionTransport, type SystemPrompt, type SystemPromptArgs, TRANSLATION_OUTPUT_CONTRACT_MATERIAL, TRANSLATION_OUTPUT_CONTRACT_REVISION, type TranslationOutputContractMaterial, createOpenAiSemanticAuditProvider, createOpenAiTranslationProvider, createOpenAiTransport, createSemanticAuditOutputContractRevision, createTranslationOutputContractRevision };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;cAwCa;UAII;EACf;EACA,SAAS;EACT;;;;;;iBAOc,sBACd,UAAS,yBACR;UA0Cc,yCACP,KAAK;EACb;EACA,SAAS;EACT;;cAGW,kCAAkC;EAC7C,YAAY,UAAS;;UAgBN,2CACP,KAAK;EACb;EACA,SAAS;;cAGE,oCAAoC;EAC/C,YAAY,UAAS;;iBAeP,gCACd,UAAS,mCACR;iBAIa,kCACd,UAAS,qCACR"}

package/dist/index.mjs

@@ -0,0 +1,81 @@
+import { SEMANTIC_AUDIT_OUTPUT_CONTRACT_MATERIAL, SEMANTIC_AUDIT_OUTPUT_CONTRACT_REVISION, StructuredSemanticAuditProvider, StructuredTranslationProvider, TRANSLATION_OUTPUT_CONTRACT_MATERIAL, TRANSLATION_OUTPUT_CONTRACT_REVISION, createSemanticAuditOutputContractRevision, createTranslationOutputContractRevision } from "@ai-translate/provider-core";
+import OpenAI from "openai";
+import { zodResponseFormat } from "openai/helpers/zod";
+//#region src/index.ts
+/**
+* Reasoning-capable and inexpensive. Callers who want a different trade-off
+* pass `model` explicitly.
+*/
+const DEFAULT_MODEL = "gpt-5.6-luna";
+const DEFAULT_REQUEST_TIMEOUT_MS = 12e4;
+/**
+* Speaks the OpenAI Chat Completions dialect of the engine's request contract.
+* Retries stay off here because the engine owns the retry and repair loop.
+*/
+function createOpenAiTransport(options = {}) {
+	if (!options.client && !options.apiKey) throw new Error("OpenAI transport requires either apiKey or client.");
+	const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+	const client = options.client ?? new OpenAI({
+		apiKey: options.apiKey,
+		maxRetries: 0,
+		timeout: requestTimeoutMs
+	});
+	return {
+		async complete(request) {
+			return (await client.chat.completions.parse({
+				messages: request.messages.map((message) => ({
+					content: message.content,
+					role: message.role
+				})),
+				model: request.modelId,
+				...request.maxCompletionTokens === void 0 ? {} : { max_completion_tokens: request.maxCompletionTokens },
+				...request.promptCacheKey === void 0 ? {} : { prompt_cache_key: request.promptCacheKey },
+				...request.reasoningEffort === void 0 ? {} : { reasoning_effort: request.reasoningEffort },
+				response_format: zodResponseFormat(request.schema, request.schemaName),
+				...request.temperature === void 0 ? {} : { temperature: request.temperature }
+			}, {
+				maxRetries: 0,
+				...request.signal === void 0 ? {} : { signal: request.signal },
+				timeout: requestTimeoutMs
+			})).choices[0]?.message.parsed;
+		},
+		label: "OpenAI"
+	};
+}
+var OpenAiTranslationProvider = class extends StructuredTranslationProvider {
+	constructor(options = {}) {
+		const { apiKey, client, model, ...engineOptions } = options;
+		super({
+			...engineOptions,
+			model: model ?? "gpt-5.6-luna",
+			transport: createOpenAiTransport({
+				...apiKey === void 0 ? {} : { apiKey },
+				...client === void 0 ? {} : { client },
+				...options.requestTimeoutMs === void 0 ? {} : { requestTimeoutMs: options.requestTimeoutMs }
+			})
+		});
+	}
+};
+var OpenAiSemanticAuditProvider = class extends StructuredSemanticAuditProvider {
+	constructor(options = {}) {
+		const { apiKey, client, ...engineOptions } = options;
+		super({
+			...engineOptions,
+			transport: createOpenAiTransport({
+				...apiKey === void 0 ? {} : { apiKey },
+				...client === void 0 ? {} : { client },
+				...options.requestTimeoutMs === void 0 ? {} : { requestTimeoutMs: options.requestTimeoutMs }
+			})
+		});
+	}
+};
+function createOpenAiTranslationProvider(options = {}) {
+	return new OpenAiTranslationProvider(options);
+}
+function createOpenAiSemanticAuditProvider(options = {}) {
+	return new OpenAiSemanticAuditProvider(options);
+}
+//#endregion
+export { DEFAULT_MODEL, OpenAiSemanticAuditProvider, OpenAiTranslationProvider, SEMANTIC_AUDIT_OUTPUT_CONTRACT_MATERIAL, SEMANTIC_AUDIT_OUTPUT_CONTRACT_REVISION, TRANSLATION_OUTPUT_CONTRACT_MATERIAL, TRANSLATION_OUTPUT_CONTRACT_REVISION, createOpenAiSemanticAuditProvider, createOpenAiTranslationProvider, createOpenAiTransport, createSemanticAuditOutputContractRevision, createTranslationOutputContractRevision };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { SemanticAuditProvider, TranslationProvider } from \"@ai-translate/core/types\";\nimport {\n  StructuredSemanticAuditProvider,\n  StructuredTranslationProvider,\n} from \"@ai-translate/provider-core\";\nimport type {\n  StructuredCompletionRequest,\n  StructuredCompletionTransport,\n  StructuredSemanticAuditProviderOptions,\n  StructuredTranslationProviderOptions,\n} from \"@ai-translate/provider-core\";\nimport OpenAI from \"openai\";\nimport { zodResponseFormat } from \"openai/helpers/zod\";\n\nexport {\n  SEMANTIC_AUDIT_OUTPUT_CONTRACT_MATERIAL,\n  SEMANTIC_AUDIT_OUTPUT_CONTRACT_REVISION,\n  TRANSLATION_OUTPUT_CONTRACT_MATERIAL,\n  TRANSLATION_OUTPUT_CONTRACT_REVISION,\n  createSemanticAuditOutputContractRevision,\n  createTranslationOutputContractRevision,\n} from \"@ai-translate/provider-core\";\nexport type {\n  ReasoningEffort,\n  SemanticAuditOutputContractMaterial,\n  SemanticAuditPrompt,\n  SemanticAuditPromptArgs,\n  SemanticAuditResponseCache,\n  StructuredCompletionMessage,\n  StructuredCompletionRequest,\n  StructuredCompletionTransport,\n  SystemPrompt,\n  SystemPromptArgs,\n  TranslationOutputContractMaterial,\n} from \"@ai-translate/provider-core\";\n\n/**\n * Reasoning-capable and inexpensive. Callers who want a different trade-off\n * pass `model` explicitly.\n */\nexport const DEFAULT_MODEL = \"gpt-5.6-luna\";\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 120_000;\n\nexport interface OpenAiTransportOptions {\n  apiKey?: string;\n  client?: OpenAI;\n  requestTimeoutMs?: number;\n}\n\n/**\n * Speaks the OpenAI Chat Completions dialect of the engine's request contract.\n * Retries stay off here because the engine owns the retry and repair loop.\n */\nexport function createOpenAiTransport(\n  options: OpenAiTransportOptions = {},\n): StructuredCompletionTransport {\n  if (!options.client && !options.apiKey) {\n    throw new Error(\"OpenAI transport requires either apiKey or client.\");\n  }\n  const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n  const client =\n    options.client ??\n    new OpenAI({ apiKey: options.apiKey, maxRetries: 0, timeout: requestTimeoutMs });\n\n  return {\n    async complete(request: StructuredCompletionRequest): Promise<unknown> {\n      const completion = await client.chat.completions.parse(\n        {\n          messages: request.messages.map((message) => ({\n            content: message.content,\n            role: message.role,\n          })),\n          model: request.modelId,\n          ...(request.maxCompletionTokens === undefined\n            ? {}\n            : { max_completion_tokens: request.maxCompletionTokens }),\n          ...(request.promptCacheKey === undefined\n            ? {}\n            : { prompt_cache_key: request.promptCacheKey }),\n          ...(request.reasoningEffort === undefined\n            ? {}\n            : { reasoning_effort: request.reasoningEffort }),\n          response_format: zodResponseFormat(request.schema, request.schemaName),\n          ...(request.temperature === undefined ? {} : { temperature: request.temperature }),\n        },\n        {\n          maxRetries: 0,\n          ...(request.signal === undefined ? {} : { signal: request.signal }),\n          timeout: requestTimeoutMs,\n        },\n      );\n      return completion.choices[0]?.message.parsed;\n    },\n    label: \"OpenAI\",\n  };\n}\n\nexport interface OpenAiTranslationProviderOptions\n  extends Omit<StructuredTranslationProviderOptions, \"model\" | \"transport\"> {\n  apiKey?: string;\n  client?: OpenAI;\n  model?: string;\n}\n\nexport class OpenAiTranslationProvider extends StructuredTranslationProvider {\n  constructor(options: OpenAiTranslationProviderOptions = {}) {\n    const { apiKey, client, model, ...engineOptions } = options;\n    super({\n      ...engineOptions,\n      model: model ?? DEFAULT_MODEL,\n      transport: createOpenAiTransport({\n        ...(apiKey === undefined ? {} : { apiKey }),\n        ...(client === undefined ? {} : { client }),\n        ...(options.requestTimeoutMs === undefined\n          ? {}\n          : { requestTimeoutMs: options.requestTimeoutMs }),\n      }),\n    });\n  }\n}\n\nexport interface OpenAiSemanticAuditProviderOptions\n  extends Omit<StructuredSemanticAuditProviderOptions, \"transport\"> {\n  apiKey?: string;\n  client?: OpenAI;\n}\n\nexport class OpenAiSemanticAuditProvider extends StructuredSemanticAuditProvider {\n  constructor(options: OpenAiSemanticAuditProviderOptions = {}) {\n    const { apiKey, client, ...engineOptions } = options;\n    super({\n      ...engineOptions,\n      transport: createOpenAiTransport({\n        ...(apiKey === undefined ? {} : { apiKey }),\n        ...(client === undefined ? {} : { client }),\n        ...(options.requestTimeoutMs === undefined\n          ? {}\n          : { requestTimeoutMs: options.requestTimeoutMs }),\n      }),\n    });\n  }\n}\n\nexport function createOpenAiTranslationProvider(\n  options: OpenAiTranslationProviderOptions = {},\n): TranslationProvider {\n  return new OpenAiTranslationProvider(options);\n}\n\nexport function createOpenAiSemanticAuditProvider(\n  options: OpenAiSemanticAuditProviderOptions = {},\n): SemanticAuditProvider {\n  return new OpenAiSemanticAuditProvider(options);\n}\n"],"mappings":";;;;;;;;AAwCA,MAAa,gBAAgB;AAE7B,MAAM,6BAA6B;;;;;AAYnC,SAAgB,sBACd,UAAkC,CAAC,GACJ;CAC/B,IAAI,CAAC,QAAQ,UAAU,CAAC,QAAQ,QAC9B,MAAM,IAAI,MAAM,oDAAoD;CAEtE,MAAM,mBAAmB,QAAQ,oBAAoB;CACrD,MAAM,SACJ,QAAQ,UACR,IAAI,OAAO;EAAE,QAAQ,QAAQ;EAAQ,YAAY;EAAG,SAAS;CAAiB,CAAC;CAEjF,OAAO;EACL,MAAM,SAAS,SAAwD;GA0BrE,QAAO,MAzBkB,OAAO,KAAK,YAAY,MAC/C;IACE,UAAU,QAAQ,SAAS,KAAK,aAAa;KAC3C,SAAS,QAAQ;KACjB,MAAM,QAAQ;IAChB,EAAE;IACF,OAAO,QAAQ;IACf,GAAI,QAAQ,wBAAwB,KAAA,IAChC,CAAC,IACD,EAAE,uBAAuB,QAAQ,oBAAoB;IACzD,GAAI,QAAQ,mBAAmB,KAAA,IAC3B,CAAC,IACD,EAAE,kBAAkB,QAAQ,eAAe;IAC/C,GAAI,QAAQ,oBAAoB,KAAA,IAC5B,CAAC,IACD,EAAE,kBAAkB,QAAQ,gBAAgB;IAChD,iBAAiB,kBAAkB,QAAQ,QAAQ,QAAQ,UAAU;IACrE,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;GAClF,GACA;IACE,YAAY;IACZ,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;IACjE,SAAS;GACX,CACF,EAAA,CACkB,QAAQ,EAAE,EAAE,QAAQ;EACxC;EACA,OAAO;CACT;AACF;AASA,IAAa,4BAAb,cAA+C,8BAA8B;CAC3E,YAAY,UAA4C,CAAC,GAAG;EAC1D,MAAM,EAAE,QAAQ,QAAQ,OAAO,GAAG,kBAAkB;EACpD,MAAM;GACJ,GAAG;GACH,OAAO,SAAA;GACP,WAAW,sBAAsB;IAC/B,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;IACzC,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;IACzC,GAAI,QAAQ,qBAAqB,KAAA,IAC7B,CAAC,IACD,EAAE,kBAAkB,QAAQ,iBAAiB;GACnD,CAAC;EACH,CAAC;CACH;AACF;AAQA,IAAa,8BAAb,cAAiD,gCAAgC;CAC/E,YAAY,UAA8C,CAAC,GAAG;EAC5D,MAAM,EAAE,QAAQ,QAAQ,GAAG,kBAAkB;EAC7C,MAAM;GACJ,GAAG;GACH,WAAW,sBAAsB;IAC/B,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;IACzC,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;IACzC,GAAI,QAAQ,qBAAqB,KAAA,IAC7B,CAAC,IACD,EAAE,kBAAkB,QAAQ,iBAAiB;GACnD,CAAC;EACH,CAAC;CACH;AACF;AAEA,SAAgB,gCACd,UAA4C,CAAC,GACxB;CACrB,OAAO,IAAI,0BAA0B,OAAO;AAC9C;AAEA,SAAgB,kCACd,UAA8C,CAAC,GACxB;CACvB,OAAO,IAAI,4BAA4B,OAAO;AAChD"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ai-translate/provider-openai",
+  "version": "0.1.0",
+  "description": "OpenAI translation and semantic-audit providers for ai-translate, with structured output and batching.",
+  "keywords": [
+    "i18n",
+    "l10n",
+    "internationalization",
+    "localization",
+    "translation",
+    "openai",
+    "ai",
+    "llm"
+  ],
+  "license": "MIT",
+  "author": "Thiago Peres",
+  "homepage": "https://github.com/thiagoperes/ai-translate#packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thiagoperes/ai-translate.git",
+    "directory": "packages/ai-translate-provider-openai"
+  },
+  "bugs": {
+    "url": "https://github.com/thiagoperes/ai-translate/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "openai": "7.1.0",
+    "zod": "4.4.3",
+    "@ai-translate/core": "0.1.0",
+    "@ai-translate/provider-core": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint -c ../../.oxlintrc.json --type-aware --deny-warnings src test vitest.config.ts tsdown.config.ts",
+    "test": "vitest run --config vitest.config.ts",
+    "coverage": "vitest run --config vitest.config.ts --coverage",
+    "coverage:strict": "vitest run --config vitest.config.ts --coverage --coverage.include=src/index.ts --coverage.thresholds.lines=95 --coverage.thresholds.functions=95 --coverage.thresholds.branches=95 --coverage.thresholds.statements=95",
+    "test:pack": "publint . && attw --pack . --profile esm-only"
+  }
+}