@neta-art/generation 0.1.19 → 0.1.21

package/README.md

@@ -515,13 +515,20 @@ console.log(resolved.parameters);
 ## Error handling
 
 ```ts
-import { GenerationValidationError, GenerationProviderError } from "@neta-art/generation";
+import {
+  GenerationProviderError,
+  GenerationTransportError,
+  GenerationValidationError,
+} from "@neta-art/generation";
 
 try {
   await client.generate(request);
 } catch (error) {
   if (error instanceof GenerationValidationError) {
     console.error("Invalid request", error.message);
+  } else if (error instanceof GenerationTransportError) {
+    console.error("Provider transport failed", error.message);
+    console.error(error.details?.causeCode, error.details?.causeSyscall);
   } else if (error instanceof GenerationProviderError) {
     console.error("Provider failed", error.message);
     console.error(error.status, error.details?.requestId, error.details?.code);

package/dist/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { r as listBuiltinGenerationModels } from "../builtins-B4Agk9nt.js";
-import { h as stringifyGenerationModelDeclaration, i as createGenerationClient, n as exportBuiltinModelConfigs, t as exportBuiltinModelConfig } from "../export-config-2OmCf-nP.js";
+import { h as stringifyGenerationModelDeclaration, i as createGenerationClient, n as exportBuiltinModelConfigs, t as exportBuiltinModelConfig } from "../export-config-Ct9_V_Pj.js";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 

package/dist/{export-config-2OmCf-nP.js → export-config-Ct9_V_Pj.js}

@@ -40,12 +40,33 @@ var GenerationProviderError = class extends GenerationError {
 		this.details = options?.details;
 	}
 };
+var GenerationTransportError = class extends GenerationProviderError {
+	constructor(details, cause) {
+		super(transportErrorMessage(details), { details });
+		this.name = "GenerationTransportError";
+		this.cause = cause;
+	}
+};
 var GenerationTimeoutError = class extends GenerationProviderError {
 	constructor(message = "Generation request timed out", details) {
 		super(message, details ? { details } : void 0);
 		this.name = "GenerationTimeoutError";
 	}
 };
+function transportErrorMessage(details) {
+	return [
+		"Generation transport failed",
+		`method=${details.method}`,
+		details.host ? `host=${details.host}` : void 0,
+		`path=${details.path}`,
+		`elapsed_ms=${details.elapsedMs}`,
+		details.causeCode ? `cause_code=${details.causeCode}` : void 0,
+		details.causeName ? `cause_name=${details.causeName}` : void 0,
+		details.causeSyscall ? `cause_syscall=${details.causeSyscall}` : void 0,
+		details.causeAddress ? `cause_address=${details.causeAddress}` : void 0,
+		details.causePort !== void 0 ? `cause_port=${details.causePort}` : void 0
+	].filter((part) => part !== void 0).join(" ");
+}
 
 //#endregion
 //#region src/http.ts
@@ -78,14 +99,25 @@ function pickTraceHeaders(headers) {
 	for (const [key, value] of Object.entries(headers)) if (TRACE_HEADER_PATTERN.test(key)) output[key] = value;
 	return output;
 }
+var DebugObserverError = class extends Error {
+	constructor(cause) {
+		super("Generation debug observer failed");
+		this.name = "DebugObserverError";
+		this.cause = cause;
+	}
+};
 function emitDebugRequest(debug, url, init) {
-	debug.logger({
-		type: "request",
-		url,
-		method: init.method ?? "GET",
-		headers: headersToRecord(init.headers),
-		body: parseDebugBody(init.body)
-	});
+	try {
+		debug.logger({
+			type: "request",
+			url,
+			method: init.method ?? "GET",
+			headers: headersToRecord(init.headers),
+			body: parseDebugBody(init.body)
+		});
+	} catch (cause) {
+		throw new DebugObserverError(cause);
+	}
 	return Date.now();
 }
 async function readDebugResponseBody(response) {
@@ -95,17 +127,21 @@ async function readDebugResponseBody(response) {
 	return "[non-text body]";
 }
 async function emitDebugResponse(debug, url, response, startedAt) {
-	const headers = headersToRecord(response.headers);
-	debug.logger({
-		type: "response",
-		url,
-		status: response.status,
-		statusText: response.statusText,
-		headers,
-		trace: pickTraceHeaders(headers),
-		elapsedMs: Date.now() - startedAt,
-		...debug.includeResponseBody ? { body: await readDebugResponseBody(response) } : {}
-	});
+	try {
+		const headers = headersToRecord(response.headers);
+		debug.logger({
+			type: "response",
+			url,
+			status: response.status,
+			statusText: response.statusText,
+			headers,
+			trace: pickTraceHeaders(headers),
+			elapsedMs: Date.now() - startedAt,
+			...debug.includeResponseBody ? { body: await readDebugResponseBody(response) } : {}
+		});
+	} catch (cause) {
+		throw new DebugObserverError(cause);
+	}
 }
 function createDebugFetch(fetchFn, debug) {
 	return (async (input, init) => {
@@ -119,14 +155,16 @@ function createDebugFetch(fetchFn, debug) {
 async function fetchWithTimeout(fetchFn, url, init, timeoutMs) {
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), timeoutMs);
+	const startedAt = Date.now();
 	try {
 		return await fetchFn(url, {
 			...init,
 			signal: controller.signal
 		});
 	} catch (error) {
+		if (error instanceof DebugObserverError) throw error.cause;
 		if (error instanceof Error && error.name === "AbortError") throw new GenerationTimeoutError();
-		throw error;
+		throw new GenerationTransportError(transportErrorDetails(url, init, startedAt, error), error);
 	} finally {
 		clearTimeout(timeout);
 	}
@@ -134,6 +172,56 @@ async function fetchWithTimeout(fetchFn, url, init, timeoutMs) {
 function joinUrl(baseUrl, path) {
 	return `${baseUrl.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
 }
