@neta-art/generation 0.1.20 → 0.1.22

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-BnNhaefG.js";
+import { h as stringifyGenerationModelDeclaration, i as createGenerationClient, n as exportBuiltinModelConfigs, t as exportBuiltinModelConfig } from "../export-config-MvqQsM_g.js";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 

package/dist/{export-config-BnNhaefG.js → export-config-MvqQsM_g.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
@@ -1225,8 +1313,7 @@ function resolveDuration(value) {
 function resolveRatio(value, mode) {
 	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") return requested === ADAPTIVE_RATIO ? DEFAULT_RATIO : requested;
-	return ADAPTIVE_RATIO;
+	return mode === "text" && requested === ADAPTIVE_RATIO ? DEFAULT_RATIO : requested;
 }
 function extractTaskId$1(response) {
 	const data = isRecord$3(response.data) ? response.data : void 0;
@@ -2221,5 +2308,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-BnNhaefG.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-MvqQsM_g.js.map