@tanstack/openai-base 0.10.15 → 0.11.1

package/dist/esm/adapters/responses-user-tools.js

@@ -0,0 +1,241 @@
+//#region src/adapters/responses-user-tools.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringList(value) {
+	if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) return null;
+	return value;
+}
+function stringEnv(value) {
+	if (!isRecord(value)) return {};
+	const env = {};
+	for (const [key, entry] of Object.entries(value)) if (typeof entry === "string") env[key] = entry;
+	return env;
+}
+function nullableNumber(value) {
+	return typeof value === "number" || value === null ? value : null;
+}
+/**
+* Hosted shell calls already include a `shell_call_output` in the same
+* response. Those call ids must not pause the app for another run.
+*/
+function hostedShellCallIds(output) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const item of output) if (isRecord(item) && item.type === "shell_call_output" && typeof item.call_id === "string") ids.add(item.call_id);
+	return ids;
+}
+function readUserToolName(metadata) {
+	if (!isRecord(metadata)) return null;
+	const name = metadata.openaiUserTool;
+	if (name === "shell" || name === "apply_patch" || name === "local_shell") return name;
+	return null;
+}
+function readItemId(metadata) {
+	if (!isRecord(metadata)) return void 0;
+	return typeof metadata.itemId === "string" && metadata.itemId.length > 0 ? metadata.itemId : void 0;
+}
+function readMaxOutputLength(metadata) {
+	if (!isRecord(metadata)) return void 0;
+	const value = metadata.maxOutputLength;
+	return typeof value === "number" || value === null ? value : void 0;
+}
+function applyPatchOperation(value) {
+	if (!isRecord(value) || typeof value.path !== "string") return null;
+	if (value.type === "delete_file") return {
+		type: "delete_file",
+		path: value.path
+	};
+	if ((value.type === "create_file" || value.type === "update_file") && typeof value.diff === "string") return {
+		type: value.type,
+		path: value.path,
+		diff: value.diff
+	};
+	return null;
+}
+/**
+* Read a user-run Responses output item.
+* `bareShell` is true only once the full response is known. A shell call
+* with no environment waits for that pass, so a hosted call that later
+* carries `shell_call_output` is not asked of the app.
+*/
+function readUserExecutedCall(item, options) {
+	if (!isRecord(item) || typeof item.type !== "string") return null;
+	const callId = typeof item.call_id === "string" ? item.call_id : "";
+	const itemId = typeof item.id === "string" ? item.id : void 0;
+	if (item.type === "apply_patch_call") {
+		const operation = applyPatchOperation(item.operation);
+		if (!callId || !operation) return null;
+		return {
+			name: "apply_patch",
+			callId,
+			...itemId ? { itemId } : {},
+			input: { operation }
+		};
+	}
+	if (item.type === "local_shell_call") {
+		if (!isRecord(item.action)) return null;
+		const command = stringList(item.action.command);
+		if (!callId || !command || command.length === 0) return null;
+		return {
+			name: "local_shell",
+			callId,
+			...itemId ? { itemId } : {},
+			input: item.action
+		};
+	}
+	if (item.type !== "shell_call") return null;
+	const environment = item.environment;
+	if (isRecord(environment)) {
+		if (environment.type !== "local") return null;
+	} else if (!options.bareShell) return null;
+	if (!callId || !isRecord(item.action)) return null;
+	const commands = stringList(item.action.commands);
+	if (!commands || commands.length === 0) return null;
+	const maxOutputLength = nullableNumber(item.action.max_output_length);
+	return {
+		name: "shell",
+		callId,
+		...itemId ? { itemId } : {},
+		input: {
+			commands,
+			max_output_length: maxOutputLength,
+			timeout_ms: nullableNumber(item.action.timeout_ms)
+		},
+		maxOutputLength
+	};
+}
+function parseArguments(argumentsString) {
+	try {
+		const parsed = JSON.parse(argumentsString);
+		return isRecord(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function parseContent(content) {
+	if (typeof content !== "string") return content;
+	try {
+		return JSON.parse(content);
+	} catch {
+		return content;
+	}
+}
+/** Replay a user-run tool call as the Responses input item OpenAI expects. */
+function userToolRequestItem(toolCall) {
+	const name = readUserToolName(toolCall.metadata);
+	if (!name) return null;
+	const args = parseArguments(toolCall.function.arguments);
+	const itemId = readItemId(toolCall.metadata);
+	if (name === "apply_patch") {
+		const operation = applyPatchOperation(args.operation);
+		if (!operation) return null;
+		return {
+			type: "apply_patch_call",
+			call_id: toolCall.id,
+			status: "completed",
+			operation,
+			...itemId ? { id: itemId } : {}
+		};
+	}
+	if (name === "local_shell") {
+		const command = stringList(args.command);
+		if (!command) return null;
+		return {
+			type: "local_shell_call",
+			id: itemId ?? toolCall.id,
+			call_id: toolCall.id,
+			status: "completed",
+			action: {
+				type: "exec",
+				command,
+				env: stringEnv(args.env),
+				timeout_ms: nullableNumber(args.timeout_ms),
+				...typeof args.user === "string" || args.user === null ? { user: args.user } : {},
+				...typeof args.working_directory === "string" || args.working_directory === null ? { working_directory: args.working_directory } : {}
+			}
+		};
+	}
+	const commands = stringList(args.commands);
+	if (!commands) return null;
+	return {
+		type: "shell_call",
+		call_id: toolCall.id,
+		status: "completed",
+		action: {
+			commands,
+			max_output_length: nullableNumber(args.max_output_length),
+			timeout_ms: nullableNumber(args.timeout_ms)
+		},
+		...itemId ? { id: itemId } : {}
+	};
+}
+function shellOutcome(value) {
+	if (isRecord(value) && value.type === "timeout") return { type: "timeout" };
+	return {
+		type: "exit",
+		exit_code: isRecord(value) && typeof value.exit_code === "number" ? value.exit_code : 0
+	};
+}
+function shellEntry(value) {
+	if (typeof value === "string") return {
+		stdout: value,
+		stderr: "",
+		outcome: {
+			type: "exit",
+			exit_code: 0
+		}
+	};
+	const record = isRecord(value) ? value : {};
+	return {
+		stdout: typeof record.stdout === "string" ? record.stdout : "",
+		stderr: typeof record.stderr === "string" ? record.stderr : "",
+		outcome: shellOutcome(record.outcome)
+	};
+}
+function shellOutputList(content) {
+	const parsed = parseContent(content);
+	if (isRecord(parsed) && Array.isArray(parsed.output)) return parsed.output.map((entry) => shellEntry(entry));
+	if (isRecord(parsed) && ("stdout" in parsed || "outcome" in parsed)) return [shellEntry(parsed)];
+	if (typeof parsed === "string") return [shellEntry(parsed)];
+	return [shellEntry(JSON.stringify(parsed ?? ""))];
+}
+/** Replay the app's tool result as the matching Responses output item. */
+function userToolResultItem(toolCall, content) {
+	const name = readUserToolName(toolCall.metadata);
+	if (!name) return null;
+	const parsed = parseContent(content);
+	if (name === "apply_patch") {
+		const record = isRecord(parsed) ? parsed : {};
+		const failed = record.status === "failed" || record.status !== "completed" && typeof record.error === "string";
+		const output = typeof record.output === "string" ? record.output : typeof record.error === "string" ? record.error : typeof parsed === "string" ? parsed : void 0;
+		return {
+			type: "apply_patch_call_output",
+			call_id: toolCall.id,
+			status: failed ? "failed" : "completed",
+			...output !== void 0 ? { output } : {}
+		};
+	}
+	if (name === "local_shell") {
+		const output = typeof parsed === "string" ? parsed : isRecord(parsed) && typeof parsed.output === "string" ? parsed.output : JSON.stringify(parsed ?? "");
+		return {
+			type: "local_shell_call_output",
+			id: toolCall.id,
+			output,
+			status: "completed"
+		};
+	}
+	const record = isRecord(parsed) ? parsed : {};
+	const fromResult = nullableNumber(record.max_output_length);
+	const fromCall = readMaxOutputLength(toolCall.metadata);
+	const maxOutputLength = record.max_output_length !== void 0 ? fromResult : fromCall;
+	return {
+		type: "shell_call_output",
+		call_id: toolCall.id,
+		output: shellOutputList(content),
+		...maxOutputLength !== void 0 ? { max_output_length: maxOutputLength } : {}
+	};
+}
+//#endregion
+export { hostedShellCallIds, readUserExecutedCall, readUserToolName, userToolRequestItem, userToolResultItem };
+
+//# sourceMappingURL=responses-user-tools.js.map

package/dist/esm/adapters/responses-user-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-user-tools.js","names":[],"sources":["../../../src/adapters/responses-user-tools.ts"],"sourcesContent":["import type { ResponseInputItem } from 'openai/resources/responses/responses'\n\n/**\n * OpenAI Responses tools the app must run.\n * A container `shell` runs on the provider. `apply_patch`, `local_shell`,\n * and `shell` with `environment.type: \"local\"` (or no environment) do not.\n */\nexport type OpenAIUserToolName = 'shell' | 'apply_patch' | 'local_shell'\n\nexport interface OpenAIUserExecutedCall {\n  name: OpenAIUserToolName\n  callId: string\n  itemId?: string\n  input: Record<string, unknown>\n  maxOutputLength?: number | null\n}\n\ninterface ToolCallLike {\n  id: string\n  function: { name: string; arguments: string }\n  metadata?: unknown\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction stringList(value: unknown): Array<string> | null {\n  if (\n    !Array.isArray(value) ||\n    !value.every((entry) => typeof entry === 'string')\n  ) {\n    return null\n  }\n  return value\n}\n\nfunction stringEnv(value: unknown): Record<string, string> {\n  if (!isRecord(value)) return {}\n  const env: Record<string, string> = {}\n  for (const [key, entry] of Object.entries(value)) {\n    if (typeof entry === 'string') env[key] = entry\n  }\n  return env\n}\n\nfunction nullableNumber(value: unknown): number | null {\n  return typeof value === 'number' || value === null ? value : null\n}\n\n/**\n * Hosted shell calls already include a `shell_call_output` in the same\n * response. Those call ids must not pause the app for another run.\n */\nexport function hostedShellCallIds(\n  output: ReadonlyArray<unknown>,\n): Set<string> {\n  const ids = new Set<string>()\n  for (const item of output) {\n    if (\n      isRecord(item) &&\n      item.type === 'shell_call_output' &&\n      typeof item.call_id === 'string'\n    ) {\n      ids.add(item.call_id)\n    }\n  }\n  return ids\n}\n\nexport function readUserToolName(metadata: unknown): OpenAIUserToolName | null {\n  if (!isRecord(metadata)) return null\n  const name = metadata.openaiUserTool\n  if (name === 'shell' || name === 'apply_patch' || name === 'local_shell') {\n    return name\n  }\n  return null\n}\n\nfunction readItemId(metadata: unknown): string | undefined {\n  if (!isRecord(metadata)) return undefined\n  return typeof metadata.itemId === 'string' && metadata.itemId.length > 0\n    ? metadata.itemId\n    : undefined\n}\n\nfunction readMaxOutputLength(metadata: unknown): number | null | undefined {\n  if (!isRecord(metadata)) return undefined\n  const value = metadata.maxOutputLength\n  return typeof value === 'number' || value === null ? value : undefined\n}\n\nfunction applyPatchOperation(\n  value: unknown,\n):\n  | { type: 'create_file'; path: string; diff: string }\n  | { type: 'update_file'; path: string; diff: string }\n  | { type: 'delete_file'; path: string }\n  | null {\n  if (!isRecord(value) || typeof value.path !== 'string') return null\n  if (value.type === 'delete_file') {\n    return { type: 'delete_file', path: value.path }\n  }\n  if (\n    (value.type === 'create_file' || value.type === 'update_file') &&\n    typeof value.diff === 'string'\n  ) {\n    return { type: value.type, path: value.path, diff: value.diff }\n  }\n  return null\n}\n\n/**\n * Read a user-run Responses output item.\n * `bareShell` is true only once the full response is known. A shell call\n * with no environment waits for that pass, so a hosted call that later\n * carries `shell_call_output` is not asked of the app.\n */\nexport function readUserExecutedCall(\n  item: unknown,\n  options: { bareShell: boolean },\n): OpenAIUserExecutedCall | null {\n  if (!isRecord(item) || typeof item.type !== 'string') return null\n  const callId = typeof item.call_id === 'string' ? item.call_id : ''\n  const itemId = typeof item.id === 'string' ? item.id : undefined\n\n  if (item.type === 'apply_patch_call') {\n    const operation = applyPatchOperation(item.operation)\n    if (!callId || !operation) return null\n    return {\n      name: 'apply_patch',\n      callId,\n      ...(itemId ? { itemId } : {}),\n      input: { operation },\n    }\n  }\n\n  if (item.type === 'local_shell_call') {\n    if (!isRecord(item.action)) return null\n    const command = stringList(item.action.command)\n    if (!callId || !command || command.length === 0) return null\n    return {\n      name: 'local_shell',\n      callId,\n      ...(itemId ? { itemId } : {}),\n      input: item.action,\n    }\n  }\n\n  if (item.type !== 'shell_call') return null\n  const environment = item.environment\n  if (isRecord(environment)) {\n    if (environment.type !== 'local') return null\n  } else if (!options.bareShell) {\n    return null\n  }\n  if (!callId || !isRecord(item.action)) return null\n  const commands = stringList(item.action.commands)\n  if (!commands || commands.length === 0) return null\n  const maxOutputLength = nullableNumber(item.action.max_output_length)\n  return {\n    name: 'shell',\n    callId,\n    ...(itemId ? { itemId } : {}),\n    input: {\n      commands,\n      max_output_length: maxOutputLength,\n      timeout_ms: nullableNumber(item.action.timeout_ms),\n    },\n    maxOutputLength,\n  }\n}\n\nfunction parseArguments(argumentsString: string): Record<string, unknown> {\n  try {\n    const parsed: unknown = JSON.parse(argumentsString)\n    return isRecord(parsed) ? parsed : {}\n  } catch {\n    return {}\n  }\n}\n\nfunction parseContent(content: unknown): unknown {\n  if (typeof content !== 'string') return content\n  try {\n    return JSON.parse(content) as unknown\n  } catch {\n    return content\n  }\n}\n\n/** Replay a user-run tool call as the Responses input item OpenAI expects. */\nexport function userToolRequestItem(\n  toolCall: ToolCallLike,\n): ResponseInputItem | null {\n  const name = readUserToolName(toolCall.metadata)\n  if (!name) return null\n  const args = parseArguments(toolCall.function.arguments)\n  const itemId = readItemId(toolCall.metadata)\n\n  if (name === 'apply_patch') {\n    const operation = applyPatchOperation(args.operation)\n    if (!operation) return null\n    return {\n      type: 'apply_patch_call',\n      call_id: toolCall.id,\n      status: 'completed',\n      operation,\n      ...(itemId ? { id: itemId } : {}),\n    }\n  }\n\n  if (name === 'local_shell') {\n    const command = stringList(args.command)\n    if (!command) return null\n    return {\n      type: 'local_shell_call',\n      id: itemId ?? toolCall.id,\n      call_id: toolCall.id,\n      status: 'completed',\n      action: {\n        type: 'exec',\n        command,\n        env: stringEnv(args.env),\n        timeout_ms: nullableNumber(args.timeout_ms),\n        ...(typeof args.user === 'string' || args.user === null\n          ? { user: args.user }\n          : {}),\n        ...(typeof args.working_directory === 'string' ||\n        args.working_directory === null\n          ? { working_directory: args.working_directory }\n          : {}),\n      },\n    }\n  }\n\n  const commands = stringList(args.commands)\n  if (!commands) return null\n  return {\n    type: 'shell_call',\n    call_id: toolCall.id,\n    status: 'completed',\n    action: {\n      commands,\n      max_output_length: nullableNumber(args.max_output_length),\n      timeout_ms: nullableNumber(args.timeout_ms),\n    },\n    ...(itemId ? { id: itemId } : {}),\n  }\n}\n\ntype ShellOutcome = { type: 'exit'; exit_code: number } | { type: 'timeout' }\n\nfunction shellOutcome(value: unknown): ShellOutcome {\n  if (isRecord(value) && value.type === 'timeout') return { type: 'timeout' }\n  const exitCode =\n    isRecord(value) && typeof value.exit_code === 'number' ? value.exit_code : 0\n  return { type: 'exit', exit_code: exitCode }\n}\n\nfunction shellEntry(value: unknown): {\n  stdout: string\n  stderr: string\n  outcome: ShellOutcome\n} {\n  if (typeof value === 'string') {\n    return {\n      stdout: value,\n      stderr: '',\n      outcome: { type: 'exit', exit_code: 0 },\n    }\n  }\n  const record = isRecord(value) ? value : {}\n  return {\n    stdout: typeof record.stdout === 'string' ? record.stdout : '',\n    stderr: typeof record.stderr === 'string' ? record.stderr : '',\n    outcome: shellOutcome(record.outcome),\n  }\n}\n\nfunction shellOutputList(content: unknown): Array<{\n  stdout: string\n  stderr: string\n  outcome: ShellOutcome\n}> {\n  const parsed = parseContent(content)\n  if (isRecord(parsed) && Array.isArray(parsed.output)) {\n    return parsed.output.map((entry) => shellEntry(entry))\n  }\n  if (isRecord(parsed) && ('stdout' in parsed || 'outcome' in parsed)) {\n    return [shellEntry(parsed)]\n  }\n  if (typeof parsed === 'string') return [shellEntry(parsed)]\n  return [shellEntry(JSON.stringify(parsed ?? ''))]\n}\n\n/** Replay the app's tool result as the matching Responses output item. */\nexport function userToolResultItem(\n  toolCall: ToolCallLike,\n  content: unknown,\n): ResponseInputItem | null {\n  const name = readUserToolName(toolCall.metadata)\n  if (!name) return null\n  const parsed = parseContent(content)\n\n  if (name === 'apply_patch') {\n    const record = isRecord(parsed) ? parsed : {}\n    const failed =\n      record.status === 'failed' ||\n      (record.status !== 'completed' && typeof record.error === 'string')\n    const output =\n      typeof record.output === 'string'\n        ? record.output\n        : typeof record.error === 'string'\n          ? record.error\n          : typeof parsed === 'string'\n            ? parsed\n            : undefined\n    return {\n      type: 'apply_patch_call_output',\n      call_id: toolCall.id,\n      status: failed ? 'failed' : 'completed',\n      ...(output !== undefined ? { output } : {}),\n    }\n  }\n\n  if (name === 'local_shell') {\n    const output =\n      typeof parsed === 'string'\n        ? parsed\n        : isRecord(parsed) && typeof parsed.output === 'string'\n          ? parsed.output\n          : JSON.stringify(parsed ?? '')\n    return {\n      type: 'local_shell_call_output',\n      id: toolCall.id,\n      output,\n      status: 'completed',\n    }\n  }\n\n  const record = isRecord(parsed) ? parsed : {}\n  const fromResult = nullableNumber(record.max_output_length)\n  const fromCall = readMaxOutputLength(toolCall.metadata)\n  const maxOutputLength =\n    record.max_output_length !== undefined ? fromResult : fromCall\n  return {\n    type: 'shell_call_output',\n    call_id: toolCall.id,\n    output: shellOutputList(content),\n    ...(maxOutputLength !== undefined\n      ? { max_output_length: maxOutputLength }\n      : {}),\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.10.15",
+  "version": "0.11.1",
   "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -47,13 +47,13 @@
     "@tanstack/ai-utils": "^0.4.1"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.58.0"
+    "@tanstack/ai": "^0.61.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vite": "^8.2.1",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.58.0"
+    "@tanstack/ai": "0.61.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/chat-completions-text.ts

@@ -1,4 +1,9 @@
-import { EventType, normalizeSystemPrompts } from '@tanstack/ai'
+import {
+  EventType,
+  isFileSource,
+  normalizeSystemPrompts,
+  unsupportedFileSourceError,
+} from '@tanstack/ai'
 import { BaseTextAdapter } from '@tanstack/ai/adapters'
 import {
   toRunErrorPayload,
@@ -272,7 +277,19 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
       // rather than letting it cascade into a JSON-parse error on '' — the
       // root cause (the model returned no content for the structured request)
       // is then visible in logs.
-      const rawText = response.choices[0]?.message.content
+      const choice = response.choices[0]
+
+      // A response cut off at the output cap is a truncated JSON document —
+      // or, for reasoning models, no content at all once the budget went to
+      // reasoning. Report it as truncation before the empty-content and
+      // parse errors, which would read like a schema failure (issue #1426).
+      if (choice?.finish_reason === 'length') {
+        throw new Error(
+          `${this.name}.structuredOutput: the response was cut off because the maximum token limit was reached (finish_reason=length); raise the output token limit (max_completion_tokens or max_tokens, depending on the provider)`,
+        )
+      }
+
+      const rawText = choice?.message.content
       if (typeof rawText !== 'string' || rawText.length === 0) {
         throw new Error(
           `${this.name}.structuredOutput: response contained no content`,
@@ -346,6 +363,7 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
     let hasClosedReasoning = false
     let stepId: string | undefined
     let lastModel: string | undefined
+    let finishReason: string | null = null
     let lastUsage:
       | OpenAI.Chat.Completions.ChatCompletionChunk['usage']
       | undefined
@@ -486,6 +504,7 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
 
         const choice = chunk.choices[0]
         if (!choice) continue
+        if (choice.finish_reason) finishReason = choice.finish_reason
 
         const deltaContent = choice.delta.content
         if (deltaContent) {
@@ -529,6 +548,22 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
         }
       }
 
+      // Same truncation check as `structuredOutput()`: report the token limit
+      // before the empty-content and parse errors (issue #1426).
+      if (finishReason === 'length') {
+        const message = `${this.name}.structuredOutputStream: the response was cut off because the maximum token limit was reached (finish_reason=length); raise the output token limit (max_completion_tokens or max_tokens, depending on the provider)`
+        yield {
+          type: EventType.RUN_ERROR,
+          runId: aguiState.runId,
+          model: lastModel || chatOptions.model,
+          timestamp: Date.now(),
+          message,
+          code: 'max_tokens',
+          error: { message, code: 'max_tokens' },
+        }
+        return
+      }
+
       if (accumulatedContent.length === 0) {
         yield {
           type: EventType.RUN_ERROR,
@@ -1391,6 +1426,22 @@ export abstract class OpenAIBaseChatCompletionsTextAdapter<
         | { detail?: 'auto' | 'low' | 'high' }
         | undefined
 
+      if (isFileSource(part.source)) {
+        // The Chat Completions API references images only by URL/data URI,
+        // not by an uploaded file_id. Only mention the Responses alternative
+        // for OpenAI itself — compatible providers built on this base have no
+        // file_id-consuming endpoint at all.
+        throw unsupportedFileSourceError(
+          this.name,
+          // Only OpenAI's own chat-completions adapter (name 'openai-chat')
+          // has a Responses sibling to point at; other subclasses (Groq,
+          // Bedrock, BytePlus, compatible providers) have no file_id surface.
+          this.name === 'openai-chat'
+            ? 'on the Chat Completions API — use the Responses adapter (openaiText) to reference an uploaded file by file_id'
+            : 'on the Chat Completions API',
+        )
+      }
+
       // For base64 data, construct a data URI using the mimeType from source.
       // Default to a generic octet-stream MIME if the source didn't provide
       // one — interpolating `undefined` into the URI ("data:undefined;base64,