+function transportErrorDetails(rawUrl, init, startedAt, error) {
+	const summary = transportErrorSummary(error);
+	return compactObject({
+		method: (init.method ?? "GET").toUpperCase(),
+		...transportErrorTarget(rawUrl),
+		elapsedMs: Date.now() - startedAt,
+		causeName: summary.causeName ?? summary.name,
+		causeCode: summary.causeCode,
+		causeSyscall: summary.causeSyscall,
+		causeAddress: summary.causeAddress,
+		causePort: summary.causePort
+	});
+}
+function transportErrorTarget(rawUrl) {
+	try {
+		const url = new URL(rawUrl);
+		return {
+			host: url.host,
+			path: url.pathname
+		};
+	} catch {
+		const suffixIndex = rawUrl.search(/[?#]/);
+		return { path: suffixIndex === -1 ? rawUrl : rawUrl.slice(0, suffixIndex) };
+	}
+}
+function transportErrorSummary(error) {
+	const outer = error instanceof Error ? error : new Error(String(error));
+	const cause = isRecord$6(outer.cause) ? outer.cause : void 0;
+	return compactObject({
+		name: outer.name,
+		causeName: stringProperty(cause, "name"),
+		causeCode: stringProperty(cause, "code") ?? stringProperty(outer, "code"),
+		causeSyscall: stringProperty(cause, "syscall") ?? stringProperty(outer, "syscall"),
+		causeAddress: stringProperty(cause, "address") ?? stringProperty(outer, "address"),
+		causePort: stringOrNumberProperty(cause, "port") ?? stringOrNumberProperty(outer, "port")
+	});
+}
+function stringProperty(value, key) {
+	if (!isRecord$6(value)) return void 0;
+	const item = value[key];
+	return typeof item === "string" && item.trim() ? item.trim() : void 0;
+}
+function stringOrNumberProperty(value, key) {
+	if (!isRecord$6(value)) return void 0;
+	const item = value[key];
+	return typeof item === "string" || typeof item === "number" ? item : void 0;
+}
+function isRecord$6(value) {
+	return typeof value === "object" && value !== null;
+}
 
 //#endregion
 //#region src/validation.ts
@@ -1088,6 +1176,8 @@ const MAX_MEDIA_COUNT = 12;
 const MAX_REFERENCE_IMAGES = 9;
 const MAX_REFERENCE_VIDEOS = 3;
 const MAX_REFERENCE_AUDIO = 3;
+const DEFAULT_RATIO = "16:9";
+const ADAPTIVE_RATIO = "adaptive";
 const H3_RATIOS = [
 	"adaptive",
 	"21:9",
@@ -1173,11 +1263,10 @@ function classifyMedia(media) {
 	if (referenceImages > MAX_REFERENCE_IMAGES) throw new GenerationValidationError(`MiniMax H3 supports at most ${MAX_REFERENCE_IMAGES} reference images`);
 	if (referenceVideos > MAX_REFERENCE_VIDEOS) throw new GenerationValidationError(`MiniMax H3 supports at most ${MAX_REFERENCE_VIDEOS} reference videos`);
 	if (referenceAudio > MAX_REFERENCE_AUDIO) throw new GenerationValidationError(`MiniMax H3 supports at most ${MAX_REFERENCE_AUDIO} reference audio files`);
-	if (media.length > MAX_MEDIA_COUNT) throw new GenerationValidationError(`MiniMax H3 supports at most ${MAX_MEDIA_COUNT} media items`);
+	if (media.length > MAX_MEDIA_COUNT) throw new GenerationValidationError(`MiniMax H3 supports at most ${MAX_MEDIA_COUNT} media items; received ${referenceImages} reference images, ${referenceVideos} reference videos, ${referenceAudio} reference audio inputs, and ${firstFrames + lastFrames} frame images`);
 	const hasFrames = firstFrames + lastFrames > 0;
 	const hasReferences = referenceImages + referenceVideos + referenceAudio > 0;
 	if (hasFrames && hasReferences) throw new GenerationValidationError("MiniMax H3 cannot mix frame images with reference materials");
-	if (referenceAudio > 0 && referenceImages + referenceVideos === 0) throw new GenerationValidationError("MiniMax H3 reference audio requires a reference image or video");
 	if (hasFrames) return "frame";
 	if (hasReferences) return "reference";
 	return "text";
@@ -1222,13 +1311,10 @@ function resolveDuration(value) {
 	return duration;
 }
 function resolveRatio(value, mode) {
-	const requested = asString$1(value) ?? "16:9";
+	const requested = asString$1(value) ?? DEFAULT_RATIO;
 	if (!H3_RATIOS.includes(requested)) throw new GenerationValidationError(`MiniMax H3 ratio must be one of: ${H3_RATIOS.join(", ")}`);
-	if (mode === "text") {
-		if (requested === "adaptive") throw new GenerationValidationError("MiniMax H3 text-to-video ratio cannot be adaptive");
-		return requested;
-	}
-	return "adaptive";
+	if (mode === "text") return requested === ADAPTIVE_RATIO ? DEFAULT_RATIO : requested;
+	return ADAPTIVE_RATIO;
 }
 function extractTaskId$1(response) {
 	const data = isRecord$3(response.data) ? response.data : void 0;
@@ -1236,19 +1322,36 @@ function extractTaskId$1(response) {
 	if (!taskId) throw new GenerationProviderError("MiniMax H3 provider did not return a task id", { details: { response } });
 	return taskId;
 }
+function isTaskPayload(value) {
+	return [
+		"status",
+		"task",
+		"result_url",
+		"video_url",
+		"url",
+		"error",
+		"progress",
+		"fail_reason"
+	].some((key) => key in value);
+}
+function unwrapTaskPayload(response) {
+	const data = isRecord$3(response.data) ? response.data : void 0;
+	return data && !isTaskPayload(response) ? data : response;
+}
 function extractTaskStatus(response) {
-	const task = isRecord$3(response.task) ? response.task : void 0;
-	const metadata = isRecord$3(response.metadata) ? response.metadata : void 0;
-	const content = isRecord$3(task?.content) ? task.content : void 0;
-	const status = normalizeStatus$1(response.status ?? task?.status);
-	const videoUrl = asString$1(metadata?.url) ?? asString$1(response.result_url) ?? asString$1(response.video_url) ?? asString$1(response.url) ?? asString$1(content?.url);
-	const error = isRecord$3(response.error) ? response.error : isRecord$3(task?.error) ? task.error : void 0;
-	const message = asString$1(error?.message) ?? asString$1(response.message) ?? asString$1(task?.message);
+	const payload = unwrapTaskPayload(response);
+	const task = isRecord$3(payload.task) ? payload.task : payload;
+	const metadata = isRecord$3(payload.metadata) ? payload.metadata : isRecord$3(task.metadata) ? task.metadata : void 0;
+	const content = isRecord$3(task.content) ? task.content : void 0;
+	const status = normalizeStatus$1(payload.status ?? task.status);
+	const videoUrl = asString$1(metadata?.url) ?? asString$1(payload.result_url) ?? asString$1(payload.video_url) ?? asString$1(payload.url) ?? asString$1(task.result_url) ?? asString$1(task.video_url) ?? asString$1(task.url) ?? asString$1(content?.video_url) ?? asString$1(content?.url);
+	const error = isRecord$3(payload.error) ? payload.error : isRecord$3(task.error) ? task.error : void 0;
+	const message = asString$1(error?.message) ?? asString$1(payload.fail_reason) ?? asString$1(payload.message) ?? asString$1(task.fail_reason) ?? asString$1(task.message) ?? asString$1(response.message);
 	const outputMetadata = compactObject({
-		progress: response.progress ?? task?.progress,
-		resolution: response.resolution ?? task?.resolution,
-		duration: response.duration ?? task?.duration,
-		ratio: response.ratio ?? task?.ratio
+		progress: payload.progress ?? task.progress,
+		resolution: payload.resolution ?? task.resolution,
+		duration: payload.duration ?? task.duration,
+		ratio: payload.ratio ?? task.ratio
 	});
 	return {
 		status: error && status === "unknown" ? "failed" : status,
@@ -2206,5 +2309,5 @@ async function exportBuiltinModelConfigs(directory) {
 }
 
 //#endregion
-export { resolveGenerationMeta as A, minimaxH3VideoGenerationsAdapter as C, arkVideoGenerationsAdapter as D, audioSpeechAdapter as E, GenerationProviderError as F, GenerationTimeoutError as I, GenerationUnsupportedAdapterError as L, validateGenerationContent as M, GenerationConfigError as N, mergeGenerationMeta as O, GenerationError as P, GenerationValidationError as R, openAiImageEditsAdapter as S, geminiGenerateContentAdapter as T, writeGenerationModelDeclarations as _, createGenerationClientFromDirectory as a, sunoTasksAdapter as b, defaultGenerationSourceResolver as c, parseGenerationModelDeclaration as d, readGenerationModelDeclaration as f, writeGenerationModelDeclaration as g, stringifyGenerationModelDeclaration as h, createGenerationClient as i, resolveGenerationParameters as j, mergeTextBlocks as k, isGenerationModelDeclaration as l, readGenerationModelDeclarationsFromFiles as m, exportBuiltinModelConfigs as n, createGenerationClientFromFile as o, readGenerationModelDeclarationsFromDirectory as p, stringifyBuiltinModelConfig as r, createGenerationClientFromFiles as s, exportBuiltinModelConfig as t, mergeGenerationModelDeclarations as u, builtinGenerationAdapters as v, klingVideoGenerationsAdapter as w, openAiImagesAdapter as x, getGenerationAdapter as y };
-//# sourceMappingURL=export-config-2OmCf-nP.js.map
+export { resolveGenerationMeta as A, minimaxH3VideoGenerationsAdapter as C, arkVideoGenerationsAdapter as D, audioSpeechAdapter as E, GenerationProviderError as F, GenerationTimeoutError as I, GenerationTransportError as L, validateGenerationContent as M, GenerationConfigError as N, mergeGenerationMeta as O, GenerationError as P, GenerationUnsupportedAdapterError as R, openAiImageEditsAdapter as S, geminiGenerateContentAdapter as T, writeGenerationModelDeclarations as _, createGenerationClientFromDirectory as a, sunoTasksAdapter as b, defaultGenerationSourceResolver as c, parseGenerationModelDeclaration as d, readGenerationModelDeclaration as f, writeGenerationModelDeclaration as g, stringifyGenerationModelDeclaration as h, createGenerationClient as i, resolveGenerationParameters as j, mergeTextBlocks as k, isGenerationModelDeclaration as l, readGenerationModelDeclarationsFromFiles as m, exportBuiltinModelConfigs as n, createGenerationClientFromFile as o, readGenerationModelDeclarationsFromDirectory as p, stringifyBuiltinModelConfig as r, createGenerationClientFromFiles as s, exportBuiltinModelConfig as t, mergeGenerationModelDeclarations as u, builtinGenerationAdapters as v, klingVideoGenerationsAdapter as w, openAiImagesAdapter as x, getGenerationAdapter as y, GenerationValidationError as z };
+//# sourceMappingURL=export-config-Ct9_V_Pj.js.